Provision
—— XP

Порядок запуска и перезапуск

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

При первом docker compose up приложение падает с ошибкой подключения к базе, а после перезапуска работает. Это самая частая жалоба на Compose, и документация Docker разбирает её на отдельной странице, Control startup order: https://docs.docker.com/compose/how-tos/startup-order/. Причина в том, что путают две разные вещи. Порядок запуска — это просто кого Compose поднимает первым, а кого следом. Готовность — момент, когда программа внутри контейнера действительно может работать.

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

Запущен — не значит готов

В прошлой практике у приложения было depends_on: - db. Эта запись значит только «сначала нажми кнопку у базы, потом у приложения». Приложение стартует через долю секунды, а PostgreSQL в этот момент ещё разворачивает файлы и соединения не принимает.

Две временные шкалы. Вверху depends_on без условия: приложение стартует через доли секунды и падает с connection refused, пока база инициализируется. Внизу с условием service_healthy: приложение запускается только после успешной проверки.
Первая форма ждёт только запуска, вторая — готовности. Отсюда жалоба «при первом запуске падает, после перезапуска работает».

Нашему приложению повезло: оно подключается к базе на каждый запрос и просто отвечает «база недоступна», пока та не готова. Многие приложения подключаются один раз при старте — и падают.

Лекарство из двух частей: научить базу сообщать о готовности и попросить приложение этого дождаться.

Проверка готовности

Первая часть — healthcheck у базы. Это та же проверка здоровья, что HEALTHCHECK в Dockerfile, только описанная в Compose. Обязательна в ней одна строка — сама команда:

compose.yaml, у сервиса db
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U provision"]

pg_isready — утилита из образа PostgreSQL, которая отвечает, принимает ли база соединения. Первое слово списка выбирает, как выполнить команду. CMD-SHELL — передать строку оболочке sh, как строковую форму в Dockerfile: можно писать одной строкой, с переменными и ||. CMD — запустить программу напрямую, тогда каждый аргумент идёт отдельным элементом: ["CMD", "pg_isready", "-U", "provision"]. Встретятся обе формы, работают одинаково.

Этого уже хватает, но остальное Docker возьмёт по умолчанию: проверять раз в 30 секунд, ждать ответа до 30 секунд, считать больным после трёх неудач подряд. Первая проверка — тоже через 30 секунд, и всё это время приложение ждёт базу, которая давно готова. В практике это даст подъём стека за полминуты вместо нескольких секунд. Поэтому параметры обычно дописывают:

compose.yaml, у сервиса db
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -h 127.0.0.1 -U provision"]
      interval: 5s
      retries: 10
      start_period: 10s

interval — как часто проверять, retries — сколько неудач подряд считать болезнью, start_period — окно на старте, когда неудачи не засчитываются. Есть ещё timeout — сколько ждать ответа одной проверки.

Флаг -h 127.0.0.1 — оговорка про самый первый запуск. На пустом томе образ PostgreSQL поднимает временный сервер, который слушает только внутренний файл-сокет, а не сеть: создаёт базу, пользователя и выключается. Без -h проверка постучится в этот временный сервер и объявит базу готовой раньше времени, а приложение, которое ходит по сети, получит отказ. С -h 127.0.0.1 проверка идёт по сети, как настоящий клиент. На уже созданном томе разницы нет.

Вторая часть — длинная форма depends_on у приложения, с условием.

compose.yaml, у сервиса app
    depends_on:
      db:
        condition: service_healthy

Теперь Compose дождётся статуса healthy у базы и только потом запустит приложение. Без объявленного healthcheck такое условие Compose не примет и откажется стартовать.

Разовая задача: миграция

Между базой и приложением обычно есть третий участник — миграция: разовая задача, которая создаёт или меняет таблицы и завершается. В прошлой практике её роль сыграли две строки SQL, набранные руками в psql. Руками — значит однажды забыть.

Миграцию описывают отдельным сервисом, который запускается, делает дело и выходит. Его особенность — restart: "no": с политикой перезапуска Compose поднимал бы завершившуюся задачу бесконечно. Приложение ждёт её третьим условием.

compose.yaml, у сервиса app
    depends_on:
      migrate:
        condition: service_completed_successfully

service_completed_successfully — «контейнер завершился с кодом 0». Цепочка получается честной: база готова → миграция отработала → приложение стартовало. Упала миграция — приложение не поднимется вовсе. Это правильно: работающее приложение на неподходящих таблицах хуже незапустившегося.

В списке docker compose ps -a миграция будет висеть как Exited (0). Это не авария, а выполненная работа; настораживать должен любой другой код.

Политика перезапуска

Порядок решает, что происходит на старте. Что делать, если сервис упал потом, решает restart — его ты уже ставил в первой практике раздела: unless-stopped поднимает сервис после сбоя и после перезапуска Docker, но не после ручной остановки, no оставляет лежать — так нужно разовым задачам. Бывают ещё on-failure (только при ошибке) и always (всегда, даже после ручной остановки — когда перезапустится служба Docker).

У перезапуска есть обратная сторона: он прячет причину. Сервис падает сразу после старта, поднимается, снова падает — и ps показывает бодрое Restarting.

ubuntu@stand:~$
docker compose ps
ubuntu@stand:~$
NAME              SERVICE   STATUS
provision-app-1   app       Restarting (1) 3 seconds ago

Такой сервис не проработал ни разу. Лечится чтением журнала — docker compose logs --tail 20 app, — а не увеличением числа попыток. И ещё одно: depends_on после старта не действует вовсе. Упадёт база через час — приложение никто не перезапустит, оно узнает об этом на следующем запросе. Поэтому приложение обязано переживать недоступность базы, как наш /items с ответом 503.

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

healthcheck
Команда проверки готовности сервиса. Её результат — статус healthy или unhealthy.
service_healthy
Условие depends_on: ждать статуса healthy у зависимости.
service_completed_successfully
Условие для разовых задач: ждать, пока контейнер завершится с кодом 0.
unless-stopped
Политика перезапуска: поднимать после сбоя и перезагрузки, но не после ручной остановки.

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

  • Приложение падает при первом запуске и работает при втором. Причина?
    Гонка при старте: depends_on без условия ждёт только запуска контейнера базы. Нужен healthcheck у базы и условие service_healthy у приложения.
  • Что должна проверять проверка здоровья приложения?
    Только то, что сам процесс жив и отвечает. Если она ходит в базу, проблема базы превращается в перезапуск приложения и каскад.

Что дальше

Порядок и перезапуск понятны. Дальше — практика: собрать цепочку база → миграция → приложение и уронить каждое звено.

Проверь себя+170 XPдве попытки
1
Запущен — не значит готов
Что гарантирует depends_on без условия?
2
Проверка готовности
Что нужно для condition: service_healthy?
3
Разовая задача
Как приложение дождётся конца миграции?
4
Политика перезапуска
Сервис в состоянии Restarting. Что делать первым?
ответь на все вопросы, чтобы проверить

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