Релизы и работоспособность

Проверки работоспособности, выкатка релиза, сбои, откат, статус и логи.

Проверки работоспособности

  • У сервиса с 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.