Instructions
This is a demonstration of a Multi Docker Compose.
The purpose of this repositoy is ongoing research on "Docker compose" architecture design for easier and elegant control over the services, without duplication.
Create a new project environment aka sample platform
To create a new environment
mkdir platform-new
touch platform-new/.env
ln -s docker-compose.base.yml platform-new/docker-compose.yml
touch platform-new/docker-compose.override.yml
Tree view visualizing of the filesystem
platform-new/
├── data
│ └── backend1
│ └── config
│ └── main.yml
├── docker-compose.override.yml
└── docker-compose.yml -> ../docker-compose.base.yml
In short:
-
We link the original docker-compose.base.yml.
-
We create new .env file.
- Each .env can configure the inside/outside ports and other user configurable options.
Each override has the example structure:
version: '3'
services:
backend1:
# add content here
volumes:
- ./data/backend3/config:/config
Note:
-
Each platform environment will not to be committed to GIT.
-
The platform environments will be created on the dev machine or production.
-
There can be an infinite number of environments on one machine/node as long as the ports are different in each .env file.
-
Having a data directory which can be mounted/binded to particular location inside the target service.
Environment keys:
-
PORT_BACKEND1 is the outside port
-
PORT_BACKEND1_IN is the inside port
-
BACKEND1_PORT is the listen port for the service
Commands
Rebuild
cd platform-dev # sample env
docker-compose build
docker-compose up -d
Test: http://localhost:8003
Status
cd platform-dev # sample env
docker-compose ps
Features (desired)
-
Multi environment docker compose
-
Building an image instructions
-
Controlling inside env vars
-
Controlling outside env vars in docker -compose
-
Structuring environment variables for easier control and maintaince
-
Multi stage Dockerfile builds
Reference
-
https://pspdfkit.com/blog/2018/how-to-manage-multiple-system-configurations-using-docker-compose/
-
https://github.com/docker/awesome-compose/ (for the Go sample insipiration)
TODOS
Please check the Issues section for a complete list of pending features here.
