Provision
—— XP

Шпаргалка и инструменты Compose

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

Раздел закончен, и здесь собрано то, что стоит держать под рукой: команды на каждый день, порядок разбора, когда стек ведёт себя не так, и несколько программ вокруг Compose. Этот стек — основа следующих разделов: базы данных, мониторинг и логи поднимутся такими же стеками Compose рядом, так что к странице ты будешь возвращаться.

Это короткий урок без нового материала: всё, что здесь есть, ты уже делал руками.

Шпаргалка раздела

Все команды запускаются из каталога с compose.yaml.

ubuntu@stand:~$
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 — она удаляет тома вместе с базой.

Быстрая отладка стека

Разбор идёт сверху вниз, от «кто сломан» к «почему». Обычно до последней строки дело не доходит.

ubuntu@stand:~$
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; годится как черновик, но не как готовый результат.

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

Оркестратор
Программа, которая распределяет контейнеры по нескольким машинам и переносит их при отказе: Kubernetes, Nomad, Swarm. ↩ к тексту
docker compose pull
Скачать новые версии образов из описания. Затем up -d пересоздаст изменившиеся сервисы.

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

  • Как обновить сервис на новую версию образа в 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 научит выкатывать его без рук.

Проверь себя+170 XPдве попытки
1
Быстрая отладка стека
Стек поднят, сайт не открывается. С чего начать?
2
Быстрая отладка стека
Применилось не то, что написано в файле. Что смотреть?
3
Когда машин больше одной
Что берут вместо Compose, когда серверов становится несколько?
ответь на все вопросы, чтобы проверить

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