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
| Ambiente | Compose principale | Servizi | Scopo |
|---|---|---|---|
| Development | deploy/compose/development.yml | mariadb, redis, frappe | Hot-reload app |
| Staging / Production | deploy/compose/staging.yml / production.yml → stack server.stack.yml | configurator, backend, frontend, websocket, workers, scheduler, db, redis | Runtime immutabile |
| Coolify | coolify.staging.yml / coolify.production.yml | Come server + label Traefik | Generati 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):
| Servizio | Ruolo | Esposto |
|---|---|---|
configurator | Setup site, migrate, asset (one-shot) | no |
backend | Gunicorn :8000 | no |
frontend | Nginx asset + proxy :8080 | sì (Traefik Coolify) |
websocket | Socket.IO :9000 | sì (/socket.io) |
queue-short / queue-long | Worker RQ | no |
scheduler | Cron bench | no |
db | MariaDB ${MARIADB_VERSION:-11.8} | no |
redis-cache / redis-queue | Redis ${REDIS_VERSION:-8.8}-alpine | no |
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
| Immagine | Dockerfile | Tag |
|---|---|---|
| Dev | Dockerfile.dev | build locale |
| Server | deploy/docker/Dockerfile | ghcr.io/<org>/ez-factoryos:sha-<commit>, :staging, :main |
| Node-RED | sotto 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
| Componente | Versione |
|---|---|
| Frappe | version-16 |
| Python | 3.14.x |
| Node | 24 |
| MariaDB | 11.8 (MARIADB_VERSION, 10.6 su staging/production) |
| Redis | 8.8-alpine (REDIS_VERSION) |
| Bench CLI | 5.31.x (immagine) |
Verifica
make compose-validate
docker compose -f deploy/compose/development.yml --env-file .env configRollback
Redeploy tag/digest precedente; allineare DB con backup — rollback.
