Backup e restore
Scopo
Procedure di backup DB + file site e limiti per ambiente.
Prerequisiti
- Development: Docker up,
makedisponibile. - Staging/prod: accesso server/Coolify; webhook backup in CI.
Script
| Script | Uso |
|---|---|
scripts/backup.sh | Dump MySQL + bench backup (pieno in development; su staging/prod messaggio operativo server) |
scripts/restore.sh | Restore da BACKUP_ID — solo development nello script attuale |
scripts/s3-upload.sh | Upload S3-compatibile (richiede aws CLI + env S3) |
make backup / make restore | Wrapper locali |
Procedura — Development
bash
make backup
# Output: backups/development/<timestamp>/
BACKUP_ID=<timestamp> make restoreContenuto tipico: database.sql, bench-backups/, manifest.json.
Procedura — Staging / Production
- Preferire webhook pre-deploy (
BACKUP_WEBHOOK_*) da GitHub Actions. - Backup manuale sul server secondo runbook host (compose +
ENV_FILEdell’ambiente). - Restore staging/prod: procedura controllata (non usare
restore.shlocale contro prod). Allineare immagine Docker e schema — vedi rollback.
Esempio invocazione documentata per operatori (adattare path/site sul server):
bash
EZ_ENV=staging COMPOSE_FILE=deploy/compose/staging.yml \
ENV_FILE=deploy/env/.env.staging bash scripts/backup.shS3 (operatività parziale)
Env: S3_ENDPOINT, S3_BUCKET, S3_REGION, S3_ACCESS_KEY_ID, S3_SECRET_ACCESS_KEY.
Frequenza consigliata: production daily DB + weekly full; staging prima di deploy critici; development prima di make reset.
Verify backup → staging (Control)
Implementato in deploy/control/app/backup_manager.py (verify_backup_on_staging):
- Sorgente: backup
oksu main o staging (mai restore verify su main come target). - Pre-backup automatico di staging (come restore standard).
- Restore + migrate + staging-safety su staging.
- Ping HTTP
WEB_URL_STAGING. - Endpoint admin:
POST /api/envs/{main|staging}/backups/{backup_id}/verify(headerX-Control-Token). - Cron settimanale (domenica 04:15 Europe/Rome) sul backup più recente main→staging; skip se lock staging attivo. UI Control invariata.
Verifica
- Esiste
manifest.jsone dump non vuoto. - Dopo restore locale:
curlping + login Desk. - Dopo verify Control: audit
backup.verifyok + site staging risponde.
Rollback
Backup pre-deploy obbligatorio prima di ogni promote production. Non eliminare volumi durante restore di emergenza senza conferma. Disabilitare cron verify: rimuovere job backup-verify-weekly da main.py e redeploy Control — non toccare main.
