144 lines
6.0 KiB
Python
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,
|
|
)
|