Современная веб-разработка редко обходится одним сервисом. Даже простой проект может включать веб-приложение, базу данных, очереди сообщений или обратный прокси. Настройка всей этой инфраструктуры локально — та еще головная боль. Версии не совпадают, порты конфликтуют, переменные окружения разъезжаются, а в соседнем проекте вообще стоит другой стек. Docker Compose призван решить эту проблему раз и навсегда — поговорим о нем подробнее.

Что такое Docker Compose
Docker Compose — это инструмент, который позволяет описывать и запускать несколько связанных контейнеров одновременно с помощью одного YAML-файла. Вместо того чтобы вручную запускать docker run для каждого сервиса, вы просто перечисляете все нужные компоненты в файле docker-compose.yml, а Compose берет на себя всю рутину по их сборке, запуску и связыванию.
Чем Docker Compose отличается от Docker

Сам Docker умеет запускать отдельные контейнеры — это его базовая функция. Но если вам нужно поднять сразу несколько контейнеров, которые должны общаться друг с другом и иметь общую сеть, ручной запуск каждого через docker run становится утомительным и чреватым ошибками. Docker Compose работает на уровень выше: он берет декларативное описание всего окружения — приложение, база данных, кэш, сети, тома для хранения данных и переменные окружения — и превращает его в работающую систему. Вы не думаете о порядке запуска и сетевых настройках, Compose делает это за вас.
Зачем Docker Compose нужен в разработке
В локальной разработке Docker Compose дает несколько очевидных преимуществ. Прежде всего, это единое окружение для всей команды — вы просто загружаете файл docker-compose.yml в репозиторий, и каждый разработчик получает идентичную среду, независимо от своей операционной системы или установленного софта.
Работа с базой данных становится удобной: вы можете поднять свежий экземпляр, прогнать миграции, наполнить тестовыми данными и так же легко все убрать, когда экземпляр больше не потребуется. Compose превращает инфраструктуру в код, который всегда под рукой.
Как устроен файл docker-compose.yml
Файл docker-compose.yml — это сердце всего процесса. Он написан на YAML, и его структура интуитивно понятна даже тем, кто видит его впервые. Основные разделы файла задают сервисы, сети и тома, но главное действующее лицо здесь — это секция services.
Services: описание контейнеров проекта
Секция services перечисляет все контейнеры, из которых состоит ваше окружение. Каждый сервис — это, по сути, отдельный контейнер. Для типичного веб-проекта вы увидите здесь бэкенд на Python, Node.js или Go, фронтенд, базу данных PostgreSQL или MySQL, а также, возможно, Redis для кэширования и Nginx для проксирования запросов.
Например, сервис базы данных может называться просто db, а сервис приложения — app или web. Внутри каждого сервиса вы описываете, из какого образа его собрать, какие порты открывать и как он взаимодействует с другими сервисами.
Image и build: готовый образ или сборка из Dockerfile
Для каждого сервиса нужно указать, откуда взять контейнер. Здесь возможны два варианта. Если вы используете стандартное решение, например, PostgreSQL, вы можете взять готовый образ из Docker Hub, указав image: postgres:15. Это быстро и удобно.
Второй вариант — когда у вас собственное приложение с уникальным кодом. Тогда вы пишете build: . или указываете путь к папке с Dockerfile, и Compose собирает образ самостоятельно, выполняя все инструкции из вашего Dockerfile.
Ports, volumes и environment: порты, файлы и переменные окружения
Эти три настройки встречаются практически в каждом Compose-файле, потому что без них локальное окружение работать не будет.
Параметр ports пробрасывает порты из контейнера на хост: вы указываете "8080:80", и теперь приложение внутри контейнера, слушающее порт 80, доступно на вашем компьютере по адресу localhost:8080.
Тома, или volumes, нужны, чтобы связывать файлы вашего проекта с файловой системой контейнера. Это позволяет изменять код на хост-машине и видеть изменения в работающем приложении без пересборки контейнера — критически важная вещь в разработке.
Переменные окружения, раздел environment, задают настройки приложения вроде паролей к базе данных, режима отладки или ключей доступа.
Depends_on и networks: связи между сервисами
Контейнеры редко живут изолированно, и Compose помогает организовать их взаимодействие. Секция depends_on указывает, какие сервисы должны запуститься раньше других. Например, ваше приложение должно дождаться, пока поднимется база данных.
Однако стоит помнить, что depends_on проверяет только запуск контейнера, а не готовность сервиса внутри него — для серьезных проверок готовности используют healthcheck.
Раздел networks определяет виртуальную сеть, в которой контейнеры могут видеть друг друга по именам сервисов. Это значит, что ваше приложение может обращаться к базе данных просто по имени хоста db, а не выяснять внутренние IP-адреса. По умолчанию Compose создает сеть автоматически, но вы можете настроить ее под свои нужды.
Пример файла Docker Compose для разработки
Представьте, что вы пишете веб-приложение на Python и хотите подключить к нему базу данных PostgreSQL. Вот минимальный простой пример для API:
version: '3.9'
services:
api:
build: .
ports:
- "5000:5000"
depends_on:
- db
db:
image: postgres:15
environment:
POSTGRES_USER: dev
POSTGRES_PASSWORD: devpass
POSTGRES_DB: devdb
volumes:
- pgdata:/var/lib/postgresql/data
volumes:
pgdata:
Как создать контейнеры через Docker Compose
Когда вы выполнили команду docker compose up, Compose начинает свою работу. Он читает ваш файл, проверяет синтаксис и структуру. Для каждого сервиса он решает, нужно ли собрать образ из Dockerfile или просто скачать готовый из реестра.
Затем Compose создает изолированную сеть, если ее нет, и подготавливает тома для хранения данных. После этого он запускает контейнеры в правильном порядке, учитывая зависимости, и связывает их сетью. Все происходит автоматически, и вы получаете работающее окружение, полностью соответствующее тому, что описано в файле.
Как запустить docker-compose.yml
Запуск окружения одной командой
Все начинается с команды docker compose up. Выполнив ее в директории с файлом docker-compose.yml, вы запускаете весь процесс: сборку, создание и старт контейнеров. Логи всех сервисов выводятся в терминал, что удобно для наблюдения за процессом запуска. Если вы добавили флаг --build, Compose пересобирает образы перед запуском, даже если они уже существуют.
Запуск в фоновом режиме
Когда проект уже отлажен и вы не хотите держать терминал открытым или засорять его логами, используйте docker compose up -d. Буква d означает «detach» — отсоединенный режим. Контейнеры запустятся в фоне, и вы сможете продолжать работу. Это особенно удобно, когда окружение используется как вспомогательный инструмент, например, для запуска тестовой базы данных.
Проверка запущенных контейнеров
После запуска полезно убедиться, что все работает. Команда docker compose ps показывает все сервисы, их состояние, открытые порты и другую полезную информацию. Вы увидите, какие контейнеры поднялись успешно, а какие завершились с ошибкой.
Просмотр логов
Когда что-то идет не так, логи становятся вашим лучшим другом. docker compose logs выводит логи всех сервисов, а если добавить имя конкретного сервиса, например docker compose logs app, вы увидите только нужную информацию. Это помогает быстро найти ошибку в приложении, понять, почему не стартует база данных или почему не применяются миграции.
Основные команды Docker Compose в разработке
Каждый день работы с Compose — это набор повторяющихся действий, и для каждого из них есть своя команда.
Остановка контейнеров
Пересборка после изменений
Когда вы меняете Dockerfile или добавляете новые зависимости в проект, старый образ становится неактуальным. Тогда на помощь приходит docker compose up --build или команда docker compose build, которая пересобирает образы, не запуская контейнеры. После пересборки вы можете поднять окружение уже с обновленными образами.
Важно помнить, что если вы меняете только код приложения, а не Dockerfile, пересборка не нужна благодаря смонтированным томам.
Выполнение команд внутри контейнера
Команда docker compose exec позволяет запускать произвольные команды внутри уже работающего контейнера. Это незаменимая вещь для рутинных задач разработки.
Запустить миграции базы данных можно через docker compose exec app python manage.py migrate. Установить новую зависимость — docker compose exec app pip install requests. Запустить тесты, зайти в интерактивную консоль или проверить содержимое файловой системы — все это делается через exec.
Важно использовать именно exec, а не run, потому что run создает новый контейнер, тогда как exec работает с существующим, сохраняя все состояние.
Типичные ошибки при работе с Docker Compose
Даже у опытных разработчиков случаются проблемы, и большинство из них однотипны.
Ошибки в отступах YAML — самая частая причина, почему Compose отказывается читать файл. YAML чувствителен к пробелам, поэтому всегда проверяйте, что строки внутри сервисов выровнены одинаково.
Занятые порты — классика: порт 5432 уже занят локально установленным PostgreSQL, или порт 8000 использует другой проект. Просто смените внешний порт в настройках.
Неверные переменные окружения часто приводят к тому, что приложение не может подключиться к базе — проверьте имена переменных и строки подключения.
Проблемы с томами возникают, когда пути указаны неверно или файлы не монтируются туда, куда вы ожидаете.
Иногда сервис не успевает запуститься, и приложение пытается обратиться к базе данных, которой еще нет. В этом случае вам нужны скрипты ожидания или механизм healthcheck.
И наконец, контейнер не видит базу данных — почти всегда это проблема сети или имени хоста: убедитесь, что оба сервиса находятся в одной сети и приложение использует имя сервиса (например, db), а не localhost.
Когда Docker Compose удобен, а когда его недостаточно
Docker Compose отлично подходит для локальной разработки, быстрого прототипирования и создания стабильных тестовых окружений. Он прост, легок и позволяет всей команде работать в идентичных условиях. Однако для продакшена и крупных распределенных систем его возможностей часто не хватает.
Compose не умеет автоматически масштабировать сервисы на несколько узлов, не следит за состоянием контейнеров и не перезапускает их при сбоях (хотя базовый restart есть).
В сложных продакшен-сценариях используют оркестраторы вроде Kubernetes или Docker Swarm, которые обеспечивают балансировку нагрузки, автоматическое восстановление, обновления без остановки и управление конфигурацией на десятках и сотнях машин.
Но для разработки Compose остается золотым стандартом — он снижает порог входа в проект и делает инфраструктуру прозрачной.
Если вы хотите подробнее углубиться в тему разработки и развиваться в этом направлении, у онлайн-школы ProductStar есть разнообразные курсы в этой сфере. Сроки обучения гибкие — от двух до девяти месяцев, а по окончании курса у вас будет полноценное портфолио, которое станет вашим преимуществом при трудоустройстве. Подробности — здесь.













