diff --git a/.gitea/workflows/ci.yml b/.gitea/workflows/ci.yml index ee1353a..7ac0c04 100644 --- a/.gitea/workflows/ci.yml +++ b/.gitea/workflows/ci.yml @@ -22,11 +22,16 @@ # fallisce sempre con GHESNotSupportedError. Gli upload sono sullo step con `continue-on-error`, # così un problema dello storage non rende rossa una verifica andata a buon fine. # -# TIMEOUT: i limiti sono larghi perché il primo avvio scarica l'immagine Playwright (oltre 1 GB, -# circa mezz'ora sulla rete del runner di casa) e quel tempo va messo in conto nel limite del -# job; lo stesso vale dopo ogni pulizia delle immagini inutilizzate. A immagine già presente la +# TIMEOUT: i limiti sono larghi perché la rete del runner di casa è lenta: il primo avvio scarica +# l'immagine Playwright (oltre 1 GB, più di venti minuti) e ogni esecuzione clona le action da +# github.com, scarica Node e le dipendenze npm. A immagine presente e con la rete libera la # verifica dura pochi minuti. # +# CACHE: niente `cache: npm` in setup-node. Il server di cache del runner non è raggiungibile +# dal container del job (connect ETIMEDOUT verso l'indirizzo del runner): ogni esecuzione +# aspettava cinque minuti prima di proseguire con un avviso. Le dipendenze si scaricano con +# `npm ci` a ogni esecuzione. +# # NON BLOCCANTE: il controllo dei link esterni ha `continue-on-error` sullo step (non sul job). # # DOMINIO: la variabile del repository SITE_URL (Impostazioni → Actions → Variabili), se @@ -54,14 +59,13 @@ jobs: runs-on: ubuntu-latest # label del runner: adattare se diverso container: image: mcr.microsoft.com/playwright:v1.56.1-noble # = versione di @playwright/test - timeout-minutes: 90 # comprende lo scarico dell'immagine alla prima esecuzione (vedi TIMEOUT) + timeout-minutes: 90 # la rete del runner è lenta (vedi TIMEOUT) steps: - uses: https://github.com/actions/checkout@v4 - uses: https://github.com/actions/setup-node@v4 with: - node-version-file: .nvmrc - cache: npm + node-version-file: .nvmrc # niente `cache: npm`: vedi CACHE in testa al file - name: Dipendenze run: npm ci @@ -123,7 +127,7 @@ jobs: runs-on: ubuntu-latest # label del runner: adattare se diverso container: image: node:24 - timeout-minutes: 45 # comprende lo scarico dell'immagine node:24 alla prima esecuzione + timeout-minutes: 45 # la rete del runner è lenta (vedi TIMEOUT) steps: - uses: https://github.com/actions/checkout@v4 diff --git a/.gitea/workflows/release.yml b/.gitea/workflows/release.yml index 9c4507e..e6bea19 100644 --- a/.gitea/workflows/release.yml +++ b/.gitea/workflows/release.yml @@ -49,7 +49,7 @@ jobs: contents: write # crea la release e carica lo zip con il token automatico (Gitea 1.26 e successivi) container: image: mcr.microsoft.com/playwright:v1.56.1-noble # = versione di @playwright/test - timeout-minutes: 90 # come in ci.yml: comprende lo scarico dell'immagine se non è già sul runner + timeout-minutes: 90 # largo come in ci.yml: la rete del runner è lenta (vedi TIMEOUT) steps: - uses: https://github.com/actions/checkout@v4 with: @@ -57,8 +57,7 @@ jobs: - uses: https://github.com/actions/setup-node@v4 with: - node-version-file: .nvmrc - cache: npm + node-version-file: .nvmrc # niente `cache: npm`: vedi CACHE in ci.yml - name: Data riproducibile (data del commit) run: echo "SOURCE_DATE_EPOCH=$(git log -1 --format=%ct)" >> "$GITHUB_ENV" diff --git a/DECISIONS.md b/DECISIONS.md index 7887666..5bd1d46 100644 --- a/DECISIONS.md +++ b/DECISIONS.md @@ -597,7 +597,8 @@ Ogni scelta non banale presa durante lo sviluppo (brief §0.4). Formato: data · - CI: il job «verify» ripete passo per passo `npm run verify`, nello stesso ordine (lint, formattazione, controllo dei tipi, build, HTML, link interni, end-to-end, accessibilità, conformità, Lighthouse), poi crea lo zip di rilascio (`scripts/package.mjs`) e ne verifica il contenuto (`npm run test:package`); il controllo dei link esterni è un job a parte e non bloccante (D-045). Modificando gli script `verify` o `test` di `package.json` vanno aggiornati anche i passi; - release: a ogni tag `vX.Y.Z` il workflow controlla tag, versione e CHANGELOG, esegue `verify` e `package` e pubblica la release con `scripts/release-upload.sh`, che usa l'API REST di Gitea (variabili `GITEA_URL`, `GITEA_REPO`, `GITEA_TOKEN`), senza action esterne di release (D-043); - token e variabili: segreto facoltativo `RELEASE_TOKEN` (token personale con permesso `write:repository`); se manca si usa il token automatico del workflow. I nomi di segreti e variabili non possono iniziare con `GITEA_` o `GITHUB_`. Il dominio si imposta con la variabile del repository `SITE_URL` (D-051). - - `timeout-minutes` larghi (90 per `verify` e per la release, 45 per il controllo dei link esterni): la prima esecuzione sul runner scarica l'immagine Playwright (oltre 1 GB) e sulla rete del runner di casa il solo scarico supera i venti minuti, tempo che va messo in conto nel limite del job; dopo una pulizia delle immagini inutilizzate lo scarico si ripete. I limiti iniziali erano 30, 15 e 40 minuti; + - `timeout-minutes` larghi (90 per `verify` e per la release, 45 per il controllo dei link esterni; prima 30, 40 e 15): la rete del runner di casa è lenta. Il 22 ottobre 2026 la prima esecuzione ha impiegato più di venti minuti per scaricare l'immagine Playwright (oltre 1 GB), tre minuti per clonare `setup-node` da github.com e minuti per le dipendenze; lo scarico dell'immagine si ripete se il runner la elimina con la pulizia delle immagini inutilizzate; + - niente `cache: npm` in `setup-node`: il server di cache del runner non è raggiungibile dal container del job (`getCacheEntry failed: connect ETIMEDOUT`), e a ogni esecuzione il passo aspettava circa cinque minuti prima di proseguire con un avviso. Le dipendenze si scaricano con `npm ci`; - **Alternative scartate:** - le copie delle azioni ospitate su gitea.com: restano la via d'uscita, indicata nel commento di `ci.yml`, se il runner non raggiunge github.com, ma i workflow usano le azioni originali senza un secondo repository di azioni da tenere allineato; - `actions/upload-artifact@v4`, che non funziona su Gitea; diff --git a/docs/BRIEF.md b/docs/BRIEF.md index a27bf28..3ba8e67 100644 --- a/docs/BRIEF.md +++ b/docs/BRIEF.md @@ -633,7 +633,6 @@ jobs: - uses: https://github.com/actions/setup-node@v4 with: node-version-file: .nvmrc - cache: npm - run: npm ci # i passi di `npm run verify`, uno per uno e nello stesso ordine - run: npm run lint @@ -704,7 +703,6 @@ jobs: - uses: https://github.com/actions/setup-node@v4 with: node-version-file: .nvmrc - cache: npm - run: echo "SOURCE_DATE_EPOCH=$(git log -1 --format=%ct)" >> "$GITHUB_ENV" # data riproducibile = data del commit - run: npm ci - name: Controlli preliminari (tag, versione, CHANGELOG)