Deep Dive: Trivy – scansionare ogni immagine in esecuzione ogni notte e leggere 241 finding senza panico

Come Trivy trova vulnerabilità note nelle immagini container, perché qui gira come timer notturno invece che come operator, cosa ha trovato la prima scansione del blog – e come smistare 241 finding "correggibili" nei pochi che richiedono un intervento.

Illustrazione per la serie Deep Dive

🌐 Anche in: English · Deutsch · Français · Español · Português · Nederlands · Polski

Deep Dive della serie legata all’Ansible Tour. Il tour spiega i ruoli, i deep dive la tecnologia sottostante: come funziona, perché qui viene usata così e cosa è andato storto lungo la strada.

Ogni immagine in questo setup è fissata a una versione esatta. È un bene per la riproducibilità e un male per la sicurezza in un modo ben preciso: un’immagine fissata non migliora da sola. I pacchetti Debian o Alpine al suo interno invecchiano, il runtime Go con cui è stato compilato un binario invecchia, e ogni giorno vengono pubblicate nuove vulnerabilità per software che non è cambiato affatto. L’host riceve i suoi aggiornamenti di sicurezza ogni notte da dnf-automatic; le immagini non ricevevano nulla – finché qualcuno non ci guardava. Ora Trivy ci guarda ogni notte. Questo post spiega come trova le vulnerabilità, come gira sul blog dal 19 ottobre 2026, cosa ha trovato la prima scansione – 241 finding correggibili – e perché quel numero è molto meno allarmante di quanto sembri, una volta smistato.

Indice

🧭 Come funziona Trivy

Prima l’inventario, poi una ricerca nel database

Trivy non esegue né attacca nulla. Legge un’immagine strato per strato e costruisce un inventario: quale sistema operativo e release (Debian 13, Alpine 3.21, Ubuntu 22.04 …), quali pacchetti in quali versioni esatte dal database del package manager, e quali dipendenze di linguaggio sono compilate nei binari o elencate nei lock file – moduli Go letti dalle build information che ogni binario Go porta con sé, npm, pip, Composer, Java e così via. Poi confronta questo inventario con il suo database delle vulnerabilità.

Il database è costruito dal progetto Trivy a partire da molte fonti – i security tracker delle distribuzioni, il GitHub Advisory Database, il database delle vulnerabilità di Go e altre – e scaricato come un unico file di qualche centinaio di megabyte. Per ogni pacchetto sa quali versioni sono colpite da quale CVE e, se esiste, in quale versione il problema è risolto.

Severity e “fixed version” – i due campi che contano

  • Severity (CRITICAL, HIGH, MEDIUM, LOW, UNKNOWN) viene dalla fonte – spesso la valutazione della distribuzione stessa, altrimenti un punteggio CVSS. Descrive la vulnerabilità in generale, non il suo rischio in questa immagine. Un bug CRITICAL in una libreria che l’immagine non chiama mai è comunque elencato come CRITICAL.
  • Fixed version dice se esiste una correzione. Senza, non si può fare nulla se non accettare il finding o sostituire il software. Con una, la domanda diventa: chi deve distribuirla – la distribuzione (già fatto), il maintainer dell’immagine (serve un rebuild) o il progetto upstream (serve una nuova release)?

Questa distinzione è la chiave di tutto ciò che segue. Trivy riporta ciò che è noto; non può sapere se il percorso di codice vulnerabile è raggiungibile. Leggere i risultati è quindi sempre un secondo passo fatto da un essere umano.

Da dove arriva l’immagine

Trivy può leggere un’immagine da un registry (remote), da un daemon Docker o Podman locale, da un file tar – oppure direttamente da containerd, il runtime che usa K3s. L’ultima opzione significa: nessun secondo download, la scansione vede esattamente l’immagine che fanno girare i pod. In questo setup servono il socket e il namespace di K3s:

CONTAINERD_ADDRESS=/run/k3s/containerd/containerd.sock \
CONTAINERD_NAMESPACE=k8s.io \
trivy image --image-src containerd docker.io/library/mariadb:10.11.19

🛡️ Perché è qui

  • Le immagini fissate invecchiano in silenzio. L’image refresh nei playbook di aggiornamento scarica le immagini ricompilate sotto lo stesso tag – ma niente ci diceva quando un rebuild ne valesse la pena, o quando un’immagine non ne avrebbe mai avuto uno.
  • L’host era coperto, i container no. dnf-automatic aggiorna l’host ogni notte; le 14 immagini che compongono il cluster erano fuori da quel ciclo.
  • Le decisioni hanno bisogno di dati. “Dovremmo cambiare questo exporter?” o “Un aggiornamento di K3s è urgente?” sono domande più facili con una lista di ciò che ogni immagine contiene davvero.

🔧 Cosa fa questo repository

Un timer sull’host, non un operator nel cluster

Il modo abituale di far girare Trivy in Kubernetes è il Trivy Operator: osserva il cluster, avvia un job di scansione per ogni workload e salva i risultati come custom resource. Su un unico piccolo nodo significherebbe CRD, un controller, pod di scansione – e per ognuno di essi eccezioni nella image policy e nelle NetworkPolicy che questo setup applica. Il ruolo common_trivy fa lo stesso lavoro con un binario e uno script: un timer systemd avvia trivy_scan.py ogni notte alle 05:15, dopo gli aggiornamenti di sicurezza (01:00–02:00), la finestra di riavvio (03:30) e gli altri job notturni.

Il binario: fissato e con checksum

Trivy viene installato dall’archivio di release su GitHub, con la versione e il suo SHA-256 fissati in versions.yml. Quel secondo pin ha un motivo concreto: a marzo 2026 la stessa pipeline di release di Trivy è stata compromessa e ha distribuito per breve tempo una build malevola (advisory GHSA-69fq-xp46-6x23). Uno scanner di sicurezza gira come root e legge tutto – è esattamente lo strumento di cui vuoi essere sicuro. La regola negli appunti: aggiornare solo a una release vecchia di almeno due settimane, e copiare il checksum dal file dei checksum di quella release. Il get_url di Ansible rifiuta un archivio il cui hash non corrisponde.

Due piccole cose in cui si è imbattuta l’installazione, entrambe volute altrove: /tmp è montato noexec dall’hardening CIS, quindi l’archivio viene estratto da /root; e dopo l’estrazione, restorecon dà al binario la sua etichetta SELinux corretta – i file scritti passando per un percorso temporaneo altrimenti mantengono l’etichetta di quel percorso, la stessa lezione del binario di k3s.

Lo script

  1. Aggiorna il database delle vulnerabilità una volta (--download-db-only); tutte le scansioni delle immagini girano poi con --skip-db-update.
  2. Elenca le immagini di tutti i pod in esecuzione. I pod terminati di Job e CronJob vengono esclusi – la prima versione li includeva, e un job helm-install eseguito una volta all’avvio del cluster contribuiva con 32 finding per un’immagine che non gira.
  3. Scansiona ogni immagine da containerd. Se fallisce, riprova dal registry (vedi sotto). Scrive un report JSON per immagine in /var/lib/trivy/reports.
  4. Scrive metriche per il textfile collector di node_exporter: trivy_image_vulnerabilities{image, severity, fixable}, trivy_image_scan_ok, trivy_db_update_ok, trivy_last_run_timestamp_seconds. Il file viene scritto con un nome temporaneo e poi rinominato, così node_exporter non ne legge mai metà.
  5. Confronta i finding CRITICAL e HIGH correggibili con quelli della notte precedente e manda per mail solo quelli nuovi.

Perché una mail per i nuovi finding e nessun alert

Il design ovvio sarebbe un alert Grafana “vulnerabilità critica con correzione disponibile”. La prima scansione ha mostrato perché sarebbe sbagliato: l’immagine di MariaDB contiene gosu, un minuscolo helper scritto in Go, compilato con una versione di Go più vecchia che ha una vulnerabilità CRITICAL nella sua libreria standard. Correggerla spetta ai maintainer dell’immagine MariaDB. Un alert scatterebbe, si ripeterebbe ogni quattro ore, e continuerebbe così per giorni o settimane – finché non viene ignorato, e con lui ogni altro alert. La mail lo dice una volta. Un finding che resta non manda un’altra mail; uno che sparisce viene contato come “risolto”. Grafana dà l’allarme solo quando la scansione stessa è rotta: aggiornamento del database o scansione di un’immagine falliti, oppure l’ultimo run riuscito è più vecchio di 36 ore.

Il succo: un alert è adatto a stati che puoi correggere subito. Per finding che spesso nessuno può correggere subito, una mail su ciò che è nuovo funziona meglio di un alert che resta rosso e quindi non interessa più a nessuno.

Accettare un finding

Alcuni finding verranno accettati di proposito. Finiscono nella variabile trivy_ignore, ognuno con un motivo obbligatorio, e arrivano in un file .trivyignore che la scansione usa. La lista è vuota di proposito: ogni voce è una decisione, non un default.

SELinux e il textfile collector

node_exporter gira dallo stesso giorno in un suo dominio SELinux (dopo una fase di apprendimento in permissive, enforcing dal 20/21 ottobre). La sua directory textfile /var/lib/node_exporter/textfile ha ottenuto un suo tipo, homelab_node_exporter_textfile_t, con esattamente due regole: l’exporter può elencare la directory e leggere i file. La scansione, che gira come root, li scrive; i nuovi file ereditano il tipo della directory.

🔍 Cosa hanno trovato i primi run – sullo strumento stesso

Layer che containerd aveva già buttato via

Due immagini su 15 sono fallite nel primo run: metrics-server e kube-state-metrics, con “content digest … not found”. containerd estrae i layer delle immagini in snapshot e può scartare in seguito i blob compressi dei layer; l’immagine gira benissimo, ma non può più essere esportata per intero. Trivy offre --image-src containerd,remote come lista di fallback – che non è servita, perché ripiega solo quando l’immagine manca nella prima fonte, non quando manca un layer. Lo script ora riprova esplicitamente con remote proprio per quelle immagini.

Il succo: chi legge dati dal runtime si imbatte nelle lacune che il runtime lascia di proposito. Una seconda strada – l’immagine dal registry – rende la scansione robusta.

Un AVC, trovato dagli alert sui log dello stesso giorno

La prima versione della unit di scansione aveva NoNewPrivileges=yes. Lo script chiama k3s kubectl per elencare i pod, e il binario k3s passa nel dominio SELinux container_runtime_t. Sotto NoNewPrivileges, SELinux rifiuta quella transizione a meno che la policy non la consenta esplicitamente, e registra avc: denied { nnp_transition }. Il nuovo alert di Loki per i veri denial SELinux è scattato nel giro di pochi minuti. L’impostazione è sparita; la unit mantiene le altre restrizioni di systemd (/usr e /etc in sola lettura, nessuna home directory, /tmp privato, priorità minima di CPU e I/O, limite di memoria di 2 GB).

Il succo: ogni nuova unit con NoNewPrivileges che avvia un programma con un proprio dominio SELinux si fa controllare l’audit log dopo il primo run.

📊 Leggere 241 finding

Dopo le correzioni la scansione riportava 209 finding CRITICAL/HIGH correggibili su 14 immagini in esecuzione. Smistati per chi può correggerli, il quadro cambia completamente:

GruppoFindingChi può correggerliAzione
php-fpm_exporter 2.2.072 (5 dei 6 CRITICAL)Nessuno: ultima release nel 2022, ancora su OpenSSL 1.1Sostituire, ricompilare o rimuovere – una decisione, vedi sotto
MariaDB 10.11.1926Maintainer dell’immagine: un rebuild sotto lo stesso tag è già pubblicato (libssl3)Image refresh nel playbook di aggiornamento; gosu resta finché upstream non lo ricompila
WordPress 7.1.3 (php8.4-fpm)32Debian ha corretto curl, ghostscript, expat; l’immagine ufficiale non è stata più ricompilata da alloraAspettare – l’image refresh prende automaticamente il prossimo rebuild
nginx, Redis (Alpine)4Idem: correzioni in Alpine, immagine non ancora ricompilataAspettare
Binari Go: CoreDNS, metrics-server, cert-manager, kube-state-metrics, mysqld_exporter75Progetti upstream: nuove release con un Go più recente e moduli più recentiGià sulle release più nuove; quelli inclusi in K3s arrivano con il prossimo K3s

Tre lezioni da quella tabella:

  • La maggior parte dei finding non richiede alcuna azione da parte nostra. Sono corretti da qualche parte a monte e arriveranno con il prossimo rebuild o la prossima release, che i playbook di aggiornamento già prendono.
  • Un’immagine è un problema vero. Un exporter che non ha una release da quattro anni e distribuisce ancora OpenSSL 1.1 è responsabile di quasi un terzo di tutti i finding e di quasi tutti quelli CRITICAL. La sua esposizione pratica è piccola – parla solo FastCGI con PHP-FPM dentro il pod e serve metriche dentro il cluster, dietro le NetworkPolicy – ma “esposizione piccola” non è un motivo per tenersi per sempre software abbandonato.
  • “Corretto” non significa “rilevante”. L’immagine di WordPress elenca linux-libc-dev, gli header del kernel – un container usa il kernel dell’host, gli header ci sono solo per compilare. Un candidato per trivy_ignore, esattamente con quel motivo.

È sorta subito una domanda: esiste un’immagine WordPress più recente che corregge i suoi 32 finding? No. WordPress 7.1.3 è la release attuale, e l’immagine 7.1.3-php8.4-fpm sul blog ha lo stesso digest di quella nel registry. Debian ha pubblicato i pacchetti corretti, ma l’immagine ufficiale non è stata più ricompilata da allora. Costruire una propria immagine con un apt-get upgrade in più la correggerebbe oggi – al prezzo di dover mantenere una build di immagine per sempre. Aspettare qualche giorno il rebuild ufficiale è lo scambio migliore.

Cosa fare con una mail

  1. L’immagine è stata ricompilata upstream sotto lo stesso tag? Allora il prossimo run di aggiornamento (image refresh) la corregge – oppure lancia subito il playbook di aggiornamento.
  2. C’è una release più recente? Allora alza il pin in versions.yml, idealmente a una vecchia di qualche giorno.
  3. Nessuna delle due? Allora è un finding da accettare (con un motivo in trivy_ignore) o un motivo per sostituire il software.

Costo

Il database delle vulnerabilità e la cache dei layer occupano circa 1,6 GB sotto /var/cache/trivy. Un run notturno completo, download del database compreso, richiede meno di mezzo minuto di CPU sul blog; i run successivi riusano l’analisi dei layer in cache e durano pochi secondi. La scansione gira con la priorità minima di CPU e I/O e un limite di memoria di 2 GB, quindi non può rallentare i siti.

🆘 Cheat sheet: sintomo → comando

La versione breve di questo articolo per il momento in cui qualcosa non va. Da eseguire sull’host come root; <…> sono segnaposto.

SintomoComando
La scansione è partita?systemctl list-timers trivy-scan.timer
journalctl -u trivy-scan -n 20 | grep "images scanned"
Lanciala adessosystemctl start trivy-scan.service
Cosa è aperto in questo momento?python3 -c 'import json; [print(v["severity"], v["id"], v["pkg"], v["image"]) for v in json.load(open("/var/lib/trivy/last-findings.json")).values()]' | sort
Un’immagine nel dettagliotrivy image --image-src containerd --skip-db-update <image>:<tag>
Una mail su un finding CRITICAL# 1. rebuilt upstream under the same tag? -> next update run
# 2. newer release? -> raise the pin in versions.yml
# 3. neither -> trivy_ignore with a reason
Risultati della scansione troppo vecchi(time() - trivy_last_run_timestamp_seconds) / 3600
Spazio su disco usato dalla cachedu -sh /var/cache/trivy

🔭 Cosa viene dopo

  • Una decisione sull’exporter PHP-FPM entro il 20 gennaio 2027, quando scade la sua accettazione: due fork gestiti da una sola persona sono attivi (uno con aggiornamenti automatici delle dipendenze); altrimenti prorogare l’accettazione.
  • Scansione della configurazione – provata una volta a ottobre 2026 sui manifest live del blog: 21 tipi di finding, quasi tutti decisioni volute (ingress sulla rete dell’host, volumi hostPath, immagini che girano come root). Come job di CI richiederebbe template renderizzati e una lunga lista di ignore; per ora non ne vale la pena.
  • La scansione dei segreti è già nella CI: gitleaks controlla l’intera storia git a ogni push, accanto all’hook di pre-commit.
  • Una piccola dashboard con l’andamento dei finding aperti per immagine.

🎯 Le lezioni

  • Le immagini fissate invecchiano in silenzio. La scansione deve controllare le immagini in esecuzione, non la lista nel repository.
  • Smista i finding per chi può correggerli, non per il loro numero.
  • Per la decisione conta più “fixed in” della severity.
  • I finding accettati hanno un motivo e una data di scadenza.
  • Anche lo scanner stesso ha bisogno di un pin con checksum – la sua stessa pipeline di release è stata compromessa nel 2026.

⚖️ Alternative – e perché Trivy

OpzionePunto di forzaPerché non qui
Trivy OperatorContinuo, risultati come risorse KubernetesController, CRD e pod di scansione su un unico piccolo nodo; eccezioni nella image policy e nelle NetworkPolicy.
Grype (Anchore)Veloce, buona integrazione SBOM con SyftParagonabile; Trivy legge containerd direttamente e copre più ecosistemi in un solo binario.
Scansione nel registry (Harbor/Clair, Docker Scout, GitHub)Scansiona al momento del pushQui non c’è un registry proprio – le immagini arrivano da Docker Hub, Quay e registry.k8s.io così come pubblicate.
dnf updateinfo / OpenSCAPPreciso per l’hostCopre solo i pacchetti dell’host, non ciò che c’è dentro le immagini.
Trivy, come timer notturno sull’hostUn binario, legge le immagini in esecuzione da containerd, metriche + mailScelto.

Il senso dello strumento non è il numero che riporta, ma lo smistamento che rende possibile. 241 finding sembravano un’emergenza. Smistati per chi può correggerli, si sono trasformati in una decisione vera, un image refresh – e tanta attesa per upstream, che la routine di aggiornamento esistente già gestisce.

Alcuni testi e immagini di questo sito sono creati con l’aiuto dell’IA o generati dall’IA. Dettagli