Skip to content

Rollback ​

Scopo ​

Ripristinare coerenza tra immagine Docker, database e file site dopo un deploy fallito o una regressione.

Prerequisiti ​

  • Backup pre-deploy identificato (BACKUP_ID / artifact webhook).
  • Digest o tag immagine precedente noto.
  • Accesso Coolify / compose dell’ambiente target.

Quando eseguire ​

  • Health check fallito post-deploy
  • Errori bench migrate
  • Regressioni funzionali su staging/production

Procedura ​

1. Immagine ​

  • Staging: redeploy tag/sha-* precedente su Coolify.
  • Production: usare digest validato precedente (nessun rebuild):
text
ghcr.io/<org>/ez-factoryos@sha256:<previous-digest>

Opzionale: ROLLBACK_WEBHOOK_PRODUCTION da deploy-production.yml on failure.

2. Database e file ​

Ripristinare il backup pre-deploy sull’ambiente target (runbook server).
In development: BACKUP_ID=<id> make restore.

Allineare sempre versione immagine ↔ schema migrato.

3. Verifica ​

bash
EZ_ENV=staging HEALTH_URL=https://staging-factoryos.ezbit.it/api/method/ping \
  bash scripts/health-check.sh

Login Desk, smoke moduli critici (Work Order, Machine Connection Profile).

Checklist ​

  • [ ] Backup pre-deploy identificato
  • [ ] Digest/tag precedente noto
  • [ ] Restore DB + file completati
  • [ ] Health check OK
  • [ ] Migrazioni coerenti con l’immagine
  • [ ] Node-RED: se necessario, tag precedente + OT_WRITES_ENABLED=0

CloudBeaver / Control ​

  • Stop servizio Coolify CloudBeaver se UI DB non necessaria; Control resta operativo.
  • Revert URL: CLOUDBEAVER_URL / Traefik Host al valore precedente solo se DNS/TLS regressivo.
  • Volume ez-factoryos-cloudbeaver-workspace: non cancellare senza conferma esplicita.

Vietato senza conferma ​

  • docker volume rm, docker system prune -a, DROP DATABASE, reset dati produzione.

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