add docker-compose-pgadmin manifest (close #1424) (#1494)

Author: mnlbox

install-manifests/README.md

@@ -4,9 +4,12 @@ Various installation / deployment methods for Hasura GraphQL Engine
 
 1. [Docker Compose](docker-compose)
 2. [Docker Compose with HTTPS using Caddy](docker-compose-https)
-3. [Docker run](docker-run)
-3. [Kubernetes](kubernetes)
-
+3. [Docker Compose with PostGIS enabled Postgres](docker-compose-postgis)
+4. [Docker Compose with pgAdmin](docker-compose-pgadmin)
+5. [Docker run](docker-run)
+6. [Kubernetes](kubernetes)
+7. [Azure Container Instance without Postgres](azure-container)
+8. [Azure Container Instances with Postgres](azure-container-with-pg)
 
 ## License
 

install-manifests/docker-compose-pgadmin/README.md

@@ -0,0 +1,36 @@
+# Hasura GraphQL Engine on Docker with pgAdmin
+
+This Docker Compose setup runs [Hasura GraphQL Engine](https://github.com/hasura/graphql-engine) along with Postgres and [pgAdmin4](https://www.pgadmin.org/) using `docker-compose`.
+
+## Pre-requisites
+
+- [Docker](https://docs.docker.com/install/)
+- [Docker Compose](https://docs.docker.com/compose/install/)
+
+## Usage
+
+- Clone this repo on a machine where you'd like to deploy graphql engine
+- Edit `docker-compose.yaml` and change `PGADMIN_DEFAULT_EMAIL` and `PGADMIN_DEFAULT_PASSWORD` to something secure (default pgAdmin login email/password) default value for above variables are:
+    - **PGADMIN_DEFAULT_EMAIL:** `[email protected]`
+    - **PGADMIN_DEFAULT_PASSWORD:** `admin`
+- Read more `Environment Variables` here: https://hub.docker.com/r/dpage/pgadmin4/
+- Edit `docker-compose.yaml` and change `HASURA_GRAPHQL_ACCESS_KEY` to something secure
+- `docker-compose up -d`
+- Navigate to `http://localhost:5050`, login and add a new server with the following parameters:  
+  General - Name: Hasura  
+  Connection - Host: `hasura`  
+  Username: `postgres`  
+  Password: leave empty  
+
+## Important endpoints
+
+- GraphQL endpoint will be `http://localhost:8080/v1alpha1/graphql`
+- Hasura Console will be available on `http://localhost:8080/console`
+- pgAdmin will be available on `http://localhost:5050`
+
+
+## Connecting to External Postgres
+
+If you want to connect to an external/existing postgres database, replace `HASURA_GRAPHQL_DATABASE_URL` in `docker-compose.yaml` with your database url.
+
+**Note: localhost will resolve to the container ip inside a docker container, not the host ip**

install-manifests/docker-compose-pgadmin/docker-compose.yaml

@@ -0,0 +1,32 @@
+version: '3.6'
+services:
+  postgres:
+    image: postgres
+    restart: always
+    volumes:
+    - db_data:/var/lib/postgresql/data
+  pgadmin:
+    image: dpage/pgadmin4
+    restart: always
+    depends_on:
+    - postgres
+    ports:
+    - 5050:80
+    ## you can change pgAdmin default username/password with below environment variables
+    environment:
+      PGADMIN_DEFAULT_EMAIL: [email protected]
+      PGADMIN_DEFAULT_PASSWORD: admin
+  graphql-engine:
+    image: hasura/graphql-engine:v1.0.0-alpha37
+    ports:
+    - "8080:8080"
+    depends_on:
+    - "postgres"
+    restart: always
+    environment:
+      HASURA_GRAPHQL_DATABASE_URL: postgres://postgres:@postgres:5432/postgres
+      HASURA_GRAPHQL_ENABLE_CONSOLE: "true" # set to "false" to disable console
+      ## uncomment next line to set an access key
+      # HASURA_GRAPHQL_ACCESS_KEY: mysecretaccesskey
+volumes:
+  db_data: