Уведомления о завершении выполнения контейнера

В некоторых случаях сервис может принудительно остановить экземпляр контейнера. При этом в код Docker-образа поступает уведомление о предстоящем принудительном завершении работы.

В зависимости от таймаута, заданного в настройках ревизии контейнера, и текущего состояния экземпляра контейнера, существует два типа таких уведомлений:

• для активных экземпляров долгоживущих контейнеров;
• для неактивных экземпляров контейнеров.

Важнейшее различие между этими типами уведомлений — количество времени, которое дается контейнеру на штатное завершение работы до того, как экземпляр будет завершен принудительно. Данное различие необходимо учитывать в обработчиках этих типов уведомлений.

Уведомление кода Docker-образа в активном экземпляре долгоживущего контейнераУведомление кода Docker-образа в активном экземпляре долгоживущего контейнера

Этот тип уведомления направляется в код Docker-образа при соблюдении следующих условий:

• контейнер является долгоживущим;
• до истечения срока таймаута, заданного в настройках ревизии контейнера, остается более десяти минут;
• экземпляр контейнера в текущий момент активен, то есть обрабатывает как минимум один вызов.

Уведомление о предстоящей принудительной остановке экземпляра контейнера отправляется в код Docker-образа за десять минут до момента принудительного завершения работы экземпляра. В качестве уведомления отправляется POSIX-сигнал Termination signal — SIGTERM.

Добавьте в код приложения в Docker-образе обработчик, который будет реагировать на поступающий от операционной системы POSIX-сигнал SIGTERM. Это позволит избежать потери данных в случае нештатного завершения обработки вызова, обусловленного принудительной остановкой экземпляра контейнера.

Если в долгоживущем контейнере нет обработчика сигнала SIGTERM, то после отправки уведомления приложение пользователя будет закрыто операционной системой как приложение, проигнорировавшее сигнал завершения.

Вы можете отключить рассылку сигналов о предстоящей принудительной остановке экземпляра контейнера. Для этого в ревизию контейнера необходимо добавить переменную окружения X_YCF_NO_GRACEFUL_SHUTDOWN_SIGNAL со значением 1. В этом случае у экземпляра контейнера будет также десять минут на завершение работы, но уведомление о принудительной остановке в код Docker-образа направляться не будет.

Уведомление кода Docker-образа в неактивном экземпляре контейнераУведомление кода Docker-образа в неактивном экземпляре контейнера

Этот тип уведомления направляется в код Docker-образа при условии, что экземпляр контейнера неактивен, то есть в текущий момент не обрабатывает ни одного вызова.

При принятии решения о принудительном завершении работы неактивного экземпляра контейнера в код Docker-образа сначала направляется POSIX-сигнал SIGTERM, а затем (спустя 50 миллисекунд) — POSIX-сигнал SIGKILL, который принудительно остановит процесс.

Такая остановка экземпляра контейнера принудительно завершает все сетевые соединения на уровне L3 сетевой модели OSI.

В коде приложения в Docker-образе вы можете использовать обработчик, чтобы перехватить поступивший сигнал SIGTERM. Так вы сможете, например, штатно завершить сессии в сетевых соединениях (на уровне L7 сетевой модели OSI).

Отправка уведомлений в код Docker-образа неактивного экземпляра контейнера — безусловная. Она не зависит от заданного в ревизии контейнера значения таймаута. Отключить отправку таких уведомлений или изменить время ожидания нельзя.