forked from mtusi2026/mtusi2026lab6
66 lines
3.0 KiB
Python
66 lines
3.0 KiB
Python
"""Точка входа контейнера: 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()
|