Skip to content

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:

EnvironmentBranch GitScopoDominio
developmentdevSviluppo integrato / server devdev.<dominio>
stagingstagingValidazione cliente e test migrazionistaging.<dominio>
productionmainProduzione<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_* / cartella deploy/dokploy/ conservato per continuità CI.

References ​

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