При первом docker compose up приложение падает с ошибкой подключения к базе, а после перезапуска работает. Это самая частая жалоба на Compose, и документация Docker разбирает её на отдельной странице, Control startup order: https://docs.docker.com/compose/how-tos/startup-order/. Причина в том, что путают две разные вещи. Порядок запуска — это просто кого Compose поднимает первым, а кого следом. Готовность — момент, когда программа внутри контейнера действительно может работать.
Духовка, у которой загорелась лампочка и зашумел вентилятор, запущена, но пирог ставить рано: она ещё не нагрелась, и узнать, что она готова, можно только по её собственному сигналу. С базой то же самое. Урок о том, как проверка здоровья и условия зависимостей заставляют приложение стартовать, когда база не просто запущена, а отвечает, и что Compose делает, когда сервис падает уже после старта.
Запущен — не значит готов
В прошлой практике у приложения было depends_on: - db. Эта запись значит только «сначала нажми кнопку у базы, потом у приложения». Приложение стартует через долю секунды, а PostgreSQL в этот момент ещё разворачивает файлы и соединения не принимает.
Нашему приложению повезло: оно подключается к базе на каждый запрос и просто отвечает «база недоступна», пока та не готова. Многие приложения подключаются один раз при старте — и падают.
Лекарство из двух частей: научить базу сообщать о готовности и попросить приложение этого дождаться.
Проверка готовности
Первая часть — healthcheck у базы. Это та же проверка здоровья, что HEALTHCHECK в Dockerfile, только описанная в Compose. Обязательна в ней одна строка — сама команда:
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 секунд, и всё это время приложение ждёт базу, которая давно готова. В практике это даст подъём стека за полминуты вместо нескольких секунд. Поэтому параметры обычно дописывают:
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 у приложения, с условием.
depends_on: db: condition: service_healthy
Теперь Compose дождётся статуса healthy у базы и только потом запустит приложение. Без объявленного healthcheck такое условие Compose не примет и откажется стартовать.
Разовая задача: миграция
Между базой и приложением обычно есть третий участник — миграция: разовая задача, которая создаёт или меняет таблицы и завершается. В прошлой практике её роль сыграли две строки SQL, набранные руками в psql. Руками — значит однажды забыть.
Миграцию описывают отдельным сервисом, который запускается, делает дело и выходит. Его особенность — restart: "no": с политикой перезапуска Compose поднимал бы завершившуюся задачу бесконечно. Приложение ждёт её третьим условием.
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.
docker compose psNAME SERVICE STATUS provision-app-1 app Restarting (1) 3 seconds ago
Такой сервис не проработал ни разу. Лечится чтением журнала — docker compose logs --tail 20 app, — а не увеличением числа попыток. И ещё одно: depends_on после старта не действует вовсе. Упадёт база через час — приложение никто не перезапустит, оно узнает об этом на следующем запросе. Поэтому приложение обязано переживать недоступность базы, как наш /items с ответом 503.
Словарь урока
Что спросят на собеседовании
- Приложение падает при первом запуске и работает при втором. Причина?Гонка при старте: depends_on без условия ждёт только запуска контейнера базы. Нужен healthcheck у базы и условие service_healthy у приложения.
- Что должна проверять проверка здоровья приложения?Только то, что сам процесс жив и отвечает. Если она ходит в базу, проблема базы превращается в перезапуск приложения и каскад.
Что дальше
Порядок и перезапуск понятны. Дальше — практика: собрать цепочку база → миграция → приложение и уронить каждое звено.