EvoBGP/docs/production-checklist.md

Production checklist

Краткий чеклист перед выводом EvoBGP в production (10+ клиентов, нестабильная сеть).

Обязательно

• EVOBGP_PRODUCTION=1 (или EVOBGP_ENV=production) — при старте API/evobgp-all процесс откажется стартовать, если нарушены жёсткие требования ниже (config.ValidateProductionEnforce).
• EVOBGP_SEED_DEMO=0 — отключить demo-tenant и токен Bearer dev.
• EVOBGP_DEV_INSECURE не задавать или 0 — не использовать lab-флаги в prod.
• EVOBGP_BUNDLE_SEED_HEX — задать стабильный hex-ключ подписи бандлов; сохранить pubkey для нод.
• PostgreSQL с TLS (sslmode не disable) при доступе вне private network.
• EVOBGP_CORS_ORIGINS — явный whitelist origin веб-панели.
• EVOBGP_STALE_ON_UPSTREAM_ERROR=1 (по умолчанию) — stale snapshot при сбоях CDN/ASN/DoH.
• Опционально EVOBGP_CDN_PARTIAL_OK=1 — при сбое одного CDN source без stale cache продолжать refresh остальных (иначе fail модуля).

Рекомендуется

• EVOBGP_JOB_MAX_CONCURRENT=16, EVOBGP_DB_MAX_CONNS=25, EVOBGP_COLLECT_CONCURRENCY=16 при росте tenants.
• EVOBGP_NODE_DISPATCH_INSECURE_TLS=0 — только валидный TLS к agent.
• Ограничить /metrics: EVOBGP_METRICS_TOKEN (Bearer) и/или сетевая политика / reverse proxy.
• EVOBGP_AUTH_RATE_LIMIT (default 60/min per IP) на GET /v1/auth/config.
• HTTP_PROXY / HTTPS_PROXY / NO_PROXY для CDN/DoH в censored сетях.
• Опционально EVOBGP_OTEL_ENDPOINT (stub opt-in для будущего OTel export).
• Профиль evobgp-all или HA API + персистентная job_audit (PostgreSQL SKIP LOCKED reclaim).
• E2E smoke: pnpm --filter @evobgp/web run test:e2e против API (EVOBGP_E2E_API_URL) / UI (EVOBGP_E2E_UI=1).
• Мониторинг drift: evobgp-deploy, last_applied_revision_id vs published.

Не использовать в prod

• EVOBGP_CDN_ALLOW_PRIVATE=1 — только тесты/lab.
• Plaintext EVOBGP_API_KEYS без ротации (break-glass — временно).
• Ручное редактирование evobgp_*.conf на нодах без ревизии.