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.shLogin 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.
