Skip to content

GitHub Actions ​

Scopo ​

Documentare i workflow CI/CD del monorepo: test, build GHCR, deploy Coolify, docs, Node-RED.

Prerequisiti ​

  • Environments GitHub: development, staging, production (production con reviewers).
  • Secrets elencati in secrets-and-variables.

Workflows ​

FileTriggerScopo
ci.ymlPR/push dev|staging|mainLint Python/JS, DocType JSON, compose-validate, gitleaks (repo intero) + grep soft su apps/, patches; verify source=staging se PR→main
test-frappe.ymlPR / callableBench Frappe 16 + MariaDB/Redis + run-tests
build-image.ymlpushTest; build/push GHCR su dev/staging (su main non rebuilda)
deploy-dev.ymldopo build su devWebhook Coolify (skip se secret assente)
deploy-staging.ymldopo build su stagingBackup obbligatorio → deploy Coolify
deploy-production.ymldopo build su mainBackup → verify tree → promote :staging→:main → deploy; rollback webhook on failure
block-dev-to-main.ymlPR → mainSolo base staging consentita
ci-node-red.ymlpath deploy/node-red/**Validate inventory, test, compose, build/promote
deploy-node-red.ymldopo CI Node-REDWebhook COOLIFY_WEBHOOK_NODERED_*
docs.ymlpath docs/vitepress build + COOLIFY_DOCS_WEBHOOK

Path: .github/workflows/.

Pipeline branch ​

feature/* → dev → staging → main

Promozione immagine FactoryOS ​

  1. Build su staging → tag sha-<commit> + :staging.
  2. Deploy staging e validazione.
  3. Merge staging → main con approval.
  4. Verifica uguaglianza alberi Git main e staging.
  5. Promozione manifest OCI staging → main — nessun rebuild.

Stesso schema per immagine Node-RED.

Post-deploy ​

I workflow echo-ano istruzioni per bench migrate, health-check.sh, staging-safety.sh: parte della verifica resta manuale sul server se non automatizzata nel job.

Secret scanning (gitleaks) ​

Job gitleaks in ci.yml (action ufficiale gitleaks/gitleaks-action): scan completo del repository su ogni PR/push verso dev, staging, main. Il job security-check mantiene un grep soft su apps/ come defense-in-depth. Nessun secret reale in repo; token solo in Coolify / GitHub Environments.

Verifica ​

bash
gh run list --limit 10
gh pr checks

Troubleshooting ​

SintomoAzione
Deploy staging fallisce su backupConfigurare BACKUP_WEBHOOK_STAGING
Production bloccataApproval environment + base branch = staging
Docs non aggiornateControllare docs.yml e COOLIFY_DOCS_WEBHOOK

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