123 lines
4.9 KiB
Python
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),
|
|
)
|