CI: la pulizia toglie tutto ciò che non serve più (immagini inutilizzate, cache, resti di act_runner, vecchie :sha-), con «Solo prova» #9

Merged
Alby96 merged 11 commits from ci/pulizia-immagini-inutilizzate into main 2026-10-21 14:25:16 +02:00
Owner

Sintesi

La CI toglie ciò che non serve più a nessuno, non solo ciò che crea. Le cose che sono di qualcuno restano, sempre:
contenitori, volumi e reti degli altri progetti, e le app di Unraid.

Perché

Richiesta di Alberto del 21/10: «aggiungi il prune delle immagini non più utilizzate nel workflow di Actions, in modo da
eliminare tutto quello che non serve più». La regola del 20/10, «mai le immagini degli altri progetti, mai la cache del
demone», è superata per ciò che nessuno usa (riga in docs/decisioni.md).

Che cosa cambia

  • A ogni lavoro «immagine» (verifica e rilascio), nel passo «Pulizia (sempre)»: le immagini senza nome che nessun
    contenitore usa, e la cache di costruzione penzolante che nessuno usa da 24 ore (docker image prune -f,
    docker builder prune -f --filter until=24h). Un errore resta un avviso, mai un lavoro rosso.
  • Il lunedì alle 4:17, e a mano (pulizia.yml, modo «completa»):
    • i resti della CI di Febe, come prima;
    • i resti di act_runner: contenitori fermi, volumi e reti GITEA-ACTIONS-TASK-… che nessuno usa, più vecchi di
      90 minuti;
    • tutte le immagini che nessun contenitore usa, acceso o spento, create da più di 24 ore
      (docker image prune -a -f --filter until=24h), e la cache più vecchia di 24 ore;
    • con REGISTRY_TOKEN, le febe:sha-… oltre le 10 più recenti, tramite l'API dei pacchetti di Gitea 28. Mai main,
      latest o una versione X.Y.Z; il token non si stampa mai;
    • docker system df prima e dopo, e un riepilogo.
  • Mai: docker system prune, un volume, un contenitore o una rete che non siano della CI.
  • «Solo prova» (casella dell'esecuzione manuale, o --prova dello script): elenca che cosa toglierebbe, con
    dimensione ed età delle immagini, usando solo comandi di lettura e solo GET sul registro. Qualunque altro argomento
    ferma lo script prima di chiamare Docker: una prova scritta male non diventa mai la pulizia vera.
  • Immagine: si costruisce con --provenance=false --sbom=false, quindi come manifest semplice. Con le attestazioni
    ogni :sha- era un indice, e gli strati restavano in manifest figli sha256:… che togliere l'etichetta non liberava.
  • .gitea/scripts/versioni-registro.js sceglie le etichette da togliere. È in Node perché jq non c'è, e ha una prova
    senza rete con un JSON di esempio.
  • Prove in PipelineTests.Pulizia.cs, su un Docker finto con app di Unraid ferme, un Febe vero e resti di act_runner:
    • che cosa resta;
    • nessun comando vietato;
    • la prova non tocca nulla e conta ciò che la pulizia vera toglie;
    • la scelta delle etichette;
    • il token mai nel registro;
    • il passo di ogni esecuzione mai rosso.
  • Documenti: docs/processo.md («Pulizia», con il costo dei riscaricamenti delle immagini di base), docs/docker.md,
    la guida «Sviluppo», CLAUDE.md, docs/decisioni.md, CHANGELOG.md (0.1.2 in preparazione).

Come è stato provato

bash -n su script e blocchi run (37)                → validi
bash .gitea/scripts/controlli.sh                    → «Controlli superati»
dotnet build Febe.slnx -warnaserror                 → 0 avvisi, 0 errori
dotnet test --filter Packaging|Docs (Windows)       → 0 fallite
ogni commit del ramo, compilato e provato da solo   → verde
pulizia sul Docker finto: --dry-run, -n, prova       → codice 2 e nessuna chiamata a Docker (prima: pulizia vera)

Revisione avversaria: due rilievi importanti (gli strati sul registro e la prova scritta male) e quattro minori. Tutti
corretti: il resoconto è nel commento.

Non provato, perché qui non c'è un demone Docker:

  • l'host vero: il suo store delle immagini (classico o containerd: la pulizia lo scrive all'inizio), i nomi veri di
    act_runner, il costo dei riscaricamenti;
  • l'API dei pacchetti con un REGISTRY_TOKEN vero.

Dopo l'unione si lancia pulizia con «Solo prova» e si legge l'elenco prima della prima pulizia vera, lunedì 26/10
alle 4:17.

Rischi e ritorno indietro

  • Il lunedì le immagini di base (il contenitore delle prove, il runner, buildkit) si scaricano di nuovo alla prima
    esecuzione: qualche minuto in più. Di un'immagine in uso, Docker toglie solo i nomi in più: l'elenco lo mostra.
  • Ritorno indietro: git revert -m 1 <commit di unione>; per sospendere subito, si disattiva pulizia.yml da Actions.

