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| Branch | Deploy | Dominio |
|---|---|---|
| locale | make up | localhost:8001 |
staging | Coolify + tag :staging | staging-factoryos.ezbit.it |
main | Coolify + tag :main (promosso) | factoryos.ezbit.it |
Procedura — servizio FactoryOS
- Progetto Coolify ez-factoryos, ambienti
stagingeproduction. - Resource Docker Compose: usare manifest generati
deploy/compose/coolify.{staging,production}.yml(label Traefik hardcoded; Coolify non interpola${VAR}nelle label). - Generazione:
python3 deploy/compose/generate-coolify-compose.py. - 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_*, … - Non duplicare Nginx/Caddy/Traefik: proxy HTTPS = Coolify.
- Volumi persistenti:
sites,db-data(più i volumi redis definiti nel compose server). - 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)
| Workflow | Azione |
|---|---|
build-image.yml | Test + push GHCR su dev/staging |
deploy-staging.yml | Backup webhook → deploy Coolify |
deploy-production.yml | Backup → verify tree → promote OCI → deploy |
docs.yml | Build 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).
