Files
mtusi2026lab3/src/config.py
T

123 lines
4.9 KiB
Python

"""Конфигурация из переменных окружения.
Секреты (строки подключения с паролями) читаются из файлов *_FILE,
которые Compose монтирует как secrets в /run/secrets/. Для локального
запуска без Docker допускаются и прямые переменные DATABASE_URL / CACHE_URL.
"""
import os
from dataclasses import dataclass
from typing import Optional
def _read_secret(name: str) -> Optional[str]:
path = os.environ.get(name + "_FILE")
if path:
with open(path, "r", encoding="utf-8") as handle:
value = handle.read().strip()
return value or None
value = os.environ.get(name, "").strip()
return value or None
def _int(name: str, default: int) -> int:
raw = os.environ.get(name)
if raw is None or raw.strip() == "":
return default
return int(raw)
def _float(name: str, default: float) -> float:
raw = os.environ.get(name)
if raw is None or raw.strip() == "":
return default
return float(raw)
def _bool(name: str, default: bool) -> bool:
raw = os.environ.get(name)
if raw is None or raw.strip() == "":
return default
return raw.strip().lower() in {"1", "true", "yes", "on"}
@dataclass(frozen=True)
class Settings:
app_env: str
app_version: str
instance_id: str
database_url: str
cache_url: Optional[str]
session_store: str
session_ttl_seconds: int
session_cache_ttl_seconds: int
db_pool_min: int
db_pool_max: int
db_pool_timeout: float
db_connect_timeout: int
db_statement_timeout_ms: int
cache_timeout_seconds: float
cache_retry_after_seconds: float
migrate_wait_seconds: int
run_migrations_on_start: bool
idempotency_ttl_seconds: int
idempotency_cleanup_interval_seconds: int
ready_db_timeout_seconds: float
drain_seconds: float
graceful_timeout_seconds: int
keep_alive_seconds: int
password_hash_concurrency: int
def load_settings() -> Settings:
database_url = _read_secret("DATABASE_URL")
if not database_url:
raise RuntimeError("DATABASE_URL or DATABASE_URL_FILE must be set")
ttl = _int("SESSION_TTL_SECONDS", 3600)
if ttl < 1:
raise RuntimeError("SESSION_TTL_SECONDS must be positive")
session_store = os.environ.get("SESSION_STORE", "postgres").strip().lower()
# Источник истины для сессий в этой реализации всегда PostgreSQL;
# Redis (CACHE_URL) — только кэш проверок токена.
if session_store != "postgres":
raise RuntimeError("only SESSION_STORE=postgres is supported")
idem_ttl = _int("IDEMPOTENCY_TTL_SECONDS", 86400)
if idem_ttl < 86400:
# Контракт: повтор в течение 24 часов возвращает тот же результат.
raise RuntimeError("IDEMPOTENCY_TTL_SECONDS must be >= 86400")
# X-Instance-Id: по умолчанию hostname контейнера (= короткий ID контейнера
# Docker), стабилен в пределах жизни процесса. INSTANCE_ID — для запуска без Docker.
from .runtime import INSTANCE_ID as instance_id
return Settings(
app_env=os.environ.get("APP_ENV", "lab"),
app_version=os.environ.get("APP_VERSION", "lab3"),
instance_id=instance_id,
database_url=database_url,
cache_url=_read_secret("CACHE_URL"),
session_store=session_store,
session_ttl_seconds=ttl,
session_cache_ttl_seconds=_int("SESSION_CACHE_TTL_SECONDS", 60),
db_pool_min=_int("DB_POOL_MIN", 1),
db_pool_max=_int("DB_POOL_MAX", 10),
db_pool_timeout=_float("DB_POOL_TIMEOUT_SECONDS", 3.0),
db_connect_timeout=_int("DB_CONNECT_TIMEOUT_SECONDS", 3),
db_statement_timeout_ms=_int("DB_STATEMENT_TIMEOUT_MS", 5000),
cache_timeout_seconds=_float("CACHE_TIMEOUT_SECONDS", 0.25),
cache_retry_after_seconds=_float("CACHE_RETRY_AFTER_SECONDS", 5.0),
migrate_wait_seconds=_int("MIGRATE_WAIT_SECONDS", 60),
# lab3: миграции выполняет отдельный one-shot сервис `migrate`,
# реплики API их не запускают (нет гонки N реплик за схему).
run_migrations_on_start=_bool("RUN_MIGRATIONS_ON_START", False),
idempotency_ttl_seconds=idem_ttl,
idempotency_cleanup_interval_seconds=_int("IDEMPOTENCY_CLEANUP_INTERVAL_SECONDS", 300),
ready_db_timeout_seconds=_float("READY_DB_TIMEOUT_SECONDS", 1.0),
drain_seconds=_float("DRAIN_SECONDS", 3.0),
graceful_timeout_seconds=_int("GRACEFUL_TIMEOUT_SECONDS", 10),
keep_alive_seconds=_int("KEEP_ALIVE_SECONDS", 30),
password_hash_concurrency=_int("PASSWORD_HASH_CONCURRENCY", 4),
)