Skip to content

Setup deploy server (Coolify) ​

Scopo ​

Configurare ambienti staging/production su Coolify (VPS Netcup server.ezbit.it) con pipeline GitHub stile Dokploy/Odoo.sh.

Nota: path e secret DOKPLOY_* sono legacy di naming; il runtime è Coolify. ADR: 0004.

Prerequisiti ​

  • Coolify operativo; porte pubbliche solo 22/80/443.
  • Registry GHCR accessibile.
  • Secrets: DOKPLOY_WEBHOOK_*, COOLIFY_DEPLOY_TOKEN, BACKUP_WEBHOOK_*.
  • Domini DNS verso il proxy Coolify.

Branch e domini ​

feature/* → dev (locale) → staging → main
BranchDeployDominio
localemake uplocalhost:8001
stagingCoolify + tag :stagingstaging-factoryos.ezbit.it
mainCoolify + tag :main (promosso)factoryos.ezbit.it

Procedura — servizio FactoryOS ​

  1. Progetto Coolify ez-factoryos, ambienti staging e production.
  2. Resource Docker Compose: usare manifest generati deploy/compose/coolify.{staging,production}.yml (label Traefik hardcoded; Coolify non interpola ${VAR} nelle label).
  3. Generazione: python3 deploy/compose/generate-coolify-compose.py.
  4. Variabili da template deploy/env/.env.{staging,production}.example (mai in git): SITE_NAME, SECRET_KEY, DB_*, CUSTOM_IMAGE, CUSTOM_TAG, WEB_URL, CORS_ALLOWED_ORIGINS, NODE_RED_*, …
  5. Non duplicare Nginx/Caddy/Traefik: proxy HTTPS = Coolify.
  6. Volumi persistenti: sites, db-data (più i volumi redis definiti nel compose server).
  7. Collegare webhook deploy agli Environment GitHub staging / production.

Dettaglio template: deploy/dokploy/README.md.

Procedura — Node-RED ​

Servizi Compose custom (non one-click): vedi deploy/node-red/COOLIFY.md.
Hostname node-red-staging / node-red-production sulla rete coolify. Nessuna porta OT pubblica.

GitHub Actions (sintesi) ​

WorkflowAzione
build-image.ymlTest + push GHCR su dev/staging
deploy-staging.ymlBackup webhook → deploy Coolify
deploy-production.ymlBackup → verify tree → promote OCI → deploy
docs.ymlBuild VitePress + webhook docs

Verifica ​

bash
curl -fsS https://staging-factoryos.ezbit.it/api/method/ping
curl -fsS https://factoryos.ezbit.it/api/method/ping
# atteso: {"message":"pong"}

Post-deploy manuale tipico: bench migrate (se non già via configurator), scripts/health-check.sh, su staging scripts/staging-safety.sh.

Rollback / Troubleshooting ​

  • Immagine precedente / digest: rollback.
  • Webhook 401: verificare COOLIFY_DEPLOY_TOKEN.
  • Traefik 404: ricontrollare label nel compose Coolify (rigenerare manifest).

Riferimenti community Frappe ​

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