113 lines
3.6 KiB
Python
113 lines
3.6 KiB
Python
from dataclasses import dataclass
|
|
from pathlib import Path
|
|
import os
|
|
import socket
|
|
|
|
|
|
def read_value(name: str, default: str | None = None) -> str:
|
|
file_name = os.getenv(f"{name}_FILE")
|
|
|
|
if file_name:
|
|
return Path(file_name).read_text(encoding="utf-8").strip()
|
|
|
|
value = os.getenv(name, default)
|
|
|
|
if value is None:
|
|
raise RuntimeError(f"{name} is required.")
|
|
|
|
return value
|
|
|
|
|
|
def read_positive_int(name: str, default: str) -> int:
|
|
value = int(os.getenv(name, default))
|
|
|
|
if value < 1:
|
|
raise RuntimeError(f"{name} must be positive.")
|
|
|
|
return value
|
|
|
|
|
|
def read_positive_float(name: str, default: str) -> float:
|
|
value = float(os.getenv(name, default))
|
|
|
|
if value <= 0:
|
|
raise RuntimeError(f"{name} must be positive.")
|
|
|
|
return value
|
|
|
|
|
|
@dataclass(frozen=True)
|
|
class Settings:
|
|
app_host: str
|
|
app_port: int
|
|
database_url: str
|
|
session_ttl_seconds: int
|
|
# PostgreSQL connection pool and timeouts.
|
|
db_pool_size: int
|
|
db_max_overflow: int
|
|
db_pool_timeout_seconds: float
|
|
db_connect_timeout_seconds: float
|
|
db_statement_timeout_ms: int
|
|
# Valkey is a session cache; PostgreSQL stays the source of truth.
|
|
cache_url: str | None
|
|
session_cache_ttl_seconds: int
|
|
cache_timeout_seconds: float
|
|
cache_max_connections: int
|
|
cache_retry_after_seconds: float
|
|
# Lab3: X-Instance-Id is the container hostname (short Docker ID), stable
|
|
# for the process lifetime; scripts/stop-one.sh maps it to a container.
|
|
instance_id: str
|
|
idempotency_ttl_seconds: int
|
|
# Graceful shutdown: readiness answers 503 for shutdown_drain_seconds so
|
|
# the LB drops this replica, then uvicorn closes the listener and waits
|
|
# for in-flight requests up to shutdown_timeout_seconds.
|
|
shutdown_drain_seconds: float
|
|
shutdown_timeout_seconds: int
|
|
|
|
|
|
def load_settings() -> Settings:
|
|
session_store = os.getenv("SESSION_STORE", "postgres").lower()
|
|
|
|
if session_store not in {"postgres", "valkey", "redis"}:
|
|
raise RuntimeError("SESSION_STORE must be postgres, valkey or redis.")
|
|
|
|
cache_url = None
|
|
if session_store != "postgres":
|
|
cache_url = read_value("CACHE_URL")
|
|
|
|
return Settings(
|
|
app_host=os.getenv("APP_HOST", "0.0.0.0"),
|
|
app_port=int(os.getenv("APP_PORT", "8080")),
|
|
database_url=read_value("DATABASE_URL"),
|
|
session_ttl_seconds=read_positive_int("SESSION_TTL_SECONDS", "3600"),
|
|
db_pool_size=read_positive_int("DB_POOL_SIZE", "10"),
|
|
db_max_overflow=int(os.getenv("DB_MAX_OVERFLOW", "5")),
|
|
db_pool_timeout_seconds=read_positive_float("DB_POOL_TIMEOUT_SECONDS", "3"),
|
|
db_connect_timeout_seconds=read_positive_float(
|
|
"DB_CONNECT_TIMEOUT_SECONDS", "3"
|
|
),
|
|
db_statement_timeout_ms=read_positive_int("DB_STATEMENT_TIMEOUT_MS", "5000"),
|
|
cache_url=cache_url,
|
|
session_cache_ttl_seconds=read_positive_int(
|
|
"SESSION_CACHE_TTL_SECONDS", "60"
|
|
),
|
|
cache_timeout_seconds=read_positive_float("CACHE_TIMEOUT_SECONDS", "0.25"),
|
|
cache_max_connections=read_positive_int("CACHE_MAX_CONNECTIONS", "20"),
|
|
cache_retry_after_seconds=read_positive_float(
|
|
"CACHE_RETRY_AFTER_SECONDS", "5"
|
|
),
|
|
instance_id=os.getenv("INSTANCE_ID") or socket.gethostname(),
|
|
idempotency_ttl_seconds=read_positive_int(
|
|
"IDEMPOTENCY_TTL_SECONDS", "86400"
|
|
),
|
|
shutdown_drain_seconds=read_positive_float(
|
|
"SHUTDOWN_DRAIN_SECONDS", "3"
|
|
),
|
|
shutdown_timeout_seconds=read_positive_int(
|
|
"SHUTDOWN_TIMEOUT_SECONDS", "8"
|
|
),
|
|
)
|
|
|
|
|
|
settings = load_settings()
|