Files
mtusi2026lab3/app/core/lifecycle.py
T
2026-10-30 00:53:49 +03:00

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.