forked from mtusi2026/mtusi2026lab4
Перенесён стенд lab3 (API, Redis-сессии, идемпотентность, HAProxy, реплики API). Добавлены приватный bucket SeaweedFS с отдельным ключом API, загрузка PNG/JPEG с лимитами и полной проверкой, компенсация и reconciler, плавная остановка API, тесты и evidence.
162 lines
4.4 KiB
Python
162 lines
4.4 KiB
Python
"""Runtime configuration from environment / secret files."""
|
|
|
|
from __future__ import annotations
|
|
|
|
import os
|
|
import socket
|
|
from pathlib import Path
|
|
|
|
|
|
def _read_secret(env_key: str, file_key: str, default: str | None = None) -> str:
|
|
file_path = os.environ.get(file_key, "").strip()
|
|
if file_path:
|
|
path = Path(file_path)
|
|
if path.is_file():
|
|
return path.read_text(encoding="utf-8").strip()
|
|
value = os.environ.get(env_key, "").strip()
|
|
if value:
|
|
return value
|
|
if default is not None:
|
|
return default
|
|
raise RuntimeError(f"Missing secret: set {env_key} or {file_key}")
|
|
|
|
|
|
def _int_env(key: str, default: int, minimum: int = 1) -> int:
|
|
raw = os.environ.get(key, str(default)).strip()
|
|
try:
|
|
value = int(raw)
|
|
except ValueError as exc:
|
|
raise RuntimeError(f"{key} must be an integer") from exc
|
|
if value < minimum:
|
|
raise RuntimeError(f"{key} must be >= {minimum}")
|
|
return value
|
|
|
|
|
|
def database_url() -> str:
|
|
return _read_secret("DATABASE_URL", "DATABASE_URL_FILE")
|
|
|
|
|
|
def cache_url() -> str:
|
|
return _read_secret("CACHE_URL", "CACHE_URL_FILE")
|
|
|
|
|
|
def session_ttl_seconds() -> int:
|
|
return _int_env("SESSION_TTL_SECONDS", 3600)
|
|
|
|
|
|
def idempotency_ttl_seconds() -> int:
|
|
return _int_env("IDEMPOTENCY_TTL_SECONDS", 86400)
|
|
|
|
|
|
def instance_id() -> str:
|
|
"""Stable for process lifetime; used as X-Instance-Id (maps to container hostname)."""
|
|
override = os.environ.get("INSTANCE_ID", "").strip()
|
|
if override:
|
|
return override[:128]
|
|
return socket.gethostname()[:128]
|
|
|
|
|
|
def app_host() -> str:
|
|
return os.environ.get("APP_HOST", "0.0.0.0")
|
|
|
|
|
|
def app_port() -> int:
|
|
return int(os.environ.get("APP_PORT", "8080"))
|
|
|
|
|
|
def migrations_dir() -> Path:
|
|
override = os.environ.get("MIGRATIONS_DIR", "").strip()
|
|
if override:
|
|
return Path(override)
|
|
here = Path(__file__).resolve()
|
|
candidates = [
|
|
Path("/app/migrations"),
|
|
here.parents[2] / "migrations",
|
|
Path.cwd() / "migrations",
|
|
]
|
|
for path in candidates:
|
|
if path.is_dir():
|
|
return path
|
|
return candidates[0]
|
|
|
|
|
|
# --- S3 / attachments (lab4) -------------------------------------------------
|
|
|
|
CONTRACT_MAX_UPLOAD_BYTES = 10 * 1024 * 1024
|
|
CONTRACT_MAX_IMAGE_PIXELS = 40_000_000
|
|
|
|
|
|
def s3_endpoint() -> str:
|
|
return os.environ.get("S3_ENDPOINT", "http://s3:9000").strip()
|
|
|
|
|
|
def s3_region() -> str:
|
|
return os.environ.get("S3_REGION", "us-east-1").strip()
|
|
|
|
|
|
def s3_bucket() -> str:
|
|
return os.environ.get("S3_BUCKET", "messenger-attachments").strip()
|
|
|
|
|
|
def s3_access_key_id() -> str:
|
|
return _read_secret("S3_ACCESS_KEY_ID", "S3_ACCESS_KEY_ID_FILE")
|
|
|
|
|
|
def s3_secret_access_key() -> str:
|
|
return _read_secret("S3_SECRET_ACCESS_KEY", "S3_SECRET_ACCESS_KEY_FILE")
|
|
|
|
|
|
def s3_admin_access_key_id() -> str:
|
|
return _read_secret("S3_ADMIN_ACCESS_KEY_ID", "S3_ADMIN_ACCESS_KEY_ID_FILE")
|
|
|
|
|
|
def s3_admin_secret_access_key() -> str:
|
|
return _read_secret("S3_ADMIN_SECRET_ACCESS_KEY", "S3_ADMIN_SECRET_ACCESS_KEY_FILE")
|
|
|
|
|
|
def max_upload_bytes() -> int:
|
|
# The contract caps uploads at 10 MiB; the environment may only lower it.
|
|
return min(_int_env("MAX_UPLOAD_BYTES", CONTRACT_MAX_UPLOAD_BYTES), CONTRACT_MAX_UPLOAD_BYTES)
|
|
|
|
|
|
def max_image_pixels() -> int:
|
|
return min(_int_env("MAX_IMAGE_PIXELS", CONTRACT_MAX_IMAGE_PIXELS), CONTRACT_MAX_IMAGE_PIXELS)
|
|
|
|
|
|
def max_concurrent_uploads() -> int:
|
|
return _int_env("MAX_CONCURRENT_UPLOADS", 8)
|
|
|
|
|
|
def upload_idle_timeout_seconds() -> int:
|
|
return _int_env("UPLOAD_IDLE_TIMEOUT_SECONDS", 10)
|
|
|
|
|
|
def upload_deadline_seconds() -> int:
|
|
return _int_env("UPLOAD_DEADLINE_SECONDS", 120)
|
|
|
|
|
|
def upload_grace_seconds() -> int:
|
|
value = _int_env("UPLOAD_GRACE_SECONDS", 900)
|
|
if value < 2 * upload_deadline_seconds():
|
|
raise RuntimeError("UPLOAD_GRACE_SECONDS must be >= 2 * UPLOAD_DEADLINE_SECONDS")
|
|
return value
|
|
|
|
|
|
def reconcile_interval_seconds() -> int:
|
|
return _int_env("RECONCILE_INTERVAL_SECONDS", 300, minimum=0)
|
|
|
|
|
|
def shutdown_drain_seconds() -> int:
|
|
# After SIGTERM: readiness 503 but normal requests served, until HAProxy
|
|
# (inter 1s, fall 2) has taken the replica out of rotation.
|
|
return _int_env("SHUTDOWN_DRAIN_SECONDS", 3, minimum=0)
|
|
|
|
|
|
def shutdown_timeout_seconds() -> int:
|
|
# Upper bound for in-flight requests once the listener is closed.
|
|
return _int_env("SHUTDOWN_TIMEOUT_SECONDS", 8)
|
|
|
|
|
|
def spool_dir() -> Path:
|
|
return Path(os.environ.get("UPLOAD_SPOOL_DIR", "/tmp/messenger-spool"))
|