Ir para o conteúdo

Roteiro: Gerar, baixar e excluir backups do banco

Perfil necessário: admin (página restrita a admin) Menus usados: Sistema Risco: médio — backup é sua rede de segurança antes de qualquer mudança estrutural; excluir o único backup recente remove a rede Rollback: não aplicável (a operação é sobre os próprios arquivos de backup; para reverter o banco, restaure o .tar.gz via mysql)

Pré-requisitos

  • [ ] mysqldump disponível no host do backend (senão a geração falha com "Comando mysqldump não encontrado")
  • [ ] Espaço em disco no diretório de backups configurado (backup_dir do backend)
  • [ ] Saber que a retenção automática mantém os backup_retention arquivos mais recentes — gerar pode excluir os mais antigos

O que o backup contém

Cada arquivo iproute_sw_AAAAMMDD_HHMMSS_<usuario>.tar.gz traz os dumps dos dois bancos do produto (core e aplicação, ex.: iproute_sw_core.sql e iproute_sw.sql), gerados com --single-transaction --routines --events --triggers, mais um manifest.json (data, autor, bancos incluídos). A listagem mostra SHA-256 de integridade (hash completo no tooltip).

Quando gerar

  • Antes de rodar migrations ou edits manuais de schema (mysql direto)
  • Antes de operações em massa via UI (import de carriers, sync grande de perfis, exclusões em lote)
  • Antes de updates de deploy (scripts/update_sw.sh aplica migrations com tracking — backup antes é barato)
  • Rotina periódica acordada com a operação (ex.: diária antes da janela de manutenção)

Passo a passo

1. Abrir a página

Caminho: Plataforma → Sistema → Backups

Página Backups com o botão Gerar backup destacado

A listagem mostra: Arquivo, Criado por, Data, Tamanho e SHA-256 (abreviado).

2. Gerar o backup

Clique: [Gerar backup]

Resultado esperado: toast "Backup criado com sucesso" e o novo .tar.gz no topo da listagem (ordenado por data, mais recente primeiro). Se a retenção excluir arquivos antigos, o log de auditoria registra deleted_by_retention.

3. Baixar uma cópia

Clique: botão [Baixar] (ícone de download na linha)

Resultado esperado: download do arquivo no navegador (toast "Download iniciado"). O header da resposta traz X-Backup-Sha256 para conferir a integridade fora do painel. Download e exclusão ficam registrados na auditoria de admin.

4. Excluir um backup

Clique: botão [Excluir] (ícone de lixeira na linha)

Resultado esperado: diálogo de confirmação Excluir backup "<arquivo>"? — confirme e o arquivo (e seu .meta.json) desaparece da listagem.

Validação

  • [ ] Visual: arquivo novo no topo da tabela com tamanho coerente (não 0 B)
  • [ ] Funcional: sha256sum <arquivo> no host bate com o SHA-256 exibido; tar contém os dois dumps (tar -tzf iproute_sw_*.tar.gz)

Erros comuns

Sintoma Causa provável Correção
"Comando mysqldump não encontrado no sistema" mysqldump ausente no host do backend instalar client MariaDB/MySQL no host
Falha ao gerar backup (500) credenciais/permissões de DB ou espaço em disco ver detalhe do erro no toast/log do backend
Backup antigo sumiu da listagem retenção automática (backup_retention) aumentar retenção na config do backend ou copiar fora antes
Botão de backup desabilitado/403 usuário não-admin operar com perfil admin

Tabela de referência rápida

Ação Botão Efeito
Gerar dump dos 2 bancos + manifest [Gerar backup] cria iproute_sw_<ts>_<user>.tar.gz + meta (sha256)
Baixar ícone de download na linha download com X-Backup-Sha256
Excluir ícone de lixeira na linha remove arquivo + meta (com confirmação)