Генератор Docker Compose

Современная спецификация Compose

Compose V2 (плагин, поставляемый с Docker Desktop и современными Docker Engine) следует Compose Specification. Ключ version: устарел; генератор его опускает. Ключи верхнего уровня: services, networks, volumes, configs и secrets.

Анатомия службы

Служба, близкая к продакшену, выглядит так:

services:
  web:
    image: nginx:1.27-alpine
    restart: unless-stopped
    ports:
      - "80:80"
    volumes:
      - ./public:/usr/share/nginx/html:ro
    depends_on:
      app:
        condition: service_healthy
    networks:
      - frontend
      - backend
    healthcheck:
      test: ["CMD", "wget", "--spider", "-q", "http://localhost/health"]
      interval: 30s
      timeout: 5s
      retries: 3

Тома: bind mount или именованный том

• Bind mount (./app:/var/www) привязывает контейнер к пути на хосте; отлично подходит для локальной разработки, потому что изменения видны сразу.
• Именованный том (pgdata:/var/lib/postgresql/data) управляется Docker и хранится независимо от путей на хосте; правильный выбор для баз данных и всего, что вы не хотите случайно удалить с помощью rm -rf.
• Анонимный том - избегайте. Он переживает перезапуски, но исчезает без предупреждения при docker compose down -v.

Сети

По умолчанию Compose создаёт сеть с именем проекта и подключает к ней каждую службу. Явные сети полезно объявлять, когда:

• нужно изолировать базу данных от службы, открытой наружу;
• нужен мост со своей подсетью, чтобы согласовать его с существующей инфраструктурой;
• нужно подключить контейнеры к уже существующей внешней сети (external: true).

Частые ошибки, которых стоит избегать

• Конфликты ключа версии. version: "3.8" в начале мешает новым функциям, таким как start_interval в healthcheck, работать в старом Compose; генератор опускает ключ версии.
• Кавычки вокруг портов. 8080:80 в некоторых крайних случаях интерпретируется как YAML-число в шестидесятеричной системе (base-60); генератор всегда берёт сопоставления портов в кавычки.
• Секреты прямо в коде. Секреты, записанные прямо в compose.yml, попадают в git. Храните их в env_file или в хранилище секретов платформы.
• depends_on без условия. Простой depends_on: [db] ждёт запуска контейнера, а не готовности службы. Используйте condition: service_healthy и добавьте healthcheck зависимой службе.