teqo-backup/docs/changelog/2026-08-18-ops62.md
Francisco Solla ee31aeee4f fix(OPS62): services por nome na rede do job — Forgejo 9 não expande expressões em ports
Achado ao vivo (run 730): a expressão ${{ 5433 + (github.run_id % 100) }} no
ports do service não é avaliada pelo Forgejo 9 — o literal ia ao runner e o
job falhava em 1s. E portas fixas colidiriam entre runs concorrentes (o job
único segura os services pelo run inteiro). Correção: services sem publish
host, alcançados por nome na rede do job (postgres-int/postgres-build:5432)
— solução canônica do Actions, mata a colisão de raiz. Guards fail-closed
(LOCAL_HOSTS + assertTestDatabase) admitem os nomes dos services (hosts
internos do runner; hosts remotos continuam rejeitados); pins novos em
localHosts.unit.spec.ts e ciSkipInvariants (sem ports:, URLs por nome).
2026-08-18 23:26:13 +00:00

3.7 KiB
Raw Permalink Blame History

Recently resolved (2026-08-18): OPS62 — fail-fast estrutural do CI: ci-pr.yml e ci.yml deixaram de ter jobs irmãos. Cada workflow agora tem um único job checks sequencial (ci-pr: guards de conteúdo → lint → format → typecheck → knip → cycles → unit → int → build → e2e, com skips do ci-scope.mjs agora como step com outputs; ci.yml: mesma mecânica full + deploy OPS53 intacto), então step vermelho interrompe o job, o run falha e o slot do runner é liberado imediatamente — sem API de cancel (o Forgejo 9.0.3 não tem), sem watchdog, sem upgrade do Forgejo no homeserver (decisão X1 do gate de execução substitui o watchdog+upgrade da intenção; o aceite "API de cancel/upgrade" e "mesmos jobs, mesma cascata" foi revisado pelo humano — o que o CI verifica permanece idêntico, só o envelope muda). Diagnóstico preservado: steps têm logs próprios. O job id checks mantém o contexto CI (PR) / checks que o automerger/waitForChecks e a branch protection esperam (OPS61). Paralelismo do e2e recuperado por PLAYWRIGHT_WORKERS=4 num único processo (substitui os 2 shards × 2 workers; mesma carga); 2 services Postgres por nome na rede do job (postgres-int/postgres-build, sem publish host — o job único seguraria portas fixas pelo run inteiro e runs concorrentes colidiriam; o Forgejo 9 não expande expressões em services.ports, medido ao vivo no run 730 falhando em 1s com a string literal; o DNS da rede do job mata a colisão de raiz — os guards fail-closed LOCAL_HOSTS/assertTestDatabase admitem os nomes dos services, ainda rejeitando hosts remotos) preservam a topologia de hoje (e2e nunca herda resíduo de fixtures do int); 1 checkout + 1 pnpm install por run (antes ~10). Plumbing morto removido: e2eShardConfig e o output e2e_shards do classifier (sem consumidor). Guards de conteúdo movidos para o início do pipeline (falham rápido e são PR-scoped). /simplify (3 reviewers): P1 aplicados — set -euo pipefail no step scope (crash do classifier com outputs vazios silenciaria skips → false green) e services por nome (acima); P2 aplicados — pins de invariantes ancorados em chaves YAML (comentários não satisfazem needs: [checks]/matrix:/fail-fast:), pin do wiring crítico id: scope + if: e2e_mode == 'full' (perdê-lo pula a suíte em silêncio), comentário morto do sharding em playwright.config.ts e docs/TESTING.md corrigidos (ainda citavam .github/workflows e jobs paralelos); P3 — JSDoc do ci-scope.mjs e redação do impl plan; o P2 do waitForChecks (timeout 30 min vs job 50 min) fica como débito de CI anotado no impl. Docs: tabela CI do AGENT-OPS reescrita + linha morta do styfle/cancel-workflow-action (removida no OPS50) apagada. Sem migration/access/Consent/UI. Testes: invariantes novos em ciSkipInvariants.unit.spec.ts (um único job checks, sem matrix:/fail-fast:/runs-on: host no ci-pr, PLAYWRIGHT_WORKERS: 4, guards antes do lint, deploy gated em needs: [checks], services por nome sem ports:); localHosts.unit.spec.ts com os nomes dos services; testAffected.unit.spec.ts sem o describe do shard config. Validação ao vivo na própria entrega: o ci-pr deste PR já é o envelope novo — o primeiro run (730) pegou a expressão de porta não suportada (achado → corrigido para DNS de service), o run verde prova a suíte inteira no job único; a medição do tempo de parede fica registrada no run. Custo aceito (X1): run verde ~21 min esperados (vs ~15–18 com jobs paralelos) e e2e vermelho é o caso mais lento de veredito; débito registrado no impl plan (matrix fail-fast Y) se a fila do runner apertar. Impl: docs/plans/ops62-ci-fail-fast-forgejo-impl.md (a intenção fica como histórico do gate).