Вспомни миссию прошлого раздела. Чтобы запустить один контейнер prod, понадобились две переменные, команда docker run и три docker update. Добавь базу — ещё столько же, кеш — ещё. Всё это надо помнить, повторять в правильном порядке и передавать коллеге словами. Docker Compose превращает эту историю терминала в файл compose.yaml, который лежит в репозитории, читается глазами и поднимает все контейнеры приложения одной командой.
Compose входит в Docker как подкоманда docker compose и стоит на стенде с первой практики прошлого раздела. Это стандартный способ запускать связку контейнеров на одной машине: так поднимают окружение разработчика, учебные стенды, небольшие сервисы и домашние серверы. Граница у него одна, и знать её надо сразу: Compose работает на одной машине. Как только машин две, начинаются Kubernetes и Nomad, им посвящены отдельные разделы.
Что было и что стало
Сравним на одном контейнере. В прошлой миссии каждая настройка prod задавалась отдельным флагом: имя --name, порт -p 127.0.0.1:8012:8000, лимит --memory, политика --restart. В Compose те же настройки становятся строками файла.
services: app: image: localhost:5000/provision/app:1.0.0 ports: - "127.0.0.1:8012:8000" restart: unless-stopped
Читается сверху вниз: в разделе services есть сервис app, он запускается из такого-то образа, публикует порт на петле и перезапускается после сбоев. Файл написан на YAML — формате, где вложенность задаётся отступами пробелами. Отступы здесь часть синтаксиса: сдвинутая на пробел строка уже значит другое.
Запуск — одна команда из каталога с файлом. Повторять её на стенде пока не нужно: порт 8012 сейчас держит контейнер prod из миссии, и Compose ответит port is already allocated. Свой первый стек ты поднимешь в практике этого раздела, и там же prod уступит ему место.
docker compose up -d[+] Running 2/2 ✔ Network provision_default Created ✔ Container provision-app-1 Started
Флаг -d — в фоне, как у docker run. Обрати внимание на первую строку: сеть Compose создал сам. Сеть, контейнер, порядок запуска — всё это Compose вывел из нескольких строк файла.
Устройство файла
Файл растёт по мере того, как в связке появляются соседи. Добавим базу — второй сервис рядом с первым.
db: image: postgres:17-alpine environment: POSTGRES_PASSWORD: ${POSTGRES_PASSWORD} volumes: - pgdata:/var/lib/postgresql/data
Раздел environment — переменные окружения контейнера, то же, что флаг -e. Запись ${POSTGRES_PASSWORD} — подстановка: Compose возьмёт значение из файла .env рядом, и пароль не попадёт в репозиторий. Раздел volumes подключает том pgdata, как флаг -v.
Том нужно объявить внизу файла, на верхнем уровне.
volumes: pgdata:
Пустое значение значит «с настройками по умолчанию». А сеть объявлять не нужно вовсе: Compose заводит её на каждый проект и подключает к ней все сервисы. Поэтому приложение достанет базу по имени сервиса — db — без единой строки про сети.
Только имени вроде provision-app-1 в файле нет ни одного, а в выводе оно есть.
Имена
Имена контейнеров, сети и томов Compose собирает из имени проекта. А имя проекта по умолчанию берёт из названия каталога, где лежит файл.
Отсюда неприятный сюрприз. Переименовал каталог stand в provision-stand — и docker compose up создаёт новый том provision-stand_pgdata, а база начинается с пустого места. Старый том никуда не делся, просто его больше никто не видит. Лекарство — задать имя проекта явно первой строкой файла.
name: provisionТеперь имена всегда начинаются с provision, где бы ни лежал каталог: сеть provision_default, том provision_pgdata, контейнеры provision-app-1 и provision-db-1. Цифра в конце — номер копии сервиса, их бывает несколько.
Словарь урока
Что спросят на собеседовании
- Чем Compose отличается от Kubernetes?Compose работает на одной машине и не распределяет контейнеры по узлам, не переносит их при отказе и не обновляет без простоя. Его ниша — разработка, стенды и небольшие сервисы.
- Чем compose.yaml отличается от Dockerfile?Dockerfile описывает, как собрать один образ. compose.yaml — как запустить несколько контейнеров из готовых образов и связать их.
Что дальше
Как устроен файл, понятно. Дальше — несколько команд, которыми этим описанием управляют каждый день.