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¶
- Instale a plataforma com a mesma
QV_MASTER_KEY(no.env, inventário/vault ou Secret). As senhas dos bancos podem ser diferentes. - Suba os serviços e rode a restauração.
- 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(...).