Decisões
ORG-0022 — Backup e restauração
- Status: aceita
- Data: 2026-10-18
- Decide: todo dado de produção tem backup diário, e toda restauração é testada fora da produção
Contexto
Um backup que nunca foi restaurado é uma suposição. E a restauração feita pela primeira vez no dia do problema costuma encontrar o que ninguém previu: versão de ferramenta incompatível, dump que não carrega por cima do banco existente.
Decisão
- Todo armazenamento com dados de produção tem um accessory de backup no
deploy.ymlda aplicação dona. - Agenda diária; retenção de 7 dias, 4 semanas e 6 meses, num volume da VPS.
- A ferramenta de backup usa a mesma versão maior do servidor.
- A restauração é um script versionado (
eng/backup/) que confere o arquivo, exige--confirmar, apaga e recria o destino antes de carregar e falha cedo. - A restauração é testada fora da produção antes de cada subida de versão maior do armazenamento e periodicamente; o roteiro (parar as aplicações, restaurar, subir a dona do schema, subir as demais) está no guia.
- A ferramenta para cada armazenamento fica numa ADR da stack (a ADR-0010 pré-escrita).
Alternativas consideradas
| Alternativa | Por que não |
|---|---|
| Só o snapshot da VPS | Por que não: restaura a máquina inteira, não um banco num ponto; não se testa localmente |
| Restauração manual, sem script | Por que não: cada vez de um jeito, no pior dia |
Consequências
- Escolher um armazenamento novo inclui escolher e testar o seu backup.
- A cópia externa dos backups é decisão da plataforma.
Mais
O detalhe está na documentação da arquitetura.