ADR-0004: Dokploy Deployment Platform
Status
Accepted (runtime attuale: Coolify; naming path/secret ancora dokploy / DOKPLOY_*)
Context
Ez FactoryOS richiede ambienti isolati stile Odoo.sh: feature/* → dev → staging → main con database, Redis, volumi e variabili separati per ambiente.
ADR-0003 valutava Railway come piattaforma candidata. La decisione operativa è una piattaforma self-hosted su VPS Netcup per Docker Compose, TLS, variabili, volumi e deploy via webhook.
GitHub Actions gestisce CI, build immagini GHCR, promozione tra ambienti, backup pre-deploy, istruzioni migrate/health e rollback.
Decision
Usare una piattaforma di deploy server-side (inizialmente Dokploy; operativo oggi: Coolify su server.ezbit.it) con lo stesso modello:
| Environment | Branch Git | Scopo | Dominio |
|---|---|---|---|
development | dev | Sviluppo integrato / server dev | dev.<dominio> |
staging | staging | Validazione cliente e test migrazioni | staging.<dominio> |
production | main | Produzione | <dominio> |
Sviluppo locale resta su Docker Compose + Makefile (make up).
Stack server basato su compose vendorizzato da frappe/frappe_docker con immagine custom ghcr.io/<org>/ez-factoryos.
Production promuove la stessa immagine validata in staging tramite digest SHA256, senza rebuild.
Consequences
- Railway non è più il target operativo (ADR-0003 superseded).
- Struttura
deploy/unica fonte per compose, Docker, env e template. - Secrets solo in GitHub Environments e Coolify, mai nel repository.
- Coolify gestisce proxy/TLS; il compose espone
frontend:8080. - Backup pre-deploy obbligatori per staging e production.
- Staging:
scripts/staging-safety.sh(email/webhook/BC); OT writes off su Node-RED. - Naming legacy
DOKPLOY_*/ cartelladeploy/dokploy/conservato per continuità CI.
