running multiple instances of GOST on 1 machine

[bertt]

Question: How can we run multiple instances of GOST on a single machine?
examples:

• a 'test' and a 'production' instance;
• a separate instance for each customer (customer1, customer2)

[bertt]

One possible solution using docker tooling (docker-compose), see branch https://github.com/gost/docker-compose/tree/multiple_endpoints

changes:

• docker-compose.yml file contains a new environment variable: DASHBOARD_PORT. (https://github.com/gost/docker-compose/blob/multiple_endpoints/docker-compose.yml#L22)
• mosquitto and Node-RED are removed from docker-compose.yml to simplify things for now (they expose their own ports). Could be re-added later on.
• added startup.sh script (https://github.com/gost/docker-compose/blob/multiple_endpoints/startup.sh):

# start production version on port 8080
export DASHBOARD_PORT=8080
docker-compose -p prod up -d

# start test version on port 8081
export DASHBOARD_PORT=8081
docker-compose -p test up -d

The startup.sh script sets the DASHBOARD_PORT variable (8080 for production, 8081 for test), and runs docker-compose up with the extra -p (Project) option.

After running this script there are 2 instances of GOST running on port 8080 and 8081. Using a proxy server these ports can be mapped to a subdomain (for example prod.my-gost.com and test.my-gost.com).

Result:

ccfb4af3ae3f        geodan/gost-dashboard   "/etc/nginx/docker-en"   6 seconds ago       Up 4 seconds        80/tcp, 0.0.0.0:8081->8080/tcp   test_dashboard_1
08654de5392d        geodan/gost             "/bin/sh -c ./gost"      6 seconds ago       Up 5 seconds        8080/tcp                         test_gost_1
9dd266a1c620        geodan/gost-db          "docker-entrypoint.sh"   7 seconds ago       Up 6 seconds        5432/tcp                         test_gost-db_1
ddbf159d1c4e        geodan/gost-dashboard   "/etc/nginx/docker-en"   21 seconds ago      Up 20 seconds       80/tcp, 0.0.0.0:8080->8080/tcp   prod_dashboard_1
9fd56490fb69        geodan/gost             "/bin/sh -c ./gost"      21 seconds ago      Up 20 seconds       8080/tcp                         prod_gost_1
e5fe45d57ca8        geodan/gost-db          "docker-entrypoint.sh"   22 seconds ago      Up 21 seconds       5432/tcp                         prod_gost-db_1

The instances of GOST are running in different networks: prod_default and test_default and they use different data volumes for storage: prod_postgis en test_postgis

An instance can be shut down using:

$ docker-compose -p test down
$ docker-compose -p prod down

[bertt]

another option is to make a copy of the docker-compose file in another folder
pro: more customizations possible
con: more difficult to maintain multiple copies