Skip to content

Architettura Docker ​

Scopo ​

Descrivere i compose per development e server (staging/production) e le immagini GHCR.

Prerequisiti ​

  • Conoscere ambientI: locale vs Coolify.
  • Path base: deploy/compose/, deploy/docker/.

Panoramica ambienti ​

AmbienteCompose principaleServiziScopo
Developmentdeploy/compose/development.ymlmariadb, redis, frappeHot-reload app
Staging / Productiondeploy/compose/staging.yml / production.yml → stack server.stack.ymlconfigurator, backend, frontend, websocket, workers, scheduler, db, redisRuntime immutabile
Coolifycoolify.staging.yml / coolify.production.ymlCome server + label TraefikGenerati da generate-coolify-compose.py

Development ​

  • Un container Frappe con bench start.
  • Volume app apps/ez_factoryos.
  • Volumi tipici: MariaDB, Redis, bench data.
  • Dockerfile: deploy/docker/Dockerfile.dev.

Staging / Production ​

Stack multi-servizio (pattern frappe_docker):

ServizioRuoloEsposto
configuratorSetup site, migrate, asset (one-shot)no
backendGunicorn :8000no
frontendNginx asset + proxy :8080sì (Traefik Coolify)
websocketSocket.IO :9000sì (/socket.io)
queue-short / queue-longWorker RQno
schedulerCron benchno
dbMariaDB ${MARIADB_VERSION:-11.8}no
redis-cache / redis-queueRedis ${REDIS_VERSION:-8.8}-alpineno

Il configurator esegue migrate a ogni deploy; backend all'avvio ricopia solo gli asset dell'immagine nel volume sites, che frontend (nginx) serve su /assets.

I volumi staging e production sono stati creati con MariaDB 10.6: sui servizi Coolify è impostato MARIADB_VERSION=10.6. Con 11.8 l'immagine aggiorna i file del database in modo non reversibile (MARIADB_AUTO_UPGRADE=1).

Flusso HTTP: Internet → Coolify Traefik → frontend:8080 → backend:8000.
Volumi: sites, db-data. Rete esterna: coolify.

Node-RED è uno stack Compose separato (deploy/node-red/), non nel compose Frappe.

Immagini ​

ImmagineDockerfileTag
DevDockerfile.devbuild locale
Serverdeploy/docker/Dockerfileghcr.io/<org>/ez-factoryos:sha-<commit>, :staging, :main
Node-REDsotto deploy/node-red/ghcr.io/<org>/ez-factoryos-nodered:...

Nessun tag latest come promozione primaria. Su main l’immagine Frappe/Node-RED è promossa da staging (no rebuild).

Pin versioni ​

ComponenteVersione
Frappeversion-16
Python3.14.x
Node24
MariaDB11.8 (MARIADB_VERSION, 10.6 su staging/production)
Redis8.8-alpine (REDIS_VERSION)
Bench CLI5.31.x (immagine)

Verifica ​

bash
make compose-validate
docker compose -f deploy/compose/development.yml --env-file .env config

Rollback ​

Redeploy tag/digest precedente; allineare DB con backup — rollback.

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