.env.example

# =============================================================================
# HPC Workload Optimizer — Environment Configuration
# =============================================================================
# Copy this file to .env and customize values for your deployment.
#
#   cp .env.example .env
#
# For Docker Compose, the .env file is loaded automatically.
# For Kubernetes, mount values via ConfigMap/Secret (see k8s/).
# =============================================================================

# ---------- API Authentication ----------
# Option 1 (recommended): Path to a file containing API keys (one per line)
HPCOPT_API_KEYS_FILE=./secrets/api_keys.txt

# Option 2: Docker/K8s secret mount (auto-detected at /run/secrets/hpcopt_api_keys)
# No env var needed — the app checks this path automatically.

# Option 3 (legacy): Comma-separated API keys directly in env
# HPCOPT_API_KEYS=key1,key2,key3

# ---------- API Server ----------
HPCOPT_HOST=0.0.0.0
HPCOPT_PORT=8080

# ---------- Model Configuration ----------
# Path to the directory containing trained runtime quantile model artifacts
# HPCOPT_RUNTIME_MODEL_DIR=./outputs/models/runtime_latest

# Path to the directory containing trained resource-fit model artifacts
# HPCOPT_RESOURCE_FIT_MODEL_DIR=./outputs/models/resource_fit_latest

# ---------- Rate Limiting ----------
# Requests per minute per API key per endpoint (default: 30 for prod)
# HPCOPT_RATE_LIMIT_PER_MINUTE=30

# ---------- Logging ----------
# Log level: DEBUG, INFO, WARNING, ERROR, CRITICAL
HPCOPT_LOG_LEVEL=INFO

# ---------- Environment ----------
# Environment name for config loading (dev, staging, prod)
# Loads from configs/environments/<env>.yaml
HPCOPT_ENV=dev

# ---------- OpenTelemetry (optional, requires [tracing] extra) ----------
# OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4317
# OTEL_SERVICE_NAME=hpcopt
# OTEL_TRACES_SAMPLER=parentbased_traceidratio
# OTEL_TRACES_SAMPLER_ARG=0.1