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