"""Точка входа контейнера: Uvicorn с фазой осушения (drain) перед остановкой. Последовательность при SIGTERM (docker stop / rolling update / stop-one): t=0 SIGTERM. Реплика ПРОДОЛЖАЕТ принимать и обслуживать запросы, но /health/ready -> 503 и ответы идут с Connection: close. t<=~1.5 с HAProxy (inter 1s, fastinter 500ms, fall 2) помечает реплику DOWN и больше не отправляет ей новые запросы. t=DRAIN_SECONDS (3 с) Uvicorn закрывает listening-сокет, дожидается завершения запросов в обработке (не дольше GRACEFUL_TIMEOUT_SECONDS = 10 с), закрывает пул PostgreSQL и выходит. stop_grace_period 20 с > 3 + 10 — Docker не успевает прислать SIGKILL. Повторный SIGTERM/SIGINT во время осушения — немедленный переход к остановке. Запуск: python -m src.server (CMD в Dockerfile, процесс — PID 1). """ import logging import os import threading import uvicorn from .runtime import DRAIN, INSTANCE_ID log = logging.getLogger("messenger.server") class DrainingServer(uvicorn.Server): drain_seconds = 3.0 def handle_exit(self, sig, frame): # вызывается из обработчика сигнала if self.should_exit or not DRAIN.begin(): # Второй сигнал (или уже останавливаемся) — без ожидания. return super().handle_exit(sig, frame) log.info( "signal %s: instance %s draining for %.1fs (readiness=503), then graceful stop", sig, INSTANCE_ID, self.drain_seconds, ) timer = threading.Timer(self.drain_seconds, super().handle_exit, args=(sig, frame)) timer.daemon = True timer.start() def main() -> None: logging.basicConfig(level=logging.INFO, format="%(asctime)s %(levelname)s %(name)s %(message)s") config = uvicorn.Config( "src.main:app", host=os.environ.get("APP_HOST", "0.0.0.0"), port=int(os.environ.get("APP_PORT", "8080")), # Дольше, чем HAProxy держит простаивающие соединения к серверу # (pool-purge-delay 5s): соединение закрывает LB, а не сервер под запросом. timeout_keep_alive=int(os.environ.get("KEEP_ALIVE_SECONDS", "30")), timeout_graceful_shutdown=int(os.environ.get("GRACEFUL_TIMEOUT_SECONDS", "10")), access_log=False, server_header=False, log_config=None, ) server = DrainingServer(config) server.drain_seconds = float(os.environ.get("DRAIN_SECONDS", "3")) server.run() if __name__ == "__main__": main()