Что такое Docker Compose
На этой странице
Docker Compose — инструмент для описания и запуска приложения из нескольких контейнеров одним YAML-файлом compose.yaml. В нём декларативно задают сервисы (образ или сборка, порты, переменные, volumes, зависимости), а также сети и volumes. docker compose up создаёт всё нужное и приводит окружение к описанному состоянию, down — удаляет контейнеры и сети. Сервисы автоматически попадают в общую сеть и видят друг друга по имени.
Вопрос
Что такое Docker Compose и какую проблему он решает?
Проблема
Даже небольшое приложение — это несколько процессов: frontend, API, PostgreSQL, Redis, worker. Без Compose пришлось бы помнить и запускать вручную:
docker network create app-net
docker volume create pgdata
docker run -d --name db --network app-net -v pgdata:/var/lib/postgresql -e POSTGRES_PASSWORD=secret postgres:18
docker run -d --name redis --network app-net redis:8-alpine
docker build -t api ./api
docker run -d --name api --network app-net -p 3000:3000 -e DATABASE_URL=... apiCompose превращает это в файл, который лежит в репозитории.
Минимальный пример
# compose.yaml
services:
api:
build: ./api
ports:
- "3000:3000"
environment:
DATABASE_URL: postgres://app:secret@db:5432/app
depends_on:
db:
condition: service_healthy
db:
image: postgres:18
environment:
POSTGRES_USER: app
POSTGRES_PASSWORD: secret
POSTGRES_DB: app
volumes:
- pgdata:/var/lib/postgresql
healthcheck:
test: ["CMD-SHELL", "pg_isready -U app -d app"]
interval: 5s
retries: 10
volumes:
pgdata:docker compose up -dЧто Compose делает сам
- Создаёт сеть
<проект>_defaultи подключает к ней все сервисы — имя сервиса становится DNS-именем. - Создаёт объявленные named volumes.
- Собирает образы для сервисов с
build. - Запускает контейнеры с учётом
depends_on. - Объединяет логи всех сервисов.
Имя проекта по умолчанию — имя каталога; его меняют через -p или поле name: в файле. Все ресурсы получают префикс проекта: myapp-api-1, myapp_pgdata.
Основные команды
docker compose up -d # создать и запустить в фоне
docker compose up -d --build # пересобрать образы перед запуском
docker compose ps # статус сервисов
docker compose logs -f api # логи сервиса
docker compose exec api sh # команда в работающем контейнере
docker compose run --rm api npm test # одноразовый контейнер
docker compose restart api
docker compose stop # остановить, не удаляя
docker compose down # удалить контейнеры и сети
docker compose down -v # + volumes проекта — данные пропадут
docker compose config # итоговая конфигурация после подстановокup идемпотентен: при повторном запуске Compose пересоздаёт только сервисы, конфигурация или образ которых изменились.
Compose V2
Современная команда — docker compose (плагин CLI). Старый docker-compose с дефисом (V1, Python) больше не поддерживается. Поле version: в начале файла устарело и игнорируется, предпочтительное имя файла — compose.yaml.
Где Compose уместен
- Локальная разработка и onboarding:
git clone→docker compose up. - Интеграционные и e2e-тесты в CI.
- Небольшой production на одном сервере.
Для нескольких серверов, автомасштабирования и rolling-обновлений нужен оркестратор — см. Compose и Kubernetes.
Частые ошибки
- Писать
docker-composeиversion: "3.8"по старым статьям. - Подключаться между сервисами через
localhost. - Делать
down -v, не понимая, что удаляются данные. - Забывать
--buildпосле изменения Dockerfile — запускается старый образ.
Что важно помнить
- Compose — декларативное описание окружения: файл в git вместо инструкций в README.
stopостанавливает,downудаляет контейнеры и сети,down -v— ещё и volumes.docker compose configпоказывает, что Compose реально применит, — первый шаг отладки YAML.
Мини-шпаргалка
- Файл —
compose.yaml, команда —docker compose. services,volumes,networks— главные разделы.up -d --build,logs -f,exec,run --rm,down.- Имя сервиса = DNS-имя.
Документация
Docker: Compose overview, Docker: Compose file reference, Docker: docker compose CLI.