Проверки работоспособности
- У сервиса с http_port есть проверка работоспособности. У сервиса без него проверки нет, и он считается готовым, как только его процесс запущен.
- Если задан health_check_path, проверка — это HTTP GET по этому пути на http_port, который отправляется каждому экземпляру раз в 5 секунд с тайм-аутом 1 секунда. Успешным считается статус от 200 до 399. Путь может содержать строку запроса. Без пути проверка лишь открывает TCP-соединение с портом.
- Проверка не проходит через публичную точку доступа. В заголовке Host передаётся внутренний адрес экземпляра, заголовка X-Forwarded-For нет, поэтому фреймворк, отклоняющий неизвестные хосты, должен делать исключение для пути проверки.
- Экземпляр получает трафик, только пока проходит проверку. После 3 неудач подряд, примерно через 15 секунд, он исключается из маршрутизации и возвращается, как только одна проверка пройдёт. Неудачная проверка никогда не перезапускает экземпляр.
- Отдельной проверки «живости» нет: зависший, но не завершившийся процесс не перезапускается. Завершайте процесс при неустранимых ошибках или перезапускайте сервис через API.
- Настройки задержки запуска нет. Проверки начинаются при старте контейнера и не проходят, пока приложение не ответит; на готовность релизу отводится 10 минут.
Как выкатывается релиз
Каждый deploy, restart и rollback создаёт релиз с зафиксированными дайджестом образа, конфигурацией, окружением и секретами.
- Сервис без томов: новый экземпляр запускается рядом со старым. После того как он 10 секунд проходит проверку работоспособности, трафик переключается на него, а старый экземпляр завершается. Несколько экземпляров заменяются по одному. Исправный релиз не вызывает простоя, и короткое время обе версии работают одновременно.
- Сервис с томами: сначала завершается старый экземпляр, и новый запускается только после его остановки. Две версии никогда не работают одновременно и никогда не пишут в один том. Сервис недоступен от начала завершения до момента, когда новый экземпляр 10 секунд подряд проходит проверку работоспособности.
- Сервис с томами и несколькими экземплярами: deploy заменяет их по очереди. Restart, rollback и изменение подключений или размеров томов останавливают все экземпляры перед запуском новых.
- Добавление первого тома к сервису или удаление последнего также останавливает старые экземпляры перед запуском новых.
- Поскольку предыдущий релиз может быть автоматически запущен снова, сохраняйте данные на томе читаемыми для предыдущей версии, пока новый релиз не подтверждён как исправный.
Неудачные релизы и сбои
- Во время выкатки релиз сразу считается неудачным, если один из его экземпляров завершился, был принудительно остановлен из-за превышения памяти, не смог загрузить образ или не смог запуститься. Он также считается неудачным, если не стал готов за 10 минут. Автоматических повторов нет: устраните причину и выполните деплой снова.
- Если ранее был активный релиз, он продолжает обслуживать запросы (сервис без томов) или автоматически запускается снова (сервис с томами). Автоматическое восстановление выглядит как деплой с action recover, а статус сервиса остаётся degraded, пока этот или более поздний деплой не завершится успешно.
- Если более раннего релиза не было, неудачные экземпляры останавливаются, а статус сервиса становится failed или stopped.
- Когда релиз активен, экземпляр, процесс которого завершился, перезапускается автоматически. Когда один экземпляр перезапустился 10 раз, все экземпляры сервиса останавливаются, а его статус становится stopped. Чтобы запустить сервис, выполните деплой снова; у новых экземпляров счёт начинается с нуля.
- Одна лишь неудачная проверка работоспособности никогда не останавливает и не перезапускает работающий сервис.
Откат, перезапуск, остановка
- Rollback заново развёртывает более ранний релиз с его дайджестом образа, конфигурацией, окружением и секретами. Текущие точки доступа сохраняются, данные на томах не откатываются.
- Откат доступен для релизов с отметкой can_rollback среди 20 последних деплоев: это релизы, которые когда-либо были активными.
- Restart запускает новые экземпляры текущего релиза. Сохранённые, но не развёрнутые изменения конфигурации не применяются.
- Stop завершает все экземпляры и отменяет выполняющийся релиз. Тома сохраняются. Запустить сервис снова можно через deploy или restart.
- Удаление сервиса удаляет его экземпляры, точки доступа и связанные CDN pull-зоны и сохраняет тома. Удаление приложения удаляет всё его содержимое, включая данные на томах и CDN pull-зоны, связанные с его точками доступа. Зоны Storage сохраняются.
Статус и логи
- Статус сервиса: draft (ни разу не развёртывался), deploying, running, degraded (последний деплой неудачен, работает или восстанавливается предыдущий релиз), failed (последний деплой неудачен, и ничего не работает), stopping, stopped, stop_failed, deleting, delete_failed.
- Статус деплоя: queued, deploying и health_checking — выполняется; active — обслуживает трафик; superseded — был активным и заменён; failed и cancelled — конечные.
- У каждого деплоя есть хронология (progress), а при ошибке — причина (failure), обе на языке запроса.
- Логи — это стандартный вывод и стандартный поток ошибок контейнера. Пишите логи туда; файлы логов внутри контейнера не собираются.
- API возвращает последние 1000 строк, не более 256 КиБ, одного экземпляра: за текущий запуск или за запуск, предшествовавший последнему перезапуску.
- Вывод существует, только пока существует его экземпляр. Релиз, перезапуск, остановка и откат заменяют экземпляры, и их прежний вывод исчезает. Для истории отправляйте логи в собственный сборщик по HTTPS.
- Значения секретов сервиса в возвращаемых логах заменяются на [REDACTED].
- Ответ с сервисом содержит процессорное время, использование памяти, исходящий трафик и стоимость за текущий месяц. Графики CPU, памяти и полосы в реальном времени доступны только в личном кабинете.
Точные поля запросов и ответов, ограничения и ответы с ошибками приведены в справочнике Management API.