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
| File | Trigger | Scopo |
|---|---|---|
ci.yml | PR/push dev|staging|main | Lint Python/JS, DocType JSON, compose-validate, gitleaks (repo intero) + grep soft su apps/, patches; verify source=staging se PR→main |
test-frappe.yml | PR / callable | Bench Frappe 16 + MariaDB/Redis + run-tests |
build-image.yml | push | Test; build/push GHCR su dev/staging (su main non rebuilda) |
deploy-dev.yml | dopo build su dev | Webhook Coolify (skip se secret assente) |
deploy-staging.yml | dopo build su staging | Backup obbligatorio → deploy Coolify |
deploy-production.yml | dopo build su main | Backup → verify tree → promote :staging→:main → deploy; rollback webhook on failure |
block-dev-to-main.yml | PR → main | Solo base staging consentita |
ci-node-red.yml | path deploy/node-red/** | Validate inventory, test, compose, build/promote |
deploy-node-red.yml | dopo CI Node-RED | Webhook COOLIFY_WEBHOOK_NODERED_* |
docs.yml | path docs/ | vitepress build + COOLIFY_DOCS_WEBHOOK |
Path: .github/workflows/.
Pipeline branch
feature/* → dev → staging → mainPromozione immagine FactoryOS
- Build su
staging→ tagsha-<commit>+:staging. - Deploy staging e validazione.
- Merge
staging → maincon approval. - Verifica uguaglianza alberi Git
mainestaging. - 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 checksTroubleshooting
| Sintomo | Azione |
|---|---|
| Deploy staging fallisce su backup | Configurare BACKUP_WEBHOOK_STAGING |
| Production bloccata | Approval environment + base branch = staging |
| Docs non aggiornate | Controllare docs.yml e COOLIFY_DOCS_WEBHOOK |
