Pular para conteúdo

Backup e restauração

O que precisa de backup

Dado Onde Método
inventário, configuração, usuários, achados, auditoria PostgreSQL (postgres-data) pg_dump -Fc
métricas, rollups, histórico de saúde ClickHouse (clickhouse-data) BACKUP DATABASE qv (nativo) ou ALTER TABLE … FREEZE
master.key/jwt.secret (se não vierem do .env), diretório de automação volume quantix-data tar
segredos (.env) host cofre de senhas, fora do servidor (o backup não inclui)
buffer do barramento nats-data não precisa (transitório)

Host único (compose)

make backup                                  # → backups/AAAAMMDD-HHMMSS/
make restore FROM=backups/20261014-023000    # pede confirmação

deploy/scripts/quantix-backup.sh [-d dir_instalação] [-o dir_backup] [-r dias] [-m native|freeze] grava em cada diretório:

Arquivo Conteúdo
postgres.dump pg_dump -Fc -Z 6
clickhouse-qv.zip BACKUP DATABASE qv TO Disk('backups', 'qv-<ts>.zip') (método native, padrão)
clickhouse-freeze.tar partes congeladas + metadados (método freeze)
quantix-data.tgz volume /var/lib/quantix
MANIFEST, SHA256SUMS inventário e integridade

Retenção local: QV_BACKUP_RETENTION_DAYS (14). Em caso de erro, o diretório parcial é removido.

quantix-restore.sh -b <dir> [-d dir_instalação] [-y] restaura PostgreSQL (recria o banco), ClickHouse (backup nativo) e quantix-data. Backups freeze são restaurados manualmente: copie shadow/<nome>/store/... para detached/ de cada tabela e execute ALTER TABLE qv.<t> ATTACH PARTITION ….

Ansible

site.yml agenda o backup diário às 02:30 (cron, log em /var/log/quantix-backup.log). Sob demanda:

ansible-playbook backup.yml [-e quantix_backup_fetch_dir=./backups] [-e quantix_backup_clickhouse_method=freeze]
ansible-playbook restore.yml -e quantix_restore_confirm=sim [-e quantix_restore_from=AAAAMMDD-HHMMSS] [-e quantix_restore_upload_src=./backups/AAAAMMDD-HHMMSS]

Restauração em servidor novo

  1. Instale a plataforma com a mesma QV_MASTER_KEY (no .env, inventário/vault ou Secret). As senhas dos bancos podem ser diferentes.
  2. Suba os serviços e rode a restauração.
  3. Confira /api/health, o login e se os dispositivos voltam a coletar.

Tamanho

Proporcional aos dados: o backup nativo do ClickHouse tem aproximadamente o tamanho em disco das tabelas (dados já comprimidos), ou seja, de centenas de GB a alguns TB no porte grande conforme a retenção (disco). O PostgreSQL fica em poucos GB. Prefira um destino NFS/S3 montado em quantix_backup_dir. Em cluster ClickHouse, use BACKUP DATABASE qv_local ON CLUSTER qv_cluster TO S3(...).