Pannello control.factoryos.ezbit.it
Stato: Implementato (microservizio deploy/control/).
Scopo
Cruscotto stile odoo.sh + Railway per i tre ambienti Ez FactoryOS (dev, staging, main): stato container/servizi a blocchi, backup/restore con storico, promozione via PR GitHub con un click, rebuild staging da dev o main. La CI/CD esistente resta invariata: il pannello orchestra, non sostituisce.
Prerequisiti
- Servizi Coolify
ez-factoryos-staging,ez-factoryos-productionattivi; creareez-factoryos-development(vedi sotto) per la tab dev reale. - Secret Coolify per il servizio control (da
.env.example, generare conopenssl rand -hex 32):CONTROL_ADMIN_TOKEN,CONTROL_BASIC_PASSWORD,COOLIFY_TOKEN,GITHUB_TOKEN(scoperepo,workflow). - Chiave SSH dedicata: pubblica in
/root/.ssh/authorized_keyssul VPS, privata come secret Coolify montato in/run/secrets/ssh_key. - Record DNS
control.factoryos.ezbit.itverso il VPS; porte pubbliche solo 22, 80, 443.
Procedura
1. Deploy servizio control
Stato deploy: attivo dal 2026-09-25 come applicazione Coolify ez-factoryos-control (uuid e13aofbobgvoildjej56tx1x, branch dev, build pack dockerfile, base /deploy/control).
- Coolify → progetto Ez FactoryOS → nuova applicazione
private-deploy-keyez-factoryos-control(riusa deploy keycoolify-ez-factoryos-docs). - Env da
deploy/control/.env.example(mai segreti in repo). - Storage: persistent
/backups+/data, file/run/secrets/ssh_key(aggiungere newline finale +chown 1000:1000, chmod 600sul file host). - Deploy, verificare
https://control.factoryos.ezbit.it/health→{"status":"ok"}. - Login Basic + inserire
X-Control-Tokennel campo in alto per le azioni.
Note operative:
COOLIFY_BASE_URL=http://coolify:8080(stessa rete Docker), token API dedicatoez-factoryos-controlcon abilità*.SSH_HOST=10.0.1.1(gateway retecoolify;host.docker.internalnon risolve nei container app).- Dockerfile su Python 3.13:
pydantic-corenon ha wheel per 3.14. dockerfile_locationdeve essere/Dockerfile(relativo a base directory).
2. Creare ez-factoryos-development (se assente su Coolify)
- Coolify → nuovo servizio compose custom
ez-factoryos-development. - Incollare
deploy/compose/coolify.development.yml(uuid placeholder). - Env da
deploy/env/.env.development.server.examplecon segreti reali. - Deploy, copiare lo uuid reale del servizio.
- Aggiornare
generate-coolify-compose.py(COOLIFY_DEV_SERVICE_UUID), rigenerare, aggiornareCOOLIFY_UUID_DEVnel servizio control e redeploy.
3. Uso quotidiano
- Dashboard: badge host (disco % / RAM % via SSH); soglie disco/RAM ≥85% yellow, ≥95% o Coolify
degraded→ red. Webhook opzionaleCONTROL_ALERT_WEBHOOK_URL(POST JSON solo su transizione a red). - Tab ambiente: blocchi verdi/gialli/rossi/grigi per servizio; click per log
- restart singolo container.
- Portali / Accessi: link CloudBeaver su
https://db.factoryos.ezbit.it. - Backup:
+ Crea backup(DB + bench files), storico con manifest, restore con conferma digitando il nome ambiente (pre-backup automatico). Verify (admin token):POST /api/envs/{main|staging}/backups/{id}/verify→ restore su staging + ping HTTP; cron domenicale 04:15 Europe/Rome (UI invariata). - Promuovi:
Crea/Apri PRpoiMerge(solo se checks verdi); richiedeGITHUB_TOKENcon scoperepo+workflow. - Ricrea staging (solo tab staging): seleziona sorgente dev/main, digita
staging, conferma. Passi: pre-backup → redeploy tag → restore → migrate → anonymize + staging-safety. - Simulatori OT: start/stop da tab Simulatori (rete interna, no porte pubbliche).
Verifica
docker compose -f deploy/control/docker-compose.yml configin locale.- Home control: 3 tab con blocchi coerenti con Coolify.
GET /api/envs/staging/status→overall_levelvalorizzato.- Backup dev di prova → manifest + riga storico → restore su staging → site up +
bench migrateok. - PR dev → staging dal pannello → checks → merge → deploy Coolify automatico.
CloudBeaver
- Compose:
deploy/cloudbeaver/coolify.yml— Host Traefikdb.factoryos.ezbit.it, reti private FactoryOS (dev/staging/main) +coolify. - Env Coolify:
CB_SERVER_URL,SERVICE_FQDN_CLOUDBEAVER,CB_ADMIN_PASSWORD(mixed case + digit). Nessun secret in repo. - Control:
CLOUDBEAVER_URL=https://db.factoryos.ezbit.it(Portali + Accessi).
Rollback CloudBeaver / simulatori
- CloudBeaver: stop servizio Coolify
ez-factoryos-cloudbeaver(aq1an2iw43cq4hjy00b20zl2); eventualmente revertCLOUDBEAVER_URLsu Control. - Volume workspace CB: eliminare solo con conferma esplicita.
- Simulatori: stop da Control tab Simulatori o stop servizio Coolify correlato; nessun impatto su Frappe se la macchina resta Offline.
Rollback / Troubleshooting
- Pannello guasto: stop servizio
ez-factoryos-control, nessun impatto a staging/prod; log via Coolify odocker logs. COOLIFY_TOKEN401: rigenerare token Coolify, aggiornare env, redeploy.- SSH fallito: verificare secret montato e chiave pubblica sul VPS.
- Restore fallito: rieseguire restore del
pre_backup_idsalvato nello storico; ogni restore/rebuild crea pre-backup automatico. - Rebuild staging bloccato su lock:
GET /api/auditper attore/reason, attendere fine operazione (lock rilasciato a fine job). - Push diretto vietato: la promozione usa solo PR
dev → stagingestaging → main;dev → mainè bloccato come da workflowblock-dev-to-main.yml.
