Раздел закончен, и здесь собрано то, что стоит держать под рукой: команды на каждый день, порядок разбора, когда стек ведёт себя не так, и несколько программ вокруг Compose. Этот стек — основа следующих разделов: базы данных, мониторинг и логи поднимутся такими же стеками Compose рядом, так что к странице ты будешь возвращаться.
Это короткий урок без нового материала: всё, что здесь есть, ты уже делал руками.
Шпаргалка раздела
Все команды запускаются из каталога с compose.yaml.
docker compose up -d # поднять и применить правки файла docker compose ps -a # все сервисы, включая завершившиеся docker compose logs -f app # следить за журналом сервиса docker compose logs --tail 50 # последние строки всех сервисов docker compose exec db sh # зайти в работающий сервис docker compose config # итог после подстановок и наложения docker compose down # остановить, тома остаются docker compose pull # скачать образы из описания (сервер)
Флаг --tail оставляет последние строки журнала, -f держит его открытым, -a показывает и завершившиеся сервисы. И одна команда, которую не набирают на сервере никогда: docker compose down -v — она удаляет тома вместе с базой.
Быстрая отладка стека
Разбор идёт сверху вниз, от «кто сломан» к «почему». Обычно до последней строки дело не доходит.
docker compose ps -a # кто не running, какой код выхода docker compose logs --tail 50 app # что сказал сломанный сервис docker compose config | grep image # тот ли образ и та ли переменная docker compose exec app getent hosts db # видит ли сосед соседа ss -tlnp | grep 8443 # кто занял порт на хосте
Как читать ответы. Exited (0) у migrate — норма, у сервиса — нет. Restarting — сервис падает сразу после старта, причина в журнале. unhealthy — не проходит проверка здоровья: выполни её команду руками через exec. port is already allocated — порт занят, и ss с флагами -t (TCP), -l (слушающие), -n (числами), -p (какой процесс) покажет, кем.
Инструменты вокруг Compose
Встроенного хватает, но несколько внешних программ экономят время каждый день.
| Инструмент | Что делает | Когда пригодится |
|---|---|---|
| lazydocker | Терминальное окно: сервисы стека, журналы, потребление | Каждый день вместо длинных команд |
| Dockge | Интерфейс в браузере под стеки Compose: правка файла и запуск | Домашний сервер с десятком стеков |
| yamllint | Проверка отступов и синтаксиса YAML | До запуска и в конвейере CI |
| docker compose watch | Следит за исходниками и сам обновляет контейнер | Разработка вместо монтирования кода |
Ссылки: lazydocker — github.com/jesseduffield/lazydocker, Dockge — github.com/louislam/dockge, справочник по ключам файла — docs.docker.com/reference/compose-file.
Когда машин больше одной
Compose описывает стек на одной машине. Как только серверов становится несколько, нужен оркестратор — программа, которая сама решает, на какой машине запустить контейнер, и переносит его при отказе.
Родное продолжение Compose — Docker Swarm: тот же формат файла, но развивается слабо. Стандарт отрасли — Kubernetes, ему посвящены три раздела курса. Попроще — Nomad из раздела про HashiStack. Утилита kompose переводит файл Compose в описания Kubernetes; годится как черновик, но не как готовый результат.
Словарь урока
Что спросят на собеседовании
- Как обновить сервис на новую версию образа в Compose?На сервере, где образ берётся из реестра: поменять тег в .env (у нас APP_IMAGE), выполнить docker compose pull и docker compose up -d — пересоздастся только изменившийся сервис. При разработке со сборкой из Dockerfile — docker compose up -d --build.
- Сервис unhealthy. Что делать?Посмотреть журнал сервиса и выполнить команду его проверки здоровья руками через docker compose exec, чтобы увидеть, на чём она падает.
Что дальше
Раздел закрыт: весь стенд — одно описание в репозитории. Следующий раздел — базы данных: PostgreSQL и Redis отдельным стеком Compose рядом с этим: запросы, индексы и резервные копии. За ним — мониторинг и логирование, тоже своими стеками Compose. А когда стек станет наблюдаемым, раздел про CI/CD научит выкатывать его без рук.