3.3 KiB
OPS103 — Staging no homeserver com verify único e aprovações separadas (2026-09-12): o repo ganhou um alvo real e descartável entre o banco mínimo do CI e a produção. Um único workflow_dispatch do deploy.yml roda o verify (hosted, suíte full incl. e2e — intocado: verifica o commit, não o alvo) uma vez e gateia três jobs: verify → deploy-staging (environment: staging, sem reviewer; TEQO_ENV=staging) → deploy-production (needs: [deploy-staging], environment: production com required reviewer — staging vermelho nunca deixa produção rodar; TEQO_ENV=production). Os dois deploys rodam no runner self-hosted do homeserver e executam o mesmo scripts/deploy-homeserver.sh, agora parametrizado por TEQO_ENV (mapa no topo; produção default byte-for-byte a de antes: teqo-1313/teqo-1313-migrate/~/stack/teqo-1313.env/127.0.0.1:1313/localhost:5000/teqo-1313(-migrator):$SHA; staging: teqo-staging/teqo-staging-migrate/~/stack/teqo-staging.env/127.0.0.1:1314/bucket teqo-media-staging/proxy de build próprio; TEQO_ENV inválido fail-closed, mapa readonly contra retargeting pelos env files). Sem script gêmeo: o sed de imagens é ancorado ao repo do ambiente e o label org.opencontainers.image.revision passa a ser trocado por range do bloco do serviço (um replace global carimbaria o SHA de um ambiente no serviço do outro e o guard "already deployed" leria revision mentirosa); a ordem migrator→migrate→runner (OPS66), o rollback por ambiente, o healthcheck e o smoke (http://localhost:1314 no staging) seguem idênticos. Os dois deploys compartilham o compose/workspace/registry do homeserver, então entram no mesmo concurrency: deploy-homeserver (cancel-in-progress: false, queue: max — o default de fila cancelaria um pending a cada dispatch novo) e num único flock compartilhado (locks por ambiente deixariam staging e produção buildar/swapar concorrentemente; o lock também cobre invocação manual, que não passa pelo concurrency). Staging é noindex no repo (src/lib/siteEnvironment.ts + src/app/robots.ts + metadata do layout — hostname staging. desliga index em qualquer alvo) e usa seed sintético, nunca PII. Pins: tests/unit/deployScript.unit.spec.ts (defaults de produção + mapa de staging + sed ancorado + único exit 0; a ordem OPS66 passou a ancorar em --profile maintenance run --rm/último up -d), tests/unit/ciSkipInvariants.unit.spec.ts (os três jobs, environments, needs, guard main, concurrency) e tests/unit/siteEnvironment.unit.spec.ts (predicado + wiring do noindex). Docs vivos: runbook docs/ops/teqo-1313-deploy.md (fluxo, tabela staging×produção, bootstrap manual do homeserver — DB, env file, serviços no compose, bucket, tunnel/DNS, environments e migrate+seed — e limites explícitos: WebAuthn/OAuth/Resend/e2e não são validados), docs/AGENT-OPS.md (ladder de ambientes e workflow), AGENTS.md/AGENTS-infra.md e .env.example (bucket teqo-media-staging). Sem migration, sem UI, sem access/Consent. Verificação: pnpm gate:fast verde (unit 292 arquivos/2810 testes); e2e local da mesma superfície (frontend, 25 testes) verde; /robots.txt confirmado no build (rota estática). Aceite final humano pós-merge: bootstrap ops no homeserver + dispatch real (staging verde → inspeção → aprovação → produção no mesmo SHA).