Skip to content

Backup e restore ​

Scopo ​

Procedure di backup DB + file site e limiti per ambiente.

Prerequisiti ​

  • Development: Docker up, make disponibile.
  • Staging/prod: accesso server/Coolify; webhook backup in CI.

Script ​

ScriptUso
scripts/backup.shDump MySQL + bench backup (pieno in development; su staging/prod messaggio operativo server)
scripts/restore.shRestore da BACKUP_ID — solo development nello script attuale
scripts/s3-upload.shUpload S3-compatibile (richiede aws CLI + env S3)
make backup / make restoreWrapper locali

Procedura — Development ​

bash
make backup
# Output: backups/development/<timestamp>/
BACKUP_ID=<timestamp> make restore

Contenuto tipico: database.sql, bench-backups/, manifest.json.

Procedura — Staging / Production ​

  1. Preferire webhook pre-deploy (BACKUP_WEBHOOK_*) da GitHub Actions.
  2. Backup manuale sul server secondo runbook host (compose + ENV_FILE dell’ambiente).
  3. Restore staging/prod: procedura controllata (non usare restore.sh locale 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.sh

S3 (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):

  1. Sorgente: backup ok su main o staging (mai restore verify su main come target).
  2. Pre-backup automatico di staging (come restore standard).
  3. Restore + migrate + staging-safety su staging.
  4. Ping HTTP WEB_URL_STAGING.
  5. Endpoint admin: POST /api/envs/{main|staging}/backups/{backup_id}/verify (header X-Control-Token).
  6. Cron settimanale (domenica 04:15 Europe/Rome) sul backup più recente main→staging; skip se lock staging attivo. UI Control invariata.

Verifica ​

  • Esiste manifest.json e dump non vuoto.
  • Dopo restore locale: curl ping + login Desk.
  • Dopo verify Control: audit backup.verify ok + 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.

Ez FactoryOS — MES per Ortobellina / OP Raggio di Sole · App Frappe v16 ez_factoryos