Use Case
I want to run multiple/long commands for my service(s) in my docker-compose
file, like below:
--- # docker-compose.yaml services: server: &server build: context: . dockerfile: ./compose/staging/server/Dockerfile image: someproject_slug_staging_server:staging_shortsha_unixtime depends_on: - postgres env_file: - ./.envs/.staging/.server - ./.envs/.staging/.postgres command: python /app/manage.py collectstatic --no-input command: python /app/manage.py migrate command: gunicorn config.wsgi --bind 0.0.0.0:5000 --chdir=/app postgres: build: context: . dockerfile: ./compose/staging/postgres/Dockerfile image: someproject_slug_staging_postgres:staging_shortsha_unixtime volumes: - staging_postgres_data:/var/lib/postgresql/data:Z - staging_postgres_data_backups:/backups:z env_file: - ./.envs/.staging/.postgres
However it won't work since it's not possible.
Solutions
Script File
One solution is that putting all your commands in a script file -let's say start.sh
, put it into your image, build with it and call it directly.
As an example here is a docker compose
file:
--- # staging.yaml version: '3.7' volumes: staging_postgres_data: {} staging_postgres_data_backups: {} staging_traefik: {} staging_redis: {} services: server: &server build: context: . dockerfile: ./compose/staging/server/Dockerfile image: someproject_slug_server:staging_shortsha_unixtime depends_on: - postgres - redis env_file: - ./.envs/.staging/.server - ./.envs/.staging/.postgres - ./.envs/.staging/.redis command: /start postgres: build: context: . dockerfile: ./compose/staging/postgres/Dockerfile image: someproject_slug_postgres:staging_shortsha_unixtime volumes: - staging_postgres_data:/var/lib/postgresql/data:Z - staging_postgres_data_backups:/backups:z env_file: - ./.envs/.staging/.postgres traefik: build: context: . dockerfile: ./compose/staging/traefik/Dockerfile image: someproject_slug_traefik:staging_shortsha_unixtime depends_on: - server volumes: - staging_traefik:/etc/traefik/acme:z ports: - "0.0.0.0:80:80" - "0.0.0.0:443:443" - "0.0.0.0:5555:5555" redis: image: docker.io/bitnami/redis:6.2 env_file: - ./.envs/.staging/.redis ports: - "6379:6379" # WARNING: In production never bind 0.0.0.0 wildcard adress of the host volumes: - staging_redis:/bitnami/redis/data:z celeryworker: <<: *server command: /start-celeryworker celerybeat: <<: *server command: /start-celerybeat celeryflower: <<: *server command: /start-celeryflower aws-backup: build: context: . dockerfile: ./compose/staging/aws/Dockerfile env_file: - ./.envs/.staging/.server volumes: - staging_postgres_data_backups:/backups:z
WARNING
Don't bind your host's
0.0.0.0
wildcard adress in production environment. (Actually instead of deploying viadocker-compose
in production you should consider to use more reliable, and robust distributed systems likeKubernetes
but this is a topic for another post.)
6379:6379
means0.0.0.0:6379:6379
, so you open your redis instance to whole open world. And if you don't useAUTH
or don't take required security precaution -like TLS etc. you may get some headache. So use it only if you
know the related consequences.For more redis security topic look at this: Redis Security
And as an example here is content of start
from server
service:
#!/usr/env/bin bash # start set -o errexit set -o pipefail set -o nounset python /app/manage.py collectstatic --noinput python /app/manage.py migrate # WARNING: Not a good idea for prod gunicorn config.wsgi --bind 0.0.0.0:5000 --chdir=/app
WARNING
Migration is not a command you want to run every container start but since it's staging environment let's assume it's OK.
Multiline Scalar
Running in a script file is OK however maybe it's local or staging environment which means you need to debug and tweak these commands one by one; maybe some flags are not working etc. and you don't want to re-build the image every time.
How are we gonna do this?
The answer lines in the multiline capability of yaml
syntax:
command: > bash -c "python /app/manage.py collectstatic --noinput && python /app/manage.py migrate && gunicorn config.wsgi --bind 0.0.0.0:5000 --chdir=/app"
This is called Folded Style. The indention in each line will be ignored. A line break (\n
) will be inserted at the end.
Or you can use Literal Style:
command: - /bin/bash - -c - | python /app/manage.py collectstatic --noinput python /app/manage.py migrate gunicorn config.wsgi --bind 0.0.0.0:5000 --chdir=/app
This turns every newline within the string into a literal newline, and adds one at the end.
More on these styles:
Folded Style
Key: > this is my very very very long command
Output:
this is my very very very long command\n
Mind new line-\n
(end of line-EOL
)
Literal Style
Key: | this is my very very very long command
Output:
this is my very very very\nlong command\n
Mind new lines-\n
, and compare to it above output.
Fore more detailed style and yaml
syntax you can look at this amazing explanation in this link.
These were the solutions for running multiple or long commands in your docker-compose file.
All done!
Top comments (0)