Docker Compose
Orchestrate multiple containers with docker-compose.yml.
Docker Compose is a tool for defining and running multi-container Docker applications. With Compose, you use a YAML file to configure your application’s services.
Base vs. Dev Compose Files
It's common practice to have a base `docker-compose.yml` for shared/production configuration and a `docker-compose.dev.yml` to override or add services for development (like a database or hot-reloading).
docker-compose.yml (Base)
services:
web:
build:
context: .
dockerfile: Dockerfile
restart: unless-stopped
ports:
- "${DJANGO_PORT}:8000"
env_file:
- .env
volumes:
- .:/app # Mount code for hot-reloading
- /app/__pycache__ # Anonymous volume to prevent overwriting
docker-compose.dev.yml (Development Override)
services:
db:
image: mysql:8.0
restart: unless-stopped
environment:
MYSQL_ROOT_PASSWORD: ${MYSQL_ROOT_PASSWORD}
MYSQL_DATABASE: ${MYSQL_DATABASE}
MYSQL_USER: ${MYSQL_USER}
MYSQL_PASSWORD: ${MYSQL_PASSWORD}
ports:
- "${MYSQL_EXPOSE_PORT}:3306"
volumes:
- mysql_data:/var/lib/mysql
healthcheck:
test: ["CMD", "mysqladmin", "ping", "-h", "localhost", "-u", "root", "-p${MYSQL_ROOT_PASSWORD}"]
interval: 10s
timeout: 5s
retries: 10
start_period: 30s
web:
depends_on:
db:
condition: service_healthy
volumes:
mysql_data:
Running Docker Compose
# Run services using both files
docker-compose -f docker-compose.yml -f docker-compose.dev.yml up
# Build images and run
docker-compose -f docker-compose.yml -f docker-compose.dev.yml up --build
# Run in detached mode
docker-compose -f docker-compose.yml -f docker-compose.dev.yml up -d