Files
mtusi2026lab3/src/main.py
T

144 lines
6.0 KiB
Python

"""Сборка приложения и запуск uvicorn.
Порядок middleware (снаружи внутрь): ServerErrorMiddleware Starlette →
RequestIdMiddleware → AuthenticationMiddleware (Bearer) →
ExceptionMiddleware → роутер. Последний `add_middleware` оказывается
снаружи, поэтому RequestIdMiddleware добавляется последним: ответ 401
получает тот же id, что и остальные ответы, и попадает в access-лог.
Хранилище собирается здесь: `CachedStorage` (Valkey) поверх
`PostgresStorage`. Engine и клиент Valkey открывают соединения лениво:
без PostgreSQL процесс стартует, а `/health/ready` отвечает 503.
С лабы 3 процессов несколько — реплики за HAProxy. В памяти процесса нет
ничего, от чего зависит корректность: сессии, данные и ключи
идемпотентности — в PostgreSQL, Valkey — общий кэш неизменяемых карточек.
Каждый процесс по-прежнему один, с одним event loop: масштабирование —
числом реплик, а не `--workers`.
"""
import os
import sys
from collections.abc import AsyncIterator
from contextlib import asynccontextmanager
import uvicorn
from fastapi import FastAPI
from starlette.middleware.authentication import AuthenticationMiddleware
from src import early_stop
from src.api import handlers
from src.api.identity import BearerBackend, on_auth_error
from src.api.request_id import RequestIdMiddleware
from src.api.routes import api_router, health_router
from src.cache import create_cache
from src.config import ConfigError, Settings
from src.db import Db
from src.log import get_logger, logging_config
from src.passwords import Passwords
from src.storage import CachedStorage, PostgresStorage
log = get_logger(__name__)
@asynccontextmanager
async def lifespan(app: FastAPI) -> AsyncIterator[None]:
# сервер стартовал: сигналы дальше обрабатывает uvicorn
early_stop.disarm()
settings: Settings = app.state.settings
if not settings.database.password:
log.warning("database password is empty")
if not settings.cache.password:
log.warning("cache password is empty")
# десятки миллисекунд CPU при старте: время ответа на вход с
# неизвестным username ровное с первого запроса
await app.state.passwords.prepare()
# instance — значение X-Instance-Id: по этой строке реплика в журнале
# сопоставляется с ответами, которые видел клиент
log.info(
"messenger started instance=%s host=%s port=%d pid=%d db=%s:%d/%s "
"cache=%s:%d pool=%d+%d session_ttl=%ds idempotency_ttl=%ds "
"shutdown_timeout=%ds keep_alive=%ds",
settings.instance_id,
settings.host,
settings.port,
os.getpid(),
settings.database.host,
settings.database.port,
settings.database.name,
settings.cache.host,
settings.cache.port,
settings.database.pool_size,
settings.database.pool_overflow,
settings.session_ttl,
settings.idempotency_ttl,
settings.shutdown_timeout,
settings.keep_alive,
)
app.state.ready = True
try:
yield
finally:
app.state.ready = False
# сюда uvicorn приходит после SIGTERM, когда начатые запросы
# закончились или вышел SHUTDOWN_TIMEOUT; данные уже в PostgreSQL
await app.state.db.dispose()
await app.state.cache.close()
log.info("messenger stopped instance=%s", settings.instance_id)
def create_app(settings: Settings | None = None) -> FastAPI:
"""Приложение с хранилищем на PostgreSQL и кэшем в Valkey."""
settings = settings or Settings.from_env()
app = FastAPI(
title="MTUSI Messenger — лабораторная 3",
version="1.3.0",
lifespan=lifespan,
)
db = Db(settings.database)
# ключи кэша — по имени базы: тестовая база не видит карточек рабочей
cache = create_cache(settings.cache, namespace=db.name)
app.state.settings = settings
app.state.db = db
app.state.cache = cache
app.state.storage = CachedStorage(
PostgresStorage(db),
cache,
chat_ttl=settings.cache.chat_ttl,
)
app.state.passwords = Passwords(settings.kdf_concurrency)
app.state.ready = False
handlers.install(app)
app.add_middleware(
AuthenticationMiddleware,
backend=BearerBackend(),
on_error=on_auth_error,
)
app.add_middleware(RequestIdMiddleware, instance_id=settings.instance_id)
app.include_router(health_router)
app.include_router(api_router)
return app
def run() -> None:
"""Точка входа `python -m src`: один процесс, один event loop."""
try:
settings = Settings.from_env()
except ConfigError as exc:
print(f"configuration error: {exc}", file=sys.stderr)
raise SystemExit(2) from None
# экземпляр, а не строка импорта: без reload и без --workers. Пул
# соединений считается на один процесс; процессов — число реплик
uvicorn.run(
create_app(settings),
host=settings.host,
port=settings.port,
log_config=logging_config(settings.log_level),
access_log=False,
server_header=False,
timeout_graceful_shutdown=settings.shutdown_timeout,
timeout_keep_alive=settings.keep_alive,
)