Controlli prima di unire

  • 1–12. Nessun cambiamento al prodotto
  • 11. Nessun segreto nei registri: il token del registro va solo nelle intestazioni, mai stampato
  • 13. Nessuna dipendenza nuova (Node c'è già nel contenitore)
  • 14. Ciò che non è stato provato è scritto sopra
  • La verifica è verde sull'ultimo commit

🤖 Generated with Claude Code

## Sintesi La CI toglie ciò che non serve più a nessuno, non solo ciò che crea. Le cose che sono di qualcuno restano, sempre: contenitori, volumi e reti degli altri progetti, e le app di Unraid. ## Perché Richiesta di Alberto del 21/10: «aggiungi il prune delle immagini non più utilizzate nel workflow di Actions, in modo da eliminare tutto quello che non serve più». La regola del 20/10, «mai le immagini degli altri progetti, mai la cache del demone», è superata per ciò che nessuno usa (riga in `docs/decisioni.md`). ## Che cosa cambia - **A ogni lavoro «immagine»** (verifica e rilascio), nel passo «Pulizia (sempre)»: le immagini senza nome che nessun contenitore usa, e la cache di costruzione penzolante che nessuno usa da 24 ore (`docker image prune -f`, `docker builder prune -f --filter until=24h`). Un errore resta un avviso, mai un lavoro rosso. - **Il lunedì alle 4:17, e a mano** (`pulizia.yml`, modo «completa»): - i resti della CI di Febe, come prima; - i resti di act_runner: contenitori fermi, volumi e reti `GITEA-ACTIONS-TASK-…` che nessuno usa, più vecchi di 90 minuti; - **tutte le immagini che nessun contenitore usa**, acceso o spento, create da più di 24 ore (`docker image prune -a -f --filter until=24h`), e la cache più vecchia di 24 ore; - con `REGISTRY_TOKEN`, le `febe:sha-…` oltre le 10 più recenti, tramite l'API dei pacchetti di Gitea 28. Mai `main`, `latest` o una versione `X.Y.Z`; il token non si stampa mai; - `docker system df` prima e dopo, e un riepilogo. - **Mai**: `docker system prune`, un volume, un contenitore o una rete che non siano della CI. - **«Solo prova»** (casella dell'esecuzione manuale, o `--prova` dello script): elenca che cosa toglierebbe, con dimensione ed età delle immagini, usando solo comandi di lettura e solo GET sul registro. Qualunque altro argomento ferma lo script prima di chiamare Docker: una prova scritta male non diventa mai la pulizia vera. - **Immagine**: si costruisce con `--provenance=false --sbom=false`, quindi come manifest semplice. Con le attestazioni ogni `:sha-` era un indice, e gli strati restavano in manifest figli `sha256:…` che togliere l'etichetta non liberava. - `.gitea/scripts/versioni-registro.js` sceglie le etichette da togliere. È in Node perché `jq` non c'è, e ha una prova senza rete con un JSON di esempio. - Prove in `PipelineTests.Pulizia.cs`, su un Docker finto con app di Unraid ferme, un Febe vero e resti di act_runner: - che cosa resta; - nessun comando vietato; - la prova non tocca nulla e conta ciò che la pulizia vera toglie; - la scelta delle etichette; - il token mai nel registro; - il passo di ogni esecuzione mai rosso. - Documenti: `docs/processo.md` («Pulizia», con il costo dei riscaricamenti delle immagini di base), `docs/docker.md`, la guida «Sviluppo», CLAUDE.md, `docs/decisioni.md`, `CHANGELOG.md` (0.1.2 in preparazione). ## Come è stato provato ```text bash -n su script e blocchi run (37) → validi bash .gitea/scripts/controlli.sh → «Controlli superati» dotnet build Febe.slnx -warnaserror → 0 avvisi, 0 errori dotnet test --filter Packaging|Docs (Windows) → 0 fallite ogni commit del ramo, compilato e provato da solo → verde pulizia sul Docker finto: --dry-run, -n, prova → codice 2 e nessuna chiamata a Docker (prima: pulizia vera) ``` Revisione avversaria: due rilievi importanti (gli strati sul registro e la prova scritta male) e quattro minori. Tutti corretti: il resoconto è nel commento. Non provato, perché qui non c'è un demone Docker: - l'host vero: il suo store delle immagini (classico o containerd: la pulizia lo scrive all'inizio), i nomi veri di act_runner, il costo dei riscaricamenti; - l'API dei pacchetti con un `REGISTRY_TOKEN` vero. **Dopo l'unione** si lancia pulizia con «Solo prova» e si legge l'elenco **prima** della prima pulizia vera, lunedì 26/10 alle 4:17. ## Rischi e ritorno indietro - Il lunedì le immagini di base (il contenitore delle prove, il runner, buildkit) si scaricano di nuovo alla prima esecuzione: qualche minuto in più. Di un'immagine in uso, Docker toglie solo i nomi in più: l'elenco lo mostra. - Ritorno indietro: `git revert -m 1 <commit di unione>`; per sospendere subito, si disattiva `pulizia.yml` da Actions. ## Controlli prima di unire - [x] 1–12. Nessun cambiamento al prodotto - [x] 11. Nessun segreto nei registri: il token del registro va solo nelle intestazioni, mai stampato - [x] 13. Nessuna dipendenza nuova (Node c'è già nel contenitore) - [x] 14. Ciò che non è stato provato è scritto sopra - [ ] La verifica è verde sull'ultimo commit 🤖 Generated with [Claude Code](https://claude.com/claude-code)
Alby96 added 11 commits 2026-10-21 13:17:28 +02:00
Alberto, 21/10: la pulizia della CI deve eliminare tutto quello che non
serve più, non solo ciò che la CI di Febe ha creato. pulizia-docker.sh ha
due modi nuovi. «penzolanti»: le immagini senza nome e la cache di
costruzione che nessuna immagine condivide, di tutti i progetti; un errore
è solo un avviso. «completa»: i resti della CI di Febe come prima, i resti
di act_runner (contenitori fermi, volumi e reti GITEA-ACTIONS-TASK-… che
nessuno usa), le immagini che nessun contenitore usa e la cache più
vecchie di 24 ore, e con REGISTRY_TOKEN le etichette sha- del registro
oltre le 10 più recenti. Mai system, container, volume o network prune,
mai un contenitore, un volume o una rete che non sia della CI. Con
--prova ogni modo elenca che cosa toglierebbe e non tocca nulla.

Le etichette del registro le sceglie versioni-registro.js, che si prova
con un JSON e senza rete; controlli.sh ne controlla la sintassi. Le prove
girano contro un docker e un curl finti, su un demone come quello del
runner: applicazioni di Unraid ferme, un Febe vero, il lavoro della
pulizia stessa, resti veri e finti di act_runner.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Alla fine di ogni lavoro «immagine» di verifica e rilascio, dopo la
pulizia dell'esecuzione, gira pulizia-docker.sh penzolanti: le immagini
senza nome e la cache penzolante del demone se ne vanno subito invece di
aspettare il lunedì, e un errore resta un avviso, così il lavoro non
diventa rosso per la pulizia.

pulizia.yml passa al modo «completa» e, a mano, ha la casella «Solo
prova» (input booleano: Gitea 28 lo mette nell'evento come «true» o
«false»), con cui elenca che cosa toglierebbe e non tocca nulla: da
lanciare prima della prima pulizia vera. Il passo riceve REGISTRY_TOKEN,
l'indirizzo dell'API e il proprietario per le etichette del registro.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
docs/processo.md («Pulizia») dice che cosa se ne va alla fine di ogni
esecuzione e il lunedì, che cosa non se ne va mai, che cosa costa (le
immagini di base da riscaricare, la cache di costruzione da rifare, le
immagini tenute senza contenitore) e come si lancia la prova che non
toglie nulla, da fare prima della prima pulizia vera; le :sha- del
registro non si accumulano più. Lo stesso, in breve, in docs/docker.md,
nella guida (Sviluppo, «CI e rilascio») e in CLAUDE.md. In
docs/decisioni.md le scelte del 21 ottobre: la regola nuova, che per ciò
che nessuno usa sostituisce il «mai le immagini degli altri progetti» del
20 ottobre, i nomi di act_runner, l'API dei pacchetti di Gitea 28, la
casella «Solo prova», BUILDX_BUILDER=default e il controllo degli script
Node.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Lo script è nuovo e la regola del repository vuole codice e commenti in
inglese (CLAUDE.md, «Convenzioni»); i messaggi restano in italiano, come
tutti quelli della CI. Nessun cambio di comportamento: sulle pagine di
tests/Febe.Tests/Packaging/versioni-registro.json la scelta è identica
byte per byte, tenendone 0, 10 e 20, e gli errori escono ancora con 2.
Gli script di shell di .gitea, già in italiano prima di questo ramo,
restano come sono.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Lo script riconosceva solo --prova esatto e ignorava ogni altro
argomento: a mano «completa --dry-run», «-n» o «prova» facevano partire
la pulizia completa vera sul demone condiviso, con codice 0. Ora ogni
argomento si controlla prima di chiamare Docker: un'opzione diversa da
--prova o un argomento in più fermano tutto con codice 2 e l'uso.

Allo stesso modo il passo di pulizia.yml accettava come prova solo il
testo «true» e trattava ogni altro valore come pulizia vera; un avvio con
l'API passa il valore così com'è («True», «1»). Ora «true» è la prova,
«false» o niente la pulizia vera, qualunque altro valore un errore senza
toccare nulla (il valore nel messaggio è ripulito, così non può
aggiungere un comando del flusso).

Le prove fanno girare il blocco del passo vero con uno script finto per
nove valori, e lo script con dieci argomenti sbagliati: codice 2 e
nessuna chiamata a Docker.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Con il builder docker-container buildx aggiunge da sé l'attestazione di
provenienza, e l'immagine spinta sul registro è un indice. Gitea tiene
ogni manifest figlio come una versione a sé, sha256:… senza etichetta,
con la configurazione e gli strati: la pulizia del lunedì toglieva solo
l'indice delle :sha- vecchie e gli strati restavano per sempre, mentre i
documenti dicevano che il registro si alleggeriva (rilievo della
revisione, controllato sul codice di Gitea release/v28).

costruisci-immagine.sh costruisce con --provenance=false --sbom=false,
sia l'archivio provato sia l'immagine spinta: ogni etichetta è un
manifest semplice che tiene i suoi strati, e quando nessuna versione li
usa più li cancella la pulizia notturna dei pacchetti di Gitea. Le
versioni sha256:… lo script non le tocca mai, perché l'API non dice se
un indice le rimanda, ma ne scrive il numero, anche nella prova
(versioni-registro.js senza-etichetta); docs/processo.md dice quale
regola di pulizia di Gitea le toglie se compaiono. La CI non ha ancora
pubblicato nulla, perché manca REGISTRY_TOKEN.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Alla fine di ogni lavoro «immagine», cioè a ogni push di ogni ramo,
«docker builder prune -f» senza filtro toglieva dal builder del demone
tutta la cache che nessuna immagine condivide, di qualunque età e di
tutti i progetti: gli strati intermedi e le cache montate che Encelado o
Mimante avevano usato mezz'ora prima. Alla cache di Febe non serviva
(stava nel builder dell'esecuzione, già tolto) e annullava la finestra
di 24 ore della pulizia del lunedì (rilievo della revisione).

Ora anche dopo ogni esecuzione «--filter until=24h», che BuildKit
confronta con l'ultimo uso: una costruzione che si ripete almeno una
volta al giorno ritrova la sua cache. Il compito chiedeva il comando
senza filtro; la scelta resta di Alberto, e per tornarci basta togliere
il filtro. Le immagini senza nome restano senza filtro, come prima.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
I documenti dicevano che le 24 ore di «image prune --filter until»
contano sempre dalla costruzione dell'immagine. Vale solo con lo store
classico; con quello di containerd, predefinito nelle installazioni
nuove di Docker Engine dalla 29, Docker confronta il momento in cui il
nome è arrivato sul demone, che un nuovo pull dello stesso nome non
cambia. La prova invece calcola l'età dalla costruzione, quindi con
containerd prova e pulizia vera possono non coincidere, nei due sensi
(rilievo della revisione, controllato sul codice di moby).

Nei modi «settimanale» e «completa» la pulizia legge lo store con
docker info e lo scrive all'inizio; con containerd, o se docker info non
risponde, la prova avverte che le età che elenca sono solo indicative.
docs/processo.md dice come vanno le cose con l'uno e con l'altro, anche
per le immagini costruite con una data fissa. Il demone finto delle
prove sa rispondere come l'uno e come l'altro.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Docker non toglie un'immagine che un contenitore usa, ma con -a le toglie
i nomi in più: con lo store classico tutti tranne l'ultimo in ordine
alfabetico, anche quello da cui il contenitore è stato creato
(un'applicazione di Unraid creata da app:1.2 che si chiama anche
app:latest resta senza app:1.2); con containerd tutti tranne quelli dei
contenitori. La prova saltava ogni immagine in uso e i documenti la
davano per intoccata (rilievo della revisione, controllato sul codice di
moby v24, v27 e master).

La pulizia vera confronta i nomi prima e dopo la potatura e scrive, nome
per nome, quelli tolti a un'immagine che resta; la prova li stima secondo
lo store e li conta, e le prove controllano che stima e pulizia vera
coincidano con l'uno e con l'altro store. Il comando resta quello
chiesto, docker image prune -a -f --filter until=24h; docs/processo.md e
docs/docker.md dicono che cosa succede ai nomi.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Il modulo delle regole di pulizia di Gitea non ha un'etichetta «nessun
limite» per lo zero: si dice «dopo lo zero». Lo store classico non è per
forza overlay2 (su Unraid docker.img è spesso btrfs): si dice solo che
è il più probabile. Un a capo rimasto a metà del paragrafo sulla prova.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Novità della 0.1.2 (in preparazione): le righe di questo ramo
verifica / controlli (push) Successful in 19s
verifica / prove (push) Successful in 15m53s
verifica / installatore (push) Successful in 5m6s
verifica / immagine (push) Successful in 20m8s
7d5c6505bd
La sezione 0.1.2 del CHANGELOG, sotto «Sviluppo e qualità», con ciò che questo ramo cambia.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Author
Owner

Revisione avversaria

Un revisore indipendente ha letto tutto il ramo e ha rifatto compilazione e prove; l'autore ha poi verificato ogni rilievo prima di correggerlo o respingerlo.

Giudizio del revisore

Lavoro accurato, da unire dopo aver sistemato i due rilievi importanti.

Che cosa regge. Le verifiche le ho fatte nel worktree, senza modificarlo:

  • La prova con --prova esatto fa solo letture, e sul registro solo GET.
  • Il passo di ogni esecuzione non può far diventare rosso un lavoro.
  • La scelta delle sha- non può toccare main, latest o X.Y.Z, legge tutte le pagine fino a quella vuota e non dipende dall'ordine.
  • Il token non compare nel registro del lavoro.
  • Contenitori, volumi e reti che non sono della CI non vengono mai presi di mira, nemmeno con un tentativo.
  • Sul codice di Gitea release/v28 ho controllato GET /packages/{owner}/container/febe?page&limit e DELETE …/{version} (risponde 204), e l'input booleano di workflow_dispatch, che arriva come «true»/«false».
  • Sul codice di moby e BuildKit ho controllato come funzionano until, image prune -a e il prune della cache senza -a.

I due rilievi importanti:

  1. Registro. Si tolgono solo i manifest indice delle sha-. Gli strati restano nei manifest figli sha256:, prodotti dalle attestazioni predefinite di buildx, e nessuno li toglie. Intanto i documenti dicono che la regola di pulizia di Gitea non serve.
  2. Prova. Si attiva solo con il testo esatto. A mano --dry-run, -n o prova, oppure via API un valore diverso da «true», fanno partire la pulizia vera con codice 0: l'ho provato sul demone finto.

Gli altri quattro rilievi sono minori:

  • nomi in più tolti alle immagini in uso, che la prova non elenca;
  • il prune della cache a ogni esecuzione, senza limite di età;
  • until che dipende dallo store;
  • italiano nel file JS nuovo.

Comandi eseguiti:

  • dotnet build Febe.slnx -warnaserror: 0 avvisi, 0 errori.
  • dotnet test tests/Febe.Tests --no-build --filter "FullyQualifiedName~Febe.Tests.Packaging": 19 superate, 2 saltate (sono le prove che girano solo su Linux), 0 fallite.
  • dotnet test tests/Febe.Tests --no-build --filter "FullyQualifiedName~Febe.Tests.Docs": 17 superate.
  • bash .gitea/scripts/controlli.sh: superati.
  • bash -n sui 20 blocchi run: | di verifica.yml, rilascio.yml e pulizia.yml: nessun errore.

I file temporanei stanno in B:\Altro\Sviluppo.febe-lavoro\revisione-pulizia.

Non verificato:

  • le prove nuove su Linux, nel contenitore node:24-trixie;
  • il demone Docker vero: quale store usa e i formati che stampa;
  • i nomi che dà questo act_runner;
  • l'API dei pacchetti con un token vero;
  • quanta parte del registro occupano davvero i manifest figli.

Rilievi ed esito

Rilievo Gravità Esito
F1 (.gitea/scripts/pulizia-docker.sh:559): Sul registro la pulizia toglie solo le versioni sha-*, cioè i manifest indice. Gli strati dell'immagine restano nei manifest figli, che Gitea tiene come versioni separate sha256:…. Lo script non le tocca mai e Gitea non le toglie da sola, quindi il registro non si alleggerisce. In più i documenti dicono il contrario: «Una regola di pulizia dei pacchetti di Gitea non serve» (docs/processo.md:138) e «i blob rimasti senza riferimenti li toglie la pulizia dei pacchetti di Gitea» (riga di docs/decisioni.md:284). Importante Corretto: Vero, controllato sul codice di Gitea release/v28: processOciImageManifest lega configurazione e strati alla versione del manifest stesso, processOciImageIndex salva solo l'indice; con l'attestazione predefinita di buildx ogni :sha- era un indice e gli strati restavano nelle versioni sha256:… senza etichetta. Strada (c): costruisci-immagine.sh costruisce con --provenance=false --sbom=false (archivio provato e spinta): ogni etichetta è un manifest semplice con i suoi strati, e i blob che nessuna versione usa li cancella [cron.cleanup_packages] (attivo per impostazione predefinita, @midnight, 24h, verificato in app.example.ini v28). Le versioni sha256:… lo script non le tocca mai (l'API non dice se un indice le rimanda) ma ne scrive il numero, anche nella prova (nuovo modo «senza-etichetta» di versioni-registro.js). processo.md spiega quale regola di pulizia di Gitea le toglierebbe (schema sha256:.+, 7 giorni; ShouldBeSkipped salta quelle rimandate e sempre latest). Corretti processo.md e la riga di decisioni che dicevano il contrario; nuova riga sulle attestazioni. Al JSON di prova ho aggiunto due manifest figli e uno di un altro pacchetto; le prove controllano che non parta nessun DELETE di sha256: e che la riga col conteggio compaia.
F2 (.gitea/scripts/pulizia-docker.sh:63): Se la scelta della prova sbaglia, parte la pulizia vera. Lo script riconosce solo --prova esatto e ignora in silenzio qualunque altro argomento. Il flusso considera prova solo il testo esatto «true». Qualunque altra opzione o valore fa partire la pulizia completa vera, con codice 0. Importante Corretto: Riprodotto sul demone finto: «completa --dry-run», «-n» e «prova» lanciavano rm, volume rm, image prune -a e builder prune -a con codice 0. Ora lo script controlla tutti gli argomenti prima di chiamare Docker: un'opzione diversa da --prova o un argomento in più danno codice 2 e l'uso, senza nessuna chiamata. pulizia.yml usa un case: «true» è la prova, «false» o vuoto la pulizia vera, qualunque altro valore dà ::error:: (valore ripulito) ed exit 2. Ho verificato sul codice v28 (ActionsDispatchWorkflow) che l'API passa il valore senza convertirlo. Prove nuove: il blocco run vero eseguito con uno script finto per 9 valori; 10 argomenti sbagliati, codice 2 e 0 chiamate a docker. Ho controllato che le prove falliscano con un passo e uno script volutamente indeboliti.
F3 (.gitea/scripts/pulizia-docker.sh:458): docker image prune -a non toglie un'immagine usata da un contenitore, ma le toglie i nomi in più. La prova salta del tutto ogni immagine in uso (riga 458), quindi non elenca quei nomi. La riga «mai» di docs/processo.md:173 e fake-docker.sh, dove prune -a ignora le immagini usate, li danno per intoccati. Minore Corretto: Vero, controllato su moby v24.0.9, v27.5.1 e master. Con lo store classico ImagesPrune non guarda i contenitori: ImageDelete toglie i nomi in ordine lessicale del nome completo e rifiuta solo l'ultimo. Con containerd restano solo i nomi di Config.Image. La pulizia vera ora confronta i nomi prima e dopo e scrive «tolto il nome X; l'immagine … resta». La prova li stima secondo lo store («toglierei il nome X; l'immagine … resta, perché la usa un contenitore») e li conta. fake-docker.sh modella tutti e due gli store. Nel mondo di prova c'è un Jellyfin creato da :10.9 che si chiama anche :latest: con lo store classico perde :10.9, con containerd perde :latest, e le prove controllano che stima e pulizia vera coincidano in entrambi. Ho corretto la riga «mai» e aggiunto la voce di costo in processo.md, docker.md, l'intestazione dello script e una riga di decisioni. Il comando resta quello chiesto.
F4 (.gitea/scripts/pulizia-docker.sh:637): Alla fine di ogni lavoro «immagine», cioè a ogni push di ogni ramo, docker builder prune -f senza filtro toglie dal builder del demone ogni voce di cache non usata e non condivisa con un'immagine, di qualunque età e di tutti i progetti: cache montate (RUN --mount=type=cache), strati intermedi, contesti. Alla cache di Febe non serve: stava nel builder dell'esecuzione, già tolto. In più vanifica la finestra di 24 ore scelta per il builder prune -a --filter until=24h del lunedì. La premessa del compito («safe for everyone») non regge, come dice la riga di decisioni dell'autore stesso. Minore Corretto: Vero (cache/manager.go di BuildKit; la mia stessa riga di decisioni lo diceva). Il passo di ogni esecuzione ora usa «docker builder prune -f --filter until=24h»: stessa finestra del lunedì, BuildKit la confronta con l'ultimo uso, e le costruzioni degli altri progetti ritrovano la cache usata nelle ultime 24 ore. Le immagini senza nome restano senza filtro. Il compito chiedeva il comando senza filtro e la revisione lascia la scelta ad Alberto: l'ho scritto nella riga di decisioni e nel commit, e per tornarci basta togliere il filtro. Aggiornati script, demone finto, prove, flussi (commenti), processo.md, guida Sviluppo e CLAUDE.md.
F5 (docs/processo.md:181): «Le 24 ore sono l'età dell'immagine, cioè da quando è stata costruita, non da quando è arrivata sul demone» (anche nella riga di decisioni.md:282) vale solo per lo store classico. Con lo store di containerd, predefinito nelle installazioni nuove di Docker Engine 29 e successive, until confronta il CreatedAt del record dell'immagine sul demone, e containerd lo conserva quando lo stesso nome viene riscaricato. La prova invece calcola l'età da {{.Created}} della configurazione (riga 459), quindi prova e pulizia vera possono dare risultati diversi, nei due sensi. Minore Corretto: Vero: con lo store classico until confronta img.Created, con containerd image.CreatedAt (image_list.go), e docker image ls dà comunque il Created della configurazione, quindi nessun comando mostra l'età che conta. Nei modi «settimanale» e «completa» la pulizia legge lo store con docker info --format '{{json .DriverStatus}}' (io.containerd.snapshotter.v1) e lo scrive all'inizio; con containerd, o se non lo sa, la prova avverte che le età elencate sono solo indicative. processo.md spiega i due casi, comprese le immagini con data fissa (SOURCE_DATE_EPOCH) e i nomi riscaricati. Nuova riga di decisioni. Il demone finto risponde come l'uno e come l'altro store, e c'è una prova per containerd.
F6 (.gitea/scripts/versioni-registro.js:16): Il file nuovo ha identificatori e commenti in italiano (tenere, pagine, etichettaSha, candidate e i commenti), contro la regola di CLAUDE.md «Codice e commenti in inglese». Segue l'uso degli script di shell già presenti in .gitea, e l'autore lo ha segnalato, ma nessuna riga di decisioni registra l'eccezione. Minore Corretto: Ho tradotto versioni-registro.js: identificatori e commenti in inglese, messaggi in italiano come tutti quelli della CI. Il comportamento non cambia: sulle pagine del JSON di prova l'uscita è identica byte per byte tenendone 0, 10 e 20, e gli errori escono ancora con 2. Gli script di shell di .gitea erano in italiano già prima del ramo e restano così; non ho aggiunto una riga di eccezione: se registrarla, o tradurli, lo decide chi integra.

🤖 Generated with Claude Code

## Revisione avversaria Un revisore indipendente ha letto tutto il ramo e ha rifatto compilazione e prove; l'autore ha poi verificato ogni rilievo prima di correggerlo o respingerlo. **Giudizio del revisore** Lavoro accurato, da unire dopo aver sistemato i due rilievi importanti. **Che cosa regge.** Le verifiche le ho fatte nel worktree, senza modificarlo: - La prova con `--prova` esatto fa solo letture, e sul registro solo GET. - Il passo di ogni esecuzione non può far diventare rosso un lavoro. - La scelta delle `sha-` non può toccare `main`, `latest` o `X.Y.Z`, legge tutte le pagine fino a quella vuota e non dipende dall'ordine. - Il token non compare nel registro del lavoro. - Contenitori, volumi e reti che non sono della CI non vengono mai presi di mira, nemmeno con un tentativo. - Sul codice di Gitea release/v28 ho controllato `GET /packages/{owner}/container/febe?page&limit` e `DELETE …/{version}` (risponde 204), e l'input booleano di workflow_dispatch, che arriva come «true»/«false». - Sul codice di moby e BuildKit ho controllato come funzionano `until`, `image prune -a` e il prune della cache senza `-a`. **I due rilievi importanti:** 1. **Registro.** Si tolgono solo i manifest indice delle `sha-`. Gli strati restano nei manifest figli `sha256:`, prodotti dalle attestazioni predefinite di buildx, e nessuno li toglie. Intanto i documenti dicono che la regola di pulizia di Gitea non serve. 2. **Prova.** Si attiva solo con il testo esatto. A mano `--dry-run`, `-n` o `prova`, oppure via API un valore diverso da «true», fanno partire la pulizia vera con codice 0: l'ho provato sul demone finto. Gli altri quattro rilievi sono minori: - nomi in più tolti alle immagini in uso, che la prova non elenca; - il prune della cache a ogni esecuzione, senza limite di età; - `until` che dipende dallo store; - italiano nel file JS nuovo. **Comandi eseguiti:** - `dotnet build Febe.slnx -warnaserror`: 0 avvisi, 0 errori. - `dotnet test tests/Febe.Tests --no-build --filter "FullyQualifiedName~Febe.Tests.Packaging"`: 19 superate, 2 saltate (sono le prove che girano solo su Linux), 0 fallite. - `dotnet test tests/Febe.Tests --no-build --filter "FullyQualifiedName~Febe.Tests.Docs"`: 17 superate. - `bash .gitea/scripts/controlli.sh`: superati. - `bash -n` sui 20 blocchi `run: |` di verifica.yml, rilascio.yml e pulizia.yml: nessun errore. I file temporanei stanno in B:\Altro\Sviluppo\.febe-lavoro\revisione-pulizia. **Non verificato:** - le prove nuove su Linux, nel contenitore node:24-trixie; - il demone Docker vero: quale store usa e i formati che stampa; - i nomi che dà questo act_runner; - l'API dei pacchetti con un token vero; - quanta parte del registro occupano davvero i manifest figli. **Rilievi ed esito** | Rilievo | Gravità | Esito | |---|---|---| | **F1** (.gitea/scripts/pulizia-docker.sh:559): Sul registro la pulizia toglie solo le versioni `sha-*`, cioè i manifest indice. Gli strati dell'immagine restano nei manifest figli, che Gitea tiene come versioni separate `sha256:…`. Lo script non le tocca mai e Gitea non le toglie da sola, quindi il registro non si alleggerisce. In più i documenti dicono il contrario: «Una regola di pulizia dei pacchetti di Gitea non serve» (docs/processo.md:138) e «i blob rimasti senza riferimenti li toglie la pulizia dei pacchetti di Gitea» (riga di docs/decisioni.md:284). | Importante | Corretto: Vero, controllato sul codice di Gitea release/v28: processOciImageManifest lega configurazione e strati alla versione del manifest stesso, processOciImageIndex salva solo l'indice; con l'attestazione predefinita di buildx ogni :sha- era un indice e gli strati restavano nelle versioni sha256:… senza etichetta. Strada (c): costruisci-immagine.sh costruisce con --provenance=false --sbom=false (archivio provato e spinta): ogni etichetta è un manifest semplice con i suoi strati, e i blob che nessuna versione usa li cancella [cron.cleanup_packages] (attivo per impostazione predefinita, @midnight, 24h, verificato in app.example.ini v28). Le versioni sha256:… lo script non le tocca mai (l'API non dice se un indice le rimanda) ma ne scrive il numero, anche nella prova (nuovo modo «senza-etichetta» di versioni-registro.js). processo.md spiega quale regola di pulizia di Gitea le toglierebbe (schema sha256:.+, 7 giorni; ShouldBeSkipped salta quelle rimandate e sempre latest). Corretti processo.md e la riga di decisioni che dicevano il contrario; nuova riga sulle attestazioni. Al JSON di prova ho aggiunto due manifest figli e uno di un altro pacchetto; le prove controllano che non parta nessun DELETE di sha256: e che la riga col conteggio compaia. | | **F2** (.gitea/scripts/pulizia-docker.sh:63): Se la scelta della prova sbaglia, parte la pulizia vera. Lo script riconosce solo `--prova` esatto e ignora in silenzio qualunque altro argomento. Il flusso considera prova solo il testo esatto «true». Qualunque altra opzione o valore fa partire la pulizia completa vera, con codice 0. | Importante | Corretto: Riprodotto sul demone finto: «completa --dry-run», «-n» e «prova» lanciavano rm, volume rm, image prune -a e builder prune -a con codice 0. Ora lo script controlla tutti gli argomenti prima di chiamare Docker: un'opzione diversa da --prova o un argomento in più danno codice 2 e l'uso, senza nessuna chiamata. pulizia.yml usa un case: «true» è la prova, «false» o vuoto la pulizia vera, qualunque altro valore dà ::error:: (valore ripulito) ed exit 2. Ho verificato sul codice v28 (ActionsDispatchWorkflow) che l'API passa il valore senza convertirlo. Prove nuove: il blocco run vero eseguito con uno script finto per 9 valori; 10 argomenti sbagliati, codice 2 e 0 chiamate a docker. Ho controllato che le prove falliscano con un passo e uno script volutamente indeboliti. | | **F3** (.gitea/scripts/pulizia-docker.sh:458): `docker image prune -a` non toglie un'immagine usata da un contenitore, ma le toglie i nomi in più. La prova salta del tutto ogni immagine in uso (riga 458), quindi non elenca quei nomi. La riga «mai» di docs/processo.md:173 e fake-docker.sh, dove prune -a ignora le immagini usate, li danno per intoccati. | Minore | Corretto: Vero, controllato su moby v24.0.9, v27.5.1 e master. Con lo store classico ImagesPrune non guarda i contenitori: ImageDelete toglie i nomi in ordine lessicale del nome completo e rifiuta solo l'ultimo. Con containerd restano solo i nomi di Config.Image. La pulizia vera ora confronta i nomi prima e dopo e scrive «tolto il nome X; l'immagine … resta». La prova li stima secondo lo store («toglierei il nome X; l'immagine … resta, perché la usa un contenitore») e li conta. fake-docker.sh modella tutti e due gli store. Nel mondo di prova c'è un Jellyfin creato da :10.9 che si chiama anche :latest: con lo store classico perde :10.9, con containerd perde :latest, e le prove controllano che stima e pulizia vera coincidano in entrambi. Ho corretto la riga «mai» e aggiunto la voce di costo in processo.md, docker.md, l'intestazione dello script e una riga di decisioni. Il comando resta quello chiesto. | | **F4** (.gitea/scripts/pulizia-docker.sh:637): Alla fine di ogni lavoro «immagine», cioè a ogni push di ogni ramo, `docker builder prune -f` senza filtro toglie dal builder del demone ogni voce di cache non usata e non condivisa con un'immagine, di qualunque età e di tutti i progetti: cache montate (`RUN --mount=type=cache`), strati intermedi, contesti. Alla cache di Febe non serve: stava nel builder dell'esecuzione, già tolto. In più vanifica la finestra di 24 ore scelta per il `builder prune -a --filter until=24h` del lunedì. La premessa del compito («safe for everyone») non regge, come dice la riga di decisioni dell'autore stesso. | Minore | Corretto: Vero (cache/manager.go di BuildKit; la mia stessa riga di decisioni lo diceva). Il passo di ogni esecuzione ora usa «docker builder prune -f --filter until=24h»: stessa finestra del lunedì, BuildKit la confronta con l'ultimo uso, e le costruzioni degli altri progetti ritrovano la cache usata nelle ultime 24 ore. Le immagini senza nome restano senza filtro. Il compito chiedeva il comando senza filtro e la revisione lascia la scelta ad Alberto: l'ho scritto nella riga di decisioni e nel commit, e per tornarci basta togliere il filtro. Aggiornati script, demone finto, prove, flussi (commenti), processo.md, guida Sviluppo e CLAUDE.md. | | **F5** (docs/processo.md:181): «Le 24 ore sono l'età dell'immagine, cioè da quando è stata costruita, non da quando è arrivata sul demone» (anche nella riga di decisioni.md:282) vale solo per lo store classico. Con lo store di containerd, predefinito nelle installazioni nuove di Docker Engine 29 e successive, `until` confronta il CreatedAt del record dell'immagine sul demone, e containerd lo conserva quando lo stesso nome viene riscaricato. La prova invece calcola l'età da `{{.Created}}` della configurazione (riga 459), quindi prova e pulizia vera possono dare risultati diversi, nei due sensi. | Minore | Corretto: Vero: con lo store classico until confronta img.Created, con containerd image.CreatedAt (image_list.go), e docker image ls dà comunque il Created della configurazione, quindi nessun comando mostra l'età che conta. Nei modi «settimanale» e «completa» la pulizia legge lo store con docker info --format '{{json .DriverStatus}}' (io.containerd.snapshotter.v1) e lo scrive all'inizio; con containerd, o se non lo sa, la prova avverte che le età elencate sono solo indicative. processo.md spiega i due casi, comprese le immagini con data fissa (SOURCE_DATE_EPOCH) e i nomi riscaricati. Nuova riga di decisioni. Il demone finto risponde come l'uno e come l'altro store, e c'è una prova per containerd. | | **F6** (.gitea/scripts/versioni-registro.js:16): Il file nuovo ha identificatori e commenti in italiano (`tenere`, `pagine`, `etichettaSha`, `candidate` e i commenti), contro la regola di CLAUDE.md «Codice e commenti in inglese». Segue l'uso degli script di shell già presenti in .gitea, e l'autore lo ha segnalato, ma nessuna riga di decisioni registra l'eccezione. | Minore | Corretto: Ho tradotto versioni-registro.js: identificatori e commenti in inglese, messaggi in italiano come tutti quelli della CI. Il comportamento non cambia: sulle pagine del JSON di prova l'uscita è identica byte per byte tenendone 0, 10 e 20, e gli errori escono ancora con 2. Gli script di shell di .gitea erano in italiano già prima del ramo e restano così; non ho aggiunto una riga di eccezione: se registrarla, o tradurli, lo decide chi integra. | 🤖 Generated with [Claude Code](https://claude.com/claude-code)
Alby96 merged commit b74d2db793 into main 2026-10-21 14:25:16 +02:00
Alby96 deleted branch ci/pulizia-immagini-inutilizzate 2026-10-21 14:25:18 +02:00
Sign in to join this conversation.
No Reviewers
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: Alby96/Febe#9