Provision
—— XP

Команды Compose на каждый день

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

Команды Compose устроены так же, как команды Docker из прошлого раздела, только работают со всем проектом сразу: docker compose ps вместо docker ps, docker compose logs вместо docker logs. Их запускают из каталога, где лежит compose.yaml, и они сами находят свой файл. В первый месяц работы хватает шести, и все шесть ты будешь набирать по десять раз в день.

Это как пульт от телевизора вместо отвёртки внутри корпуса. Кнопок немного — включить, выключить, громкость, — и каждая делает понятное действие с целой системой, а не с отдельной деталью.

Шесть команд закрывают весь цикл стека: поднять, посмотреть, прочитать журнал, зайти внутрь, остановить и проверить описание до запуска.

Примеры урока сняты на стеке из двух сервисов — приложения и базы, — который ты соберёшь в следующей практике. Набирать их сейчас не обязательно: без compose.yaml в текущем каталоге Compose ответит no configuration file provided.

Поднять и посмотреть

Главная команда — up. Она сравнивает файл с тем, что запущено: создаёт недостающее, пересоздаёт изменившееся, а совпадающее не трогает. Поэтому после любой правки файла выполняют снова up.

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

Флаг -d — в фоне. Что поднялось и в каком состоянии, показывает ps.

ubuntu@stand:~$
docker compose ps
ubuntu@stand:~$
NAME              IMAGE                SERVICE   STATUS          PORTS
provision-app-1   provision-app        app       Up 10 seconds   127.0.0.1:8012->8000/tcp
provision-db-1    postgres:17-alpine   db        Up 11 seconds   5432/tcp

Колонки те же, что у docker ps, плюс SERVICE — имя сервиса из файла. По нему обращаются все остальные команды. У базы в PORTS нет стрелки: порт наружу не опубликован, она доступна только соседям по сети. Флаг -a покажет и завершившиеся контейнеры — пригодится, когда в стеке появятся разовые задачи.

Журналы и вход внутрь

Журналы Compose собирает со всех сервисов сразу, и в этом его заметное удобство.

ubuntu@stand:~$
docker compose logs --tail 3
ubuntu@stand:~$
provision-db-1   | LOG:  database system is ready to accept connections
provision-app-1  | [INFO] Listening at: http://0.0.0.0:8000 (1)
provision-app-1  | [INFO] Booting worker with pid: 8

Слева от черты — имя контейнера, и строки разных сервисов идут вперемешку в общем времени. Так видно, что за чем случилось: например, что приложение постучалось в базу раньше, чем та была готова. Флаг --tail 3 — последние три строки каждого сервиса, флаг -f с именем сервиса — следить за одним: docker compose logs -f app.

Зайти внутрь работающего сервиса — exec, как у Docker, только по имени сервиса, а не контейнера.

ubuntu@stand:~$
docker compose exec db psql -U provision -c 'select 1'
ubuntu@stand:~$
 ?column?
----------
        1

Здесь внутри контейнера базы запущен клиент psql: флаг -U задаёт пользователя базы, -c — запрос. Ответ «1» значит, что база жива и принимает запросы.

Остановить

Останавливают стек командой down. Она удаляет контейнеры и сеть проекта, а тома оставляет: данные базы переживут.

ubuntu@stand:~$
docker compose down
ubuntu@stand:~$
[+] Running 3/3
 ✔ Container provision-app-1  Removed
 ✔ Container provision-db-1   Removed
 ✔ Network provision_default  Removed

В инструкциях для разработки часто пишут docker compose down -v. Флаг -v удаляет ещё и тома — на ноутбуке это «начать с чистого листа», а на сервере это удаление базы. Правило: на машине, где данные чего-то стоят, -v не набирают никогда.

Есть ещё restart и stop/start: они перезапускают контейнеры как есть, не перечитывая файл. Отсюда классическое «поправил файл, сделал restart, а ничего не применилось». После правки — только up -d.

Проверить описание до запуска

Ошибку в файле дешевле поймать до запуска. Команда config печатает итоговое описание: со всеми подставленными переменными, в том виде, в каком его прочитал Compose.

ubuntu@stand:~$
docker compose config | grep -e image -e DATABASE
ubuntu@stand:~$
      DATABASE_URL: postgres://provision:provision-local-pass@db:5432/provision
    image: postgres:17-alpine

Флаг -e задаёт шаблон поиска, их можно дать несколько. grep оставил строку подключения и образ базы, и видно, во что превратилась подстановка пароля из .env. Если переменная не задана, config скажет об этом сразу, а не после полуминуты загадочных ошибок. Это та же роль, что у nginx -t в разделе про веб-сервер.

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

up
Привести запущенное к описанию: создать недостающее, пересоздать изменившееся. После правки файла — всегда up.
down -v
Удалить контейнеры, сеть и тома. На машине с ценными данными не используется.
config
Напечатать итоговое описание после подстановок. Первая проверка, когда применилось не то.

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

  • Поправили файл, сделали restart — изменения не применились. Почему?
    restart перезапускает контейнер как есть и файл не перечитывает. Описание с реальностью сверяет только up.
  • Чем exec отличается от run в Compose?
    exec запускает команду в уже работающем контейнере сервиса, run создаёт новый одноразовый контейнер из того же описания — для разовых задач.

Что дальше

Команды на месте. Дальше — практика: перенести приложение стенда и базу в одно описание.

Проверь себя+170 XPдве попытки
1
Поднять и применить
Поправили compose.yaml. Какая команда применит изменения?
2
Журналы
Как следить за журналом одного сервиса app?
3
Остановить
Чем опасна команда docker compose down -v?
4
Проверить описание
Зачем docker compose config?
ответь на все вопросы, чтобы проверить

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