Команды Compose устроены так же, как команды Docker из прошлого раздела, только работают со всем проектом сразу: docker compose ps вместо docker ps, docker compose logs вместо docker logs. Их запускают из каталога, где лежит compose.yaml, и они сами находят свой файл. В первый месяц работы хватает шести, и все шесть ты будешь набирать по десять раз в день.
Это как пульт от телевизора вместо отвёртки внутри корпуса. Кнопок немного — включить, выключить, громкость, — и каждая делает понятное действие с целой системой, а не с отдельной деталью.
Шесть команд закрывают весь цикл стека: поднять, посмотреть, прочитать журнал, зайти внутрь, остановить и проверить описание до запуска.
Примеры урока сняты на стеке из двух сервисов — приложения и базы, — который ты соберёшь в следующей практике. Набирать их сейчас не обязательно: без compose.yaml в текущем каталоге Compose ответит no configuration file provided.
Поднять и посмотреть
Главная команда — up. Она сравнивает файл с тем, что запущено: создаёт недостающее, пересоздаёт изменившееся, а совпадающее не трогает. Поэтому после любой правки файла выполняют снова up.
docker compose up -d[+] Running 3/3 ✔ Network provision_default Created ✔ Container provision-db-1 Started ✔ Container provision-app-1 Started
Флаг -d — в фоне. Что поднялось и в каком состоянии, показывает ps.
docker compose psNAME 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 собирает со всех сервисов сразу, и в этом его заметное удобство.
docker compose logs --tail 3provision-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, только по имени сервиса, а не контейнера.
docker compose exec db psql -U provision -c 'select 1'?column? ---------- 1
Здесь внутри контейнера базы запущен клиент psql: флаг -U задаёт пользователя базы, -c — запрос. Ответ «1» значит, что база жива и принимает запросы.
Остановить
Останавливают стек командой down. Она удаляет контейнеры и сеть проекта, а тома оставляет: данные базы переживут.
docker compose down[+] 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.
docker compose config | grep -e image -e DATABASEDATABASE_URL: postgres://provision:provision-local-pass@db:5432/provision image: postgres:17-alpine
Флаг -e задаёт шаблон поиска, их можно дать несколько. grep оставил строку подключения и образ базы, и видно, во что превратилась подстановка пароля из .env. Если переменная не задана, config скажет об этом сразу, а не после полуминуты загадочных ошибок. Это та же роль, что у nginx -t в разделе про веб-сервер.
Словарь урока
Что спросят на собеседовании
- Поправили файл, сделали restart — изменения не применились. Почему?restart перезапускает контейнер как есть и файл не перечитывает. Описание с реальностью сверяет только up.
- Чем exec отличается от run в Compose?exec запускает команду в уже работающем контейнере сервиса, run создаёт новый одноразовый контейнер из того же описания — для разовых задач.
Что дальше
Команды на месте. Дальше — практика: перенести приложение стенда и базу в одно описание.