From 2144f755dc9e2c3c8f0e77e0e97330b1a3cfccce Mon Sep 17 00:00:00 2001 From: Alberto Balbo Date: Tue, 20 Oct 2026 12:04:55 +0200 Subject: [PATCH] CI: l'immagine di main si pubblica solo dopo l'installatore MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Il lavoro immagine dipendeva solo da prove: :main e :sha- uscivano anche con l'installatore rosso o non ancora finito, mentre docs/docker.md dice che :main è l'ultimo commit di main che ha passato la verifica. Ora needs: [prove, installatore]; sull'unico runner i lavori vanno comunque uno alla volta, quindi la durata non cambia. Rilievo main-senza-installatore della revisione. Co-Authored-By: Claude Opus 5.5 --- .gitea/workflows/verifica.yml | 12 +++++++----- docs/decisioni.md | 1 + docs/guida/Sviluppo.md | 6 +++--- docs/processo.md | 2 +- tests/Febe.Tests/Packaging/PipelineTests.cs | 2 +- 5 files changed, 13 insertions(+), 10 deletions(-) diff --git a/.gitea/workflows/verifica.yml b/.gitea/workflows/verifica.yml index 6092d5d..5c76c53 100644 --- a/.gitea/workflows/verifica.yml +++ b/.gitea/workflows/verifica.yml @@ -8,10 +8,10 @@ # Il mondo sintetico del sito di prova ha il seme 13 e, per la categoria SitoDiProva, anche il seme di # questa esecuzione, scritto nel registro per rifare un errore; # installatore Febe-Setup--ci..exe e lo zip portabile, artefatti per 14 giorni; -# immagine l'immagine Docker costruita con buildx, provata senza rete (parte, salute, Chromium, it_IT) e -# scansionata con Trivy (si ferma per una CRITICAL con correzione); solo dopo un push su main la -# pubblica come :main e :sha-<7 caratteri> (:latest resta al rilascio). Alla fine, sempre, toglie -# immagini, contenitori, cache e builder di questa esecuzione. +# immagine dopo l'installatore: l'immagine Docker costruita con buildx, provata senza rete (parte, salute, +# Chromium, it_IT) e scansionata con Trivy (si ferma per una CRITICAL con correzione); solo dopo un push +# su main la pubblica come :main e :sha-<7 caratteri> (:latest resta al rilascio). Alla fine, sempre, +# toglie immagini, contenitori, cache e builder di questa esecuzione. # # Niente «pull_request»: in Gitea una richiesta di unione mostra lo stato del suo ultimo commit, che il push del ramo # ha già verificato; pull_request rifarebbe tutto sullo stesso commit (refs/pull/N/head) sull'unico runner. @@ -178,8 +178,10 @@ jobs: retention-days: 14 if-no-files-found: error + # Dopo l'installatore, non solo dopo le prove: :main e :sha- escono solo da un commit con tutta la verifica verde. + # Sull'unico runner i lavori vanno comunque uno alla volta, quindi la durata non cambia. immagine: - needs: prove + needs: [prove, installatore] runs-on: ubuntu-latest timeout-minutes: 60 env: diff --git a/docs/decisioni.md b/docs/decisioni.md index f476607..dbdc41e 100644 --- a/docs/decisioni.md +++ b/docs/decisioni.md @@ -242,3 +242,4 @@ Ogni scelta tecnica presa strada facendo, con data e motivo (specifica §15). | 2026-10-20 | `permissions: contents: read` in `verifica` e `pulizia`; i riepiloghi delle prove e di Trivy vanno nel registro e anche in `GITHUB_STEP_SUMMARY` | Gitea 28 applica `permissions` al gettone del lavoro (docs.gitea.com, «Actions job token permissions»), che così non può scrivere nel repository; i riepiloghi dei lavori esistono da Gitea 1.27 ma compaiono solo se il runner li carica, quindi il registro resta la fonte | | 2026-10-20 | Ciò che la CI usa di Gitea 28 e di act_runner: `concurrency` con espressioni, `timeout-minutes` dei lavori (lo applica il runner), `workflow_dispatch` con `inputs`, `schedule`, `defaults.run.shell`, `container` del lavoro, contesti `gitea.*`, `vars` e `secrets`; gli stati dei commit si chiamano «verifica / (push)» (`modules/actions/workflows.go`) e solo push, pull_request e release ne creano | Controllato sul codice di Gitea `release/v28` e su docs.gitea.com il 20 ottobre 2026; ciò che solo la prima esecuzione vera può provare è in `docs/processo.md` | | 2026-10-20 | Processo in `docs/processo.md`: rami `/` da `main`, commit piccoli in italiano, una richiesta di unione per ramo con il modello di `.gitea/` (comprese le 14 regole di §2), unione con commit di unione e ramo cancellato; `main` protetto con i quattro lavori di `verifica` come controlli richiesti e «blocca se indietro»; tag `v*` protetti; Alberto proprietario di tutto (`CODEOWNERS`) | Decisione di Alberto del 20 ottobre (processo da grande azienda); con il ramo aggiornato il commit di unione ha lo stesso contenuto del commit verificato, quindi in `main` entra solo codice provato. Le approvazioni richieste dipendono da chi apre le richieste (Gitea non conta quella dell'autore): domanda aperta per Alberto | +| 2026-10-20 | Nella verifica il lavoro «immagine» viene dopo «prove» e «installatore» (`needs: [prove, installatore]`) | `:main` e `:sha-` devono uscire solo da un commit con tutta la verifica verde, come dice `docs/docker.md`; sull'unico runner i lavori vanno comunque uno alla volta, quindi la durata non cambia. Su un ramo, se l'installatore fallisce l'immagine si salta: la richiesta di unione è già bloccata dall'installatore | diff --git a/docs/guida/Sviluppo.md b/docs/guida/Sviluppo.md index 03e7713..907e8f1 100644 --- a/docs/guida/Sviluppo.md +++ b/docs/guida/Sviluppo.md @@ -139,9 +139,9 @@ richieste di unione, protezione di `main`, rilievi di sicurezza, rilasci, correz - `prove`: compilazione di tutta la soluzione con gli avvisi come errori e tutte le prove di `tests/Febe.Tests` in un contenitore Debian con Chromium, Xvfb, ffmpeg, NSIS e Node veri: nessuna prova si salta; - `installatore`: `Febe-Setup--ci..exe` e lo zip portabile, fra gli artefatti per 14 giorni; - - `immagine`: l'immagine Docker, provata senza rete (parte, diventa «healthy», si ferma) e scansionata con Trivy; - dopo un push su `main` va sul registro come `:main` e `:sha-`. Alla fine si toglie tutto ciò che - l'esecuzione ha creato sul demone Docker, che è condiviso con gli altri progetti; + - `immagine`, dopo l'installatore: l'immagine Docker, provata senza rete (parte, diventa «healthy», si ferma) e + scansionata con Trivy; dopo un push su `main` va sul registro come `:main` e `:sha-`. Alla fine si toglie + tutto ciò che l'esecuzione ha creato sul demone Docker, che è condiviso con gli altri progetti; - `rilascio.yml`, a ogni tag `vX.Y.Z`: prove, installatore e zip, immagine provata e scansionata, pubblicata come `:X.Y.Z` e `:latest` (solo per le versioni senza trattino), poi la release; - `pulizia.yml`, ogni lunedì e a mano: i resti delle esecuzioni interrotte e le immagini senza nome vecchie. diff --git a/docs/processo.md b/docs/processo.md index 0874328..00fbd3d 100644 --- a/docs/processo.md +++ b/docs/processo.md @@ -89,7 +89,7 @@ Docker del server, lo stesso che costruisce Encelado, Mimante e gli altri proget | `controlli` | ogni push | sintassi di tutti gli script di shell (`bash -n`, `sh -n`) e righe Unix; flussi senza tabulazioni; nessun segno di conflitto; versione in `Directory.Build.props` valida; ogni progetto di `Febe.slnx` esiste; ogni JSON si legge; nessun segreto in tutta la storia (gitleaks 8.30.1, `--redact`) | | `prove` | dopo `controlli` | in un contenitore Debian 13 (`node:24-trixie`) con Chromium della distribuzione, Xvfb, ffmpeg, NSIS, Node e la lingua italiana: tutta la soluzione compila con gli avvisi come errori e **tutte** le prove di `tests/Febe.Tests` passano senza saltarsi; quelle della categoria `SitoDiProva` passano anche con il seme dell'esecuzione. Risultati `.trx` fra gli artefatti (14 giorni) | | `installatore` | dopo `prove` | `Febe.exe` in un file solo, `Febe-Setup--ci..exe` e lo zip portabile si costruiscono, ciascuno sotto i 100 MB; artefatti per 14 giorni | -| `immagine` | dopo `prove` | l'immagine si costruisce con buildx (dentro girano compilazione e prove), il contenitore parte **senza rete** come dice la guida e diventa «healthy», Chromium e la lingua italiana ci sono, si ferma entro 30 secondi; Trivy 0.75.0 non trova vulnerabilità CRITICAL con correzione disponibile. Solo dopo un push su `main`: pubblicazione `:main` e `:sha-` | +| `immagine` | dopo `installatore` (così `:main` e `:sha-` escono solo da un commit con tutta la verifica verde) | l'immagine si costruisce con buildx (dentro girano compilazione e prove), il contenitore parte **senza rete** come dice la guida e diventa «healthy», Chromium e la lingua italiana ci sono, si ferma entro 30 secondi; Trivy 0.75.0 non trova vulnerabilità CRITICAL con correzione disponibile. Solo dopo un push su `main`: pubblicazione `:main` e `:sha-` | La verifica gira a ogni push su qualunque ramo e a mano (Actions ▸ verifica ▸ Esegui, con un seme facoltativo). Su un ramo un push nuovo annulla l'esecuzione in corso; su `main` ogni unione arriva fino in fondo. Un'esecuzione a mano non diff --git a/tests/Febe.Tests/Packaging/PipelineTests.cs b/tests/Febe.Tests/Packaging/PipelineTests.cs index 0f84f08..445f880 100644 --- a/tests/Febe.Tests/Packaging/PipelineTests.cs +++ b/tests/Febe.Tests/Packaging/PipelineTests.cs @@ -45,7 +45,7 @@ public sealed partial class PipelineTests StringAssert.Contains(Job(workflow, "prove"), "needs: controlli"); StringAssert.Contains(Job(workflow, "installatore"), "needs: prove"); - StringAssert.Contains(Job(workflow, "immagine"), "needs: prove"); + StringAssert.Contains(Job(workflow, "immagine"), "needs: [prove, installatore]", ":main comes only from a commit whose whole verification is green"); foreach (var other in new[] { "rilascio.yml", "pulizia.yml" }) { var text = Workflow(other);