33 lines
1.8 KiB
Python
33 lines
1.8 KiB
Python
"""Состояние жизненного цикла реплики: готова / уходит (graceful shutdown).
|
|
|
|
Идея: при SIGTERM реплика сначала перестаёт быть "ready" (/health/ready -> 503),
|
|
чтобы балансировщик успел исключить её, и только затем uvicorn перестаёт
|
|
принимать соединения и дожидается текущих запросов.
|
|
"""
|
|
|
|
|
|
class Lifecycle:
|
|
def __init__(self) -> None:
|
|
self._draining = False
|
|
|
|
@property
|
|
def draining(self) -> bool:
|
|
return self._draining
|
|
|
|
def start_draining(self) -> None:
|
|
"""TODO(4.1): вызвать при получении SIGTERM / в начале shutdown."""
|
|
self._draining = True
|
|
|
|
|
|
# TODO(4.1): решить, где перехватывать SIGTERM.
|
|
# uvicorn сам ставит обработчик SIGTERM и сразу закрывает listening socket,
|
|
# поэтому "сначала readiness=503, потом закрыть приём" нужно сделать явно:
|
|
# - либо обернуть/переопределить обработчик сигнала uvicorn
|
|
# (uvicorn.Server.handle_exit) так, чтобы он сначала вызывал
|
|
# lifecycle.start_draining(), ждал SHUTDOWN_DRAIN_SECONDS и только потом
|
|
# передавал управление штатному завершению;
|
|
# - либо полагаться на passive-проверки nginx (proxy_next_upstream) и честно
|
|
# описать в REPORT.md, сколько запросов теряется.
|
|
# Сумма drain + timeout_graceful_shutdown должна быть меньше stop_grace_period
|
|
# в compose.yaml, иначе Docker добьёт процесс SIGKILL.
|