Files
mtusi2026lab5/src/messenger/__main__.py
T

95 lines
4.4 KiB
Python
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
"""Точка входа 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())