Skip to content

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-production attivi; creare ez-factoryos-development (vedi sotto) per la tab dev reale.
  • Secret Coolify per il servizio control (da .env.example, generare con openssl rand -hex 32): CONTROL_ADMIN_TOKEN, CONTROL_BASIC_PASSWORD, COOLIFY_TOKEN, GITHUB_TOKEN (scope repo, workflow).
  • Chiave SSH dedicata: pubblica in /root/.ssh/authorized_keys sul VPS, privata come secret Coolify montato in /run/secrets/ssh_key.
  • Record DNS control.factoryos.ezbit.it verso 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).

  1. Coolify → progetto Ez FactoryOS → nuova applicazione private-deploy-keyez-factoryos-control (riusa deploy key coolify-ez-factoryos-docs).
  2. Env da deploy/control/.env.example (mai segreti in repo).
  3. Storage: persistent /backups + /data, file /run/secrets/ssh_key (aggiungere newline finale + chown 1000:1000, chmod 600 sul file host).
  4. Deploy, verificare https://control.factoryos.ezbit.it/health → {"status":"ok"}.
  5. Login Basic + inserire X-Control-Token nel campo in alto per le azioni.

Note operative:

  • COOLIFY_BASE_URL=http://coolify:8080 (stessa rete Docker), token API dedicato ez-factoryos-control con abilità *.
  • SSH_HOST=10.0.1.1 (gateway rete coolify; host.docker.internal non risolve nei container app).
  • Dockerfile su Python 3.13: pydantic-core non ha wheel per 3.14.
  • dockerfile_location deve essere /Dockerfile (relativo a base directory).

2. Creare ez-factoryos-development (se assente su Coolify) ​

  1. Coolify → nuovo servizio compose custom ez-factoryos-development.
  2. Incollare deploy/compose/coolify.development.yml (uuid placeholder).
  3. Env da deploy/env/.env.development.server.example con segreti reali.
  4. Deploy, copiare lo uuid reale del servizio.
  5. Aggiornare generate-coolify-compose.py (COOLIFY_DEV_SERVICE_UUID), rigenerare, aggiornare COOLIFY_UUID_DEV nel 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 opzionale CONTROL_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 PR poi Merge (solo se checks verdi); richiede GITHUB_TOKEN con scope repo + 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 config in locale.
  • Home control: 3 tab con blocchi coerenti con Coolify.
  • GET /api/envs/staging/status → overall_level valorizzato.
  • Backup dev di prova → manifest + riga storico → restore su staging → site up + bench migrate ok.
  • PR dev → staging dal pannello → checks → merge → deploy Coolify automatico.

CloudBeaver ​

  • Compose: deploy/cloudbeaver/coolify.yml — Host Traefik db.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 revert CLOUDBEAVER_URL su 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 o docker logs.
  • COOLIFY_TOKEN 401: rigenerare token Coolify, aggiornare env, redeploy.
  • SSH fallito: verificare secret montato e chiave pubblica sul VPS.
  • Restore fallito: rieseguire restore del pre_backup_id salvato nello storico; ogni restore/rebuild crea pre-backup automatico.
  • Rebuild staging bloccato su lock: GET /api/audit per attore/reason, attendere fine operazione (lock rilasciato a fine job).
  • Push diretto vietato: la promozione usa solo PR dev → staging e staging → main; dev → main è bloccato come da workflow block-dev-to-main.yml.

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