OPS66 — deploy: migrate antes do build do runner (deadlock de migrations em caminho estático) #82

Merged

fsolla merged 2 commits from OPS66-ops66-deploy-build-de-geracao-estatica-le-schema-novo- into main

2026-08-19 13:14:18 +00:00

fsolla commented

2026-08-19 13:10:01 +00:00

Owner

Closes #68 (OPS66)

Deadlock de migrations em caminho estático: o deploy buildava o runner antes do migrate; uma migration que cria tabela lida em geração estática (S2) fazia o build falhar para sempre e o migrate nunca rodar.

Fix: reordenação de fases no scripts/deploy-homeserver.sh — migrator (não roda next build, builda contra schema antigo) → push/tag → swap do compose (backup + trap) → migrate via compose run teqo-1313-migrate (caminho canônico, imagem nova) → build do runner contra o banco já migrado → rollout/healthcheck/smoke.

tests/unit/deployScript.unit.spec.ts: pin de ordem completo (migrator < swap < migrate < runner build < rollout) + invariante do Dockerfile (estágio migrator nunca roda next build)
Runbook docs/ops/teqo-1313-deploy.md: fluxo, caveat de rollback, falha conhecida nova (relation ... does not exist)
Comentário no Dockerfile + precisão em AGENTS.md; changelog OPS44 (docs/changelog/2026-08-19-ops66.md)

Gate local verde: lint + typecheck + 2392 unit + 791 int.

**Closes #68 (OPS66)** Deadlock de migrations em caminho estático: o deploy buildava o runner **antes** do migrate; uma migration que cria tabela lida em geração estática (S2) fazia o build falhar para sempre e o migrate nunca rodar. **Fix:** reordenação de fases no `scripts/deploy-homeserver.sh` — migrator (não roda `next build`, builda contra schema antigo) → push/tag → swap do compose (backup + trap) → **migrate** via `compose run teqo-1313-migrate` (caminho canônico, imagem nova) → **build do runner** contra o banco já migrado → rollout/healthcheck/smoke. - `tests/unit/deployScript.unit.spec.ts`: pin de ordem completo (migrator < swap < migrate < runner build < rollout) + invariante do Dockerfile (estágio migrator nunca roda `next build`) - Runbook `docs/ops/teqo-1313-deploy.md`: fluxo, caveat de rollback, falha conhecida nova (`relation ... does not exist`) - Comentário no Dockerfile + precisão em AGENTS.md; changelog OPS44 (`docs/changelog/2026-08-19-ops66.md`) Gate local verde: lint + typecheck + 2392 unit + 791 int.

fsolla added 2 commits 2026-08-19 13:10:01 +00:00