backupally restore

Restaura backups a partir de snapshots armazenados.

Sintaxe

backupally restore --target <TASK_ID> --snapshot <SNAPSHOT_ID> [OPÇÕES]

Opções

Opção Descrição Padrão
--target <ID> ID da task original Obrigatório
--snapshot <ID> ID do snapshot a restaurar Obrigatório
--path <PATH> Diretório de destino Obrigatório
--config <PATH> Caminho da configuração /etc/backupally/config.toml
--key <PATH> Chave para descriptografar Chave padrão
--verify Apenas verificar integridade false
--dry-run Simular sem restaurar false

Exemplos

Restaurar MySQL

backupally restore \
  --target mysql-prod \
  --snapshot snap_20260211_030000 \
  --path /restore/mysql

Restaurar com Chave Específica

backupally restore \
  --target mysql-prod \
  --snapshot snap_20260211_030000 \
  --path /restore/mysql \
  --key /etc/backupally/keys/old-key.pem

Verificar Integridade

backupally restore \
  --target mysql-prod \
  --snapshot snap_20260211_030000 \
  --verify

Simulação (Dry Run)

backupally restore \
  --target mysql-prod \
  --snapshot snap_20260211_030000 \
  --path /restore/mysql \
  --dry-run

Listar Snapshots Disponíveis

Para ver os snapshots disponíveis para uma task:

backupally history --target mysql-prod

Saída:

SNAPSHOT                  DATE                 SIZE      STATUS
snap_20260211_030000      2026-02-11 03:00:00  890 MB    OK
snap_20260210_030000      2026-02-10 03:00:00  885 MB    OK
snap_20260209_030000      2026-02-09 03:00:00  882 MB    OK

Processo de Restauração

1. Download

Baixa o arquivo do storage configurado.

2. Verificação

Valida checksum e integridade do arquivo.

3. Descriptografia

Descriptografa usando a chave RSA/AES.

4. Descompressão

Descomprime com o algoritmo original (zstd, gzip, lz4).

5. Extração

Extrai arquivos para o diretório de destino.

Restauração de Databases

MySQL

Após restaurar, importe o dump:

backupally restore --target mysql-prod --snapshot snap_20260211_030000 --path /restore/

mysql -u root -p < /restore/mysql-prod/dump.sql

PostgreSQL

backupally restore --target postgres-prod --snapshot snap_20260211_030000 --path /restore/

psql -U postgres -f /restore/postgres-prod/dump.sql

MongoDB

backupally restore --target mongodb-prod --snapshot snap_20260211_030000 --path /restore/

mongorestore /restore/mongodb-prod/

Códigos de Saída

Código Significado
0 Sucesso
1 Snapshot não encontrado
2 Erro de download
3 Erro de descriptografia (chave inválida)
4 Erro de integridade
5 Erro de extração

Notas

  • Mantenha backup das chaves de criptografia
  • Use --verify periodicamente para validar backups
  • O key fingerprint no arquivo indica qual chave usar
By Borlot.com.br on 11/02/2026