# backupally restore

Restaura backups a partir de snapshots armazenados.

# Sintaxe

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

# Opções

# Exemplos

# Restaurar MySQL

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

# Restaurar a partir do Storage (sem download manual)

backupally restore \
  --target mysql-prod \
  --snapshot mysql-prod/mysql-prod_20260919_030000.ally \
  --from-storage mysql-prod \
  --path /restore/mysql-novo \
  --force -o json

Ver Restaurar a partir do Storage abaixo para o fluxo completo.

# 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

# Restaurar a partir do Storage (desde 0.35.0)

Fluxo: snapshot → (opcional) download → restore num diretório novo. Até a 0.34.x era preciso baixar com `storage download` e depois apontar --path para o arquivo local. --from-storage faz os dois passos num comando só (feature restore.from_storage em `--capabilities`):

backupally restore \
  --target "mysql-prod" --snapshot <key> \
  --from-storage mysql-prod --path /restore/mysql-novo --force -o json

O download confere o SHA-256 contra artifacts[].sha256 do history antes de extrair — divergente = erro E4004 e nada é restaurado.

# Prática recomendada: restaure num diretório separado

restore --from-storage não recusa diretório existente nem vazio — ele extrai por cima, sobrescrevendo o que já está lá. O comando não protege contra restaurar em cima do original; a proteção é responsabilidade de quem chama:

• use sempre um --path novo, nunca o diretório de onde os dados vieram (ex.: /var/lib/backupally/restore/<task_id>/<timestamp>/, um por restore);
• nunca aponte --path para o diretório de produção nem para um prefixo dele — se o restore falhar no meio, o diretório original fica misturado com o que já foi extraído;
• confira o conteúdo restaurado no diretório separado antes de mover para o lugar final, manualmente.

Os arquivos saem sob --path com o caminho absoluto original do backup (ex.: /restore/mysql-novo/root/dados/a.txt para um backup de /root/dados).

# `restore.execute` (`-o json`)

O temporário restore-<uuid> é apagado em sucesso e em qualquer erro com envelope. Em panic (binário de release roda com panic = 'abort') ele pode sobrar, e cleanup --residues não o reconhece.

# Códigos de erro de `--from-storage`

Reaproveita o enum de erro existente — nenhum código novo:

Ver limitações de segurança para a contenção de path no storage local e a validação de --database.

# 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 registrado no header (zstd ou gzip).

# 5. Extração

Extrai arquivos para o diretório de destino.

Todas as etapas rodam em streaming (0.29.0): o arquivo não é carregado inteiro, não há backup.tar temporário e o tar do sistema não é usado.

# 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

# Notas

• Mantenha backup das chaves de criptografia
• Use --verify periodicamente para validar backups
• O key fingerprint no arquivo indica qual chave usar