Provision
—— XP

Зачем нужен Docker Compose

теория~5 минут+170 XP

Вспомни миссию прошлого раздела. Чтобы запустить один контейнер 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 те же настройки становятся строками файла.

compose.yaml, один сервис
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 уступит ему место.

ubuntu@stand:~$
docker compose up -d
ubuntu@stand:~$
[+] Running 2/2
 ✔ Network provision_default  Created
 ✔ Container provision-app-1  Started

Флаг -d — в фоне, как у docker run. Обрати внимание на первую строку: сеть Compose создал сам. Сеть, контейнер, порядок запуска — всё это Compose вывел из нескольких строк файла.

Устройство файла

Файл растёт по мере того, как в связке появляются соседи. Добавим базу — второй сервис рядом с первым.

compose.yaml, сервис базы
  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.

Том нужно объявить внизу файла, на верхнем уровне.

compose.yaml, конец файла
volumes:
  pgdata:

Пустое значение значит «с настройками по умолчанию». А сеть объявлять не нужно вовсе: Compose заводит её на каждый проект и подключает к ней все сервисы. Поэтому приложение достанет базу по имени сервиса — db — без единой строки про сети.

Только имени вроде provision-app-1 в файле нет ни одного, а в выводе оно есть.

Имена

Имена контейнеров, сети и томов Compose собирает из имени проекта. А имя проекта по умолчанию берёт из названия каталога, где лежит файл.

Каталог с файлом compose.yaml даёт имя проекту, а от него образуются имена контейнеров, сети и тома. Ниже способы переопределить: флаг -p и переменная COMPOSE_PROJECT_NAME.
Переименовали каталог — получили новый проект с пустыми томами, а старые данные остались под прежним именем.

Отсюда неприятный сюрприз. Переименовал каталог stand в provision-stand — и docker compose up создаёт новый том provision-stand_pgdata, а база начинается с пустого места. Старый том никуда не делся, просто его больше никто не видит. Лекарство — задать имя проекта явно первой строкой файла.

compose.yaml, первая строка
name: provision

Теперь имена всегда начинаются с provision, где бы ни лежал каталог: сеть provision_default, том provision_pgdata, контейнеры provision-app-1 и provision-db-1. Цифра в конце — номер копии сервиса, их бывает несколько.

Словарь урока

Сервис
Описание контейнера в compose.yaml. Имя сервиса становится его адресом в сети проекта. ↩ к тексту
Имя проекта
Префикс для контейнеров, сети и томов. По умолчанию — имя каталога, поэтому его задают ключом name. ↩ к тексту
Подстановка
Запись вида ${ИМЯ} в файле: Compose подставит значение из .env или из окружения. ↩ к тексту

Что спросят на собеседовании

  • Чем Compose отличается от Kubernetes?
    Compose работает на одной машине и не распределяет контейнеры по узлам, не переносит их при отказе и не обновляет без простоя. Его ниша — разработка, стенды и небольшие сервисы.
  • Чем compose.yaml отличается от Dockerfile?
    Dockerfile описывает, как собрать один образ. compose.yaml — как запустить несколько контейнеров из готовых образов и связать их.

Что дальше

Как устроен файл, понятно. Дальше — несколько команд, которыми этим описанием управляют каждый день.

Проверь себя+170 XPдве попытки
1
Что было и что стало
Что описывает файл compose.yaml?
2
Устройство файла
Как приложение обращается к базе, описанной сервисом db?
3
Имена
Откуда Compose берёт имя проекта, если его не задать?
4
Граница Compose
Чего Compose не умеет?
ответь на все вопросы, чтобы проверить

Нашёл ошибку или непонятное место? Наведи на абзац — слева появится «+», нажми и напиши, что не так. Замечание увидит автор курса.Нашёл ошибку или непонятное место? Нажми «+» справа от заголовка раздела и напиши, что не так. Замечание увидит автор курса.