Pular para o conteúdo principal
REVIEW · v0.1Aguardando aprovação humana. Este documento NÃO é regra vigente — leia como proposta.

Runbook — Rollback das docs

Rollback devolve o site publicado à última versão válida conhecida (última tag docs-v* publicada com PASS). Git preserva tudo; rollback nunca apaga histórico.

Quando fazer rollback​

  • Conteúdo errado/enganoso foi publicado como vigente.
  • Build publicado quebrado (navegação, busca, páginas em branco).
  • Publicação aconteceu sem o gate do runbook de publicação.

Processo​

1. Identificar a última versão válida​

git tag --list "docs-v*" --sort=-creatordate

A última tag publicada com evidência de PASS é o alvo.

2. Rebuildar a versão válida​

git checkout docs-vX.Y
cd site
npm ci
npm run build

3. Republicar o build anterior​

Mesmo passo 4 do runbook de publicação (destino UNKNOWN até a infra ser definida), usando o build/ gerado da tag válida.

4. Voltar ao trabalho​

git checkout main

O erro que motivou o rollback é corrigido em main normalmente (commit novo — nunca reescrever histórico publicado), e uma nova publicação segue o gate padrão.

5. Registrar​

Registrar: o que estava errado, qual tag foi restaurada, quem autorizou, e o follow-up para corrigir em main.

Regra​

Nunca "consertar direto no servidor". O build publicado é sempre derivado de um estado do Git — se o servidor divergir do Git, o Git vence e o servidor é reconstruído.