forked from mtusi2026/mtusi2026lab5
95 lines
4.4 KiB
Python
95 lines
4.4 KiB
Python
"""Точка входа API: python -m messenger."""
|
||
import logging
|
||
import signal
|
||
import sys
|
||
import threading
|
||
import time
|
||
|
||
from .config import load_config
|
||
from .db import Repository, create_pool
|
||
from .server import MessengerServer
|
||
from .sessions import SessionStore
|
||
from .objects import ObjectStore
|
||
|
||
log = logging.getLogger('messenger')
|
||
|
||
# Как часто реплика удаляет ключи идемпотентности старше срока хранения.
|
||
CLEANUP_INTERVAL = 600
|
||
|
||
|
||
def cleanup_idempotency_keys(repo, ttl, stop):
|
||
"""Фоновая очистка. Каждая реплика делает одно и то же; повторный DELETE безвреден."""
|
||
while not stop.wait(CLEANUP_INTERVAL):
|
||
try:
|
||
deleted = repo.delete_expired_idempotency_keys(ttl)
|
||
log.info('event=idempotency_cleanup deleted=%d', deleted)
|
||
except Exception as error: # очистка не должна останавливать реплику
|
||
log.warning('event=idempotency_cleanup_failed error=%s', type(error).__name__)
|
||
|
||
|
||
def main():
|
||
config = load_config()
|
||
logging.Formatter.converter = time.gmtime # время в логах — UTC
|
||
logging.basicConfig(
|
||
stream=sys.stdout,
|
||
level=config.log_level,
|
||
format='%(asctime)s.%(msecs)03dZ %(levelname)s %(message)s',
|
||
datefmt='%Y-%m-%dT%H:%M:%S',
|
||
)
|
||
# Пул открывается в фоне: если БД ещё не готова, API всё равно стартует,
|
||
# а /health/ready отвечает 503, пока соединение не появится.
|
||
pool = create_pool(config.database_url, config.db_pool_size)
|
||
pool.open(wait=False)
|
||
sessions = SessionStore(config.cache_url, config.session_ttl)
|
||
repo = Repository(pool)
|
||
try:
|
||
server = MessengerServer((config.host, config.port), repo, sessions, config.instance_id,
|
||
config.idempotency_ttl, ObjectStore())
|
||
except OSError as error:
|
||
log.error('event=bind_failed host=%s port=%d error=%s', config.host, config.port, error)
|
||
return 1
|
||
|
||
# Обработчик сигнала только запоминает номер: всю остановку делает главный поток.
|
||
received = []
|
||
|
||
def on_signal(signum, _frame):
|
||
received.append(signum)
|
||
|
||
for name in ('SIGTERM', 'SIGINT', 'SIGBREAK'): # SIGBREAK есть только в Windows
|
||
if hasattr(signal, name):
|
||
signal.signal(getattr(signal, name), on_signal)
|
||
|
||
stop_cleanup = threading.Event()
|
||
threading.Thread(target=cleanup_idempotency_keys, args=(repo, config.idempotency_ttl, stop_cleanup),
|
||
name='idempotency-cleanup', daemon=True).start()
|
||
threading.Thread(target=server.serve_forever, name='accept-loop', daemon=True).start()
|
||
log.info('event=started instance=%s version=%s host=%s port=%d env=%s session_ttl_s=%d db_pool_max=%d '
|
||
'drain_delay_s=%g shutdown_timeout_s=%g', config.instance_id, config.version, config.host, config.port,
|
||
config.env, config.session_ttl, config.db_pool_size, config.drain_delay, config.shutdown_timeout)
|
||
|
||
while not received:
|
||
time.sleep(0.1)
|
||
|
||
started = time.monotonic()
|
||
log.info('event=shutdown_started signal=%s', signal.Signals(received[0]).name)
|
||
# 1. Реплика объявляет себя неготовой, но ещё обслуживает запросы: балансировщик проверяет
|
||
# /health/ready каждую секунду и после двух неудач (около 2 с) перестаёт слать сюда трафик.
|
||
server.begin_not_ready()
|
||
time.sleep(config.drain_delay)
|
||
# 2. Приём закрывается. Запросы на уже открытых соединениях получают 503.
|
||
server.begin_drain()
|
||
server.shutdown()
|
||
server.server_close()
|
||
# 3. Начатые запросы дорабатывают. Секунда остаётся на закрытие соединений с хранилищами.
|
||
remaining = config.shutdown_timeout - 1 - (time.monotonic() - started)
|
||
clean = server.wait_idle(max(remaining, 0))
|
||
stop_cleanup.set()
|
||
pool.close(timeout=1)
|
||
sessions.close()
|
||
log.info('event=shutdown_finished clean=%s duration_ms=%.0f', clean, (time.monotonic() - started) * 1000)
|
||
return 0 if clean else 1
|
||
|
||
|
||
if __name__ == '__main__':
|
||
sys.exit(main())
|