Documentation improvement and CI additions.

Author: rustprooflabs

.dockerignore

@@ -0,0 +1,2 @@
+.git
+Dockerfile*

.gitlab-ci.yml

@@ -0,0 +1,49 @@
+---
+
+stages:
+  - build
+  - run
+  - test
+  - publish
+
+before_script:
+  - docker info
+
+pre_clean:
+  stage: build
+  script:
+    - docker stop gl-pgdd && docker rm gl-pgdd
+  allow_failure: true
+
+build_image:
+  stage: build
+  script:
+    - docker build -t rustprooflabs/pgdd .
+
+start_container:
+  stage: run
+  script:
+    - docker run --name gl-pgdd -e POSTGRES_PASSWORD=$POSTGRES_PASSWORD -p $PG_PORT:5432 -d rustprooflabs/pgdd
+    - sleep 8
+
+
+query_extension:
+  stage: test
+  script:
+    - PGPASSWORD=$POSTGRES_PASSWORD  psql -h $PG_HOST -p $PG_PORT -U postgres -c "CREATE EXTENSION pgdd;"
+    - PGPASSWORD=$POSTGRES_PASSWORD  psql -h $PG_HOST -p $PG_PORT -U postgres -c "SELECT t_name FROM dd.tables;"
+    - docker stop gl-pgdd
+    - docker rm gl-pgdd
+
+
+create_non_extension_scripts:
+  stage: publish
+  script:
+    - cat pgdd--0.1.sql > pgdd_v0_2.sql
+    - cat pgdd--0.1--0.2.sql >> pgdd_v0_2.sql
+  artifacts:
+    paths:
+      - pgdd_v0_2.sql
+
+
+...

Dockerfile

@@ -0,0 +1,20 @@
+FROM postgres:12
+
+ENV PG_MAJOR 12
+
+LABEL maintainer="PgDD Project - https://github.com/rustprooflabs/pgdd"
+
+RUN apt-get update \
+    && apt-cache showpkg postgresql-$PG_MAJOR \
+    && apt-get install -y --no-install-recommends \
+        make \
+        postgresql-server-dev-$PG_MAJOR \
+    && rm -rf /var/lib/apt/lists/*
+
+WORKDIR /tmp/pgdd
+COPY *.sql ./
+COPY pgdd.control ./
+COPY Makefile ./
+
+RUN make install
+

README.md

@@ -4,6 +4,14 @@ The PostgreSQL Data Dictionary (`pgdd`) is an in-database solution to provide
 introspection via standard SQL query syntax.  This extension makes  it easy to
 provide a usable data dictionary to all users of a PostgreSQL database.
 
+## Compatability
+
+PgDD has been tested and found to work against PostgreSQL 10
+through 13-beta2.
+
+Docker images available on
+[Docker Hub](https://hub.docker.com/r/rustprooflabs/pgdd).
+
 
 ## Install `pgdd`
 
@@ -42,6 +50,73 @@ psql -d your_db
 CREATE EXTENSION pgdd;
 ```
 
+## Docker Image
+
+Build Docker image.  Uses [main Postgres image](https://hub.docker.com/_/postgres/) as starting point, see that
+repo for full instructions on using the core Postgres functionality.
+
+```
+docker build -t rustprooflabs/pgdd .
+```
+
+Build with tag.
+
+Run Postgres in Docker.
+
+```
+docker run --name test-pgdd12 -e POSTGRES_PASSWORD=mysecretpassword -p 6512:5432 -d rustprooflabs/pgdd
+```
+
+Connect via `psql` using `postgres` role, provide password from prior step
+when prompted.
+
+```
+psql -h host_or_ip -p 6512 -U postgres 
+```
+
+
+
+## Database Permissions
+
+Create Read-only group role to assign to users
+that need access to query (read-only) the PgDD objects.
+
+```
+CREATE ROLE dd_read WITH NOLOGIN;
+COMMENT ON ROLE dd_read IS 'Group role to grant read-only permissions to PgDD views.';
+
+GRANT USAGE ON SCHEMA dd TO dd_read;
+GRANT SELECT ON ALL TABLES IN SCHEMA dd TO dd_read;
+ALTER DEFAULT PRIVILEGES IN SCHEMA dd GRANT SELECT ON TABLES TO dd_read;
+```
+
+Access can now be granted to other users using:
+
+```
+GRANT dd_read TO <your_login_user>;
+```
+
+For read-write access.
+
+
+```
+CREATE ROLE dd_readwrite WITH NOLOGIN;
+COMMENT ON ROLE dd_readwrite IS 'Group role to grant write permissions to PgDD objects.';
+
+GRANT dd_read TO dd_readwrite;
+
+GRANT INSERT, UPDATE, DELETE ON ALL TABLES IN SCHEMA dd TO dd_readwrite;
+ALTER DEFAULT PRIVILEGES IN SCHEMA dd GRANT INSERT, UPDATE, DELETE ON TABLES TO dd_readwrite;
+```
+
+This access can be granted using:
+ 
+```
+GRANT dd_readwrite TO <your_login_user>;
+```
+
+
+
 ## Use Data Dictionary
 
 Connect to your database using your favorite SQL client.  This

standalone/README.md

@@ -0,0 +1,2 @@
+The `.sql` files in this directory enable non-extension
+installations.  This is useful for PGaaS (Postgres as a Service) installations such as AWS RDS.