Docker Compose: многоконтейнерные приложения

docker compose up -d    # запустить всё
docker compose down     # остановить всё
docker compose logs -f  # логи всех сервисов

services:
  web:          # имя сервиса (используется как hostname)
    image: nginx:alpine
    ports:
      - "80:80"
 
  api:
    build: ./backend    # собрать из Dockerfile
    environment:
      DATABASE_URL: postgres://user:pass@db:5432/myapp
    depends_on:
      - db
 
  db:
    image: postgres:16-alpine
    environment:
      POSTGRES_USER: user
      POSTGRES_PASSWORD: pass
      POSTGRES_DB: myapp
    volumes:
      - pgdata:/var/lib/postgresql/data
 
volumes:
  pgdata:

services:
  # Готовый образ из registry
  redis:
    image: redis:7-alpine
 
  # Собрать из Dockerfile в текущей папке
  api:
    build: .
 
  # Собрать из конкретной папки и файла
  api:
    build:
      context: ./backend
      dockerfile: Dockerfile.prod
      args:
        NODE_ENV: production

# Вариант 1: прямо в YAML (не для секретов!)
environment:
  PORT: 3000
  NODE_ENV: production
 
# Вариант 2: из .env файла
env_file:
  - .env
  - .env.local
 
# Вариант 3: подстановка из shell
environment:
  API_KEY: ${MY_API_KEY}   # из переменной окружения хоста

# .env файл
DATABASE_URL=postgres://user:pass@db:5432/myapp
SECRET_KEY=super-secret

services:
  api:
    depends_on:
      db:
        condition: service_healthy  # ждать health check
      redis:
        condition: service_started  # просто запущен
 
  db:
    image: postgres:16-alpine
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U postgres"]
      interval: 5s
      timeout: 5s
      retries: 5

services:
  db:
    volumes:
      - pgdata:/var/lib/postgresql/data    # named volume
      - ./init.sql:/docker-entrypoint-initdb.d/init.sql  # bind mount
 
  app:
    volumes:
      - .:/app         # весь проект (для разработки)
      - /app/node_modules  # анонимный volume (исключить node_modules хоста)
 
volumes:
  pgdata:    # объявить named volume

networks:
  frontend:
  backend:
    internal: true  # не доступна снаружи
 
services:
  nginx:
    networks: [frontend]
 
  api:
    networks: [frontend, backend]  # мост между зонами
 
  db:
    networks: [backend]   # только внутренняя сеть

# docker-compose.yml
services:
  web:
    build: ./frontend
    ports:
      - "3000:3000"
    volumes:
      - ./frontend:/app
      - /app/node_modules
    environment:
      VITE_API_URL: http://localhost:8000
    depends_on: [api]
 
  api:
    build: ./backend
    ports:
      - "8000:8000"
    volumes:
      - ./backend:/app
    environment:
      DATABASE_URL: postgres://user:pass@db:5432/dev
      REDIS_URL: redis://redis:6379
    depends_on:
      db:
        condition: service_healthy
      redis:
        condition: service_started
 
  db:
    image: postgres:16-alpine
    environment:
      POSTGRES_USER: user
      POSTGRES_PASSWORD: pass
      POSTGRES_DB: dev
    volumes:
      - pgdata:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U user"]
      interval: 5s
      retries: 5
 
  redis:
    image: redis:7-alpine
    volumes:
      - redis-data:/data
 
volumes:
  pgdata:
  redis-data:

# Жизненный цикл
docker compose up -d          # запустить в фоне
docker compose up --build     # пересобрать перед запуском
docker compose down           # остановить и удалить контейнеры
docker compose down -v        # + удалить volumes
docker compose restart api    # перезапустить конкретный сервис
 
# Мониторинг
docker compose ps             # состояние сервисов
docker compose logs -f api    # логи сервиса
docker compose top            # процессы внутри контейнеров
 
# Выполнение команд
docker compose exec api bash        # войти в контейнер
docker compose exec db psql -U user # запустить команду
docker compose run --rm api pytest  # одноразовый контейнер
 
# Обновление
docker compose pull           # обновить образы
docker compose up -d --force-recreate  # пересоздать контейнеры

# docker-compose.yml — базовый
services:
  api:
    image: myapp:latest
    environment:
      NODE_ENV: production

# docker-compose.override.yml — автоматически накладывается при разработке
services:
  api:
    build: .     # переопределяет image
    volumes:
      - .:/app
    environment:
      NODE_ENV: development
    ports:
      - "8000:8000"

# Явно указать файлы
docker compose -f docker-compose.yml -f docker-compose.prod.yml up -d

services:
  api:
    # нет profile — запускается всегда
 
  pgadmin:
    image: dpage/pgadmin4
    profiles: [tools]    # только при явном включении
 
  tests:
    build: .
    command: pytest
    profiles: [ci]

docker compose up                      # только api
docker compose --profile tools up      # + pgadmin
docker compose --profile ci run tests  # запустить тесты