
GitLab CI-Komponente für Trivy-Scans
Eine GitLab-CI-Komponente für Trivy — den All-in-One-Sicherheitsscanner für Container-Images, Dateisysteme, Repositories, Kubernetes-Cluster, SBOMs und Lizenz-Compliance. Binden Sie diese Vorlagen direkt in Ihre Pipelines ein, um reproduzierbare Scans, GitLab-native Berichte und portable Artefakte mit nahezu keinem Shell-Skripting zu erhalten.
include:
- component: $CI_SERVER_FQDN/niclas-zone/ci/trivy/main@latest
stages:
- test
include:
- component: $CI_SERVER_FQDN/niclas-zone/ci/trivy/main@latest
inputs:
job_name: "security:remote"
TRIVY_SCAN_REMOTE_IMAGE: "registry.gitlab.com/group/app:latest"
severity: "CRITICAL,HIGH,MEDIUM"
exit_on_vulnerability: true
stages:
- test
include:
- component: $CI_SERVER_FQDN/niclas-zone/ci/trivy/main@latest
inputs:
job_name: "security:local"
TRIVY_SCAN_LOCAL_IMAGES: "dist/"
TRIVY_SCANNERS: "vuln,secret"
exit_on_vulnerability: false
stages:
- test
Jede der folgenden Vorlagen listet ihre verfügbaren Eingaben und Standardwerte gemäß der Komponentenspezifikation auf, gefolgt von einem minimalen funktionierenden Beispiel.
templates/main.yml| Eingabe | Beschreibung | Standardwert |
|---|---|---|
job_name | Name des CI-Jobs | "trivy scanning" |
stage | Pipeline-Stage | "test" |
image | Container-Image, das Trivy ausführt | "ghcr.io/aquasecurity/trivy:0.68.1" |
TRIVY_NEEDED_STAGE | Stage, die abgeschlossen sein muss, bevor Trivy ausgeführt wird | "build" |
TRIVY_SCAN_REMOTE_IMAGE | Remote-Image, das gescannt werden soll | "" |
TRIVY_SCAN_LOCAL_IMAGES | Pfad zu tar/OCI-Eingaben (durchsucht ., wenn leer) | "" |
TRIVY_SCANNERS | Kommagetrennte Scanner | "vuln,secret,misconfig" |
severity | Einzuschließende Schweregrade | "CRITICAL,HIGH" |
exit_on_vulnerability | Job fehlschlagen lassen, wenn Probleme gefunden werden | true |
TRIVY_EXTRA_ARGS | Zusätzliche CLI-Flags | "" |
allow_failure | Job-Fehler zulassen, ohne die Pipeline fehlschlagen zu lassen | false |
Beispiel
include:
- component: $CI_SERVER_FQDN/niclas-zone/ci/trivy/main@latest
inputs:
job_name: "trivy:basic"
TRIVY_SCAN_REMOTE_IMAGE: "nginx:latest"
templates/target_container.yml| Eingabe | Beschreibung | Standard |
|---|---|---|
job_name | Name des CI-Jobs | "trivy:scan:containers" |
stage | Pipeline-Phase | "test" |
image | Trivy-Container-Image | "ghcr.io/aquasecurity/trivy:0.68.1" |
TRIVY_SCAN_REMOTE_IMAGE | Referenz auf entferntes Image | "" |
TRIVY_SCAN_LOCAL_IMAGES | Verzeichnis/tar für lokale Scans | "" |
TRIVY_SCANNERS | Aktivierte Scanner | "vuln,secret,misconfig" |
TRIVY_IMAGE_SRC | Image-Quell-Backend (remote/docker/...) | "" |
severity | Schweregrade | "CRITICAL,HIGH" |
exit_on_vulnerability | Bei Übereinstimmung des Schweregrads fehlschlagen | true |
TRIVY_IGNORE_UNFIXED | Probleme ohne Fixes ignorieren | true |
TRIVY_PKG_TYPES | Pakettypen | "os,library" |
TRIVY_VULN_TYPE | Veralteter Alias für Pakettypen | "" |
TRIVY_TIMEOUT | Befehls-Timeout | "10m" |
TRIVY_EXTRA_ARGS | Zusätzliche CLI-Argumente | "" |
TRIVY_DB_REPOSITORY | Benutzerdefinierter DB-Mirror | "" |
TRIVY_JAVA_DB_REPOSITORY | Benutzerdefinierter Java-DB-Mirror | "" |
TRIVY_SKIP_FILES | Datei-Glob-Ausschlüsse | "" |
TRIVY_SKIP_DIRS | Verzeichnisausschlüsse | "" |
allow_failure | Fehlschlag zulassen, ohne die Pipeline fehlschlagen zu lassen | false |
Beispiel
include:
- component: $CI_SERVER_FQDN/niclas-zone/ci/trivy/target_container@latest
inputs:
job_name: "trivy:containers"
TRIVY_SCAN_REMOTE_IMAGE: "registry.gitlab.com/group/service:latest"
TRIVY_SCANNERS: "vuln,secret"
exit_on_vulnerability: true
templates/target_filesystem.yml| Eingabe | Beschreibung | Standard |
|---|---|---|
job_name | Name des CI-Jobs | "trivy:scan:filesystem" |
stage | Pipeline-Phase | "test" |
image | Trivy-Image | "ghcr.io/aquasecurity/trivy:0.68.1" |
TRIVY_FS_PATH | Zu scannende Datei oder Verzeichnis | "." |
TRIVY_SCANNERS | Aktivierte Scanner | "vuln,secret" |
severity | Schweregrade | "CRITICAL,HIGH" |
exit_on_vulnerability | Bei Übereinstimmung des Schweregrads fehlschlagen | true |
TRIVY_IGNORE_UNFIXED | Nicht behobene Probleme ignorieren | true |
TRIVY_PKG_TYPES | Pakettypen | "os,library" |
TRIVY_TIMEOUT | Zeitlimit | "10m" |
TRIVY_SKIP_FILES | Datei-Globs zum Überspringen | "" |
TRIVY_SKIP_DIRS | Verzeichnisse zum Überspringen | "" |
TRIVY_EXTRA_ARGS | Zusätzliche CLI-Argumente | "" |
TRIVY_REPORT_BASENAME | Basisname des Artefakts | "filesystem-scan" |
allow_failure | Fehlschlagen des Jobs zulassen | false |
Beispiel
include:
- component: $CI_SERVER_FQDN/niclas-zone/ci/trivy/target_filesystem@latest
inputs:
TRIVY_FS_PATH: "services/api"
TRIVY_SCANNERS: "vuln,misconfig,secret"
templates/target_rootfs.yml| Eingabe | Beschreibung | Standard |
|---|---|---|
job_name | Jobname | "trivy:scan:rootfs" |
stage | Stage | "test" |
image | Trivy-Image | "ghcr.io/aquasecurity/trivy:0.68.1" |
TRIVY_ROOTFS_PATH | Pfad des Root-Dateisystems | "/" |
TRIVY_SCANNERS | Scanner | "vuln,secret" |
severity | Schweregrade | "CRITICAL,HIGH" |
exit_on_vulnerability | Job bei Funden fehlschlagen lassen | true |
TRIVY_IGNORE_UNFIXED | Nicht behobene ignorieren | true |
TRIVY_PKG_TYPES | Pakettypen | "os,library" |
TRIVY_TIMEOUT | Timeout | "10m" |
TRIVY_SKIP_FILES | Zu überspringende Dateien | "" |
TRIVY_SKIP_DIRS | Zu überspringende Verzeichnisse | "" |
TRIVY_EXTRA_ARGS | Zusätzliche Argumente | "" |
TRIVY_REPORT_BASENAME | Basisname des Artefakts | "rootfs-scan" |
allow_failure | Fehlschlag zulassen | false |
Beispiel
include:
- component: $CI_SERVER_FQDN/niclas-zone/ci/trivy/target_rootfs@latest
inputs:
TRIVY_ROOTFS_PATH: "/mnt/root"
TRIVY_SCANNERS: "vuln"
templates/target_repository.yml