
Trivyスキャン用のGitLab CIコンポーネント
Trivy 用の GitLab CI コンポーネント — コンテナイメージ、ファイルシステム、リポジトリ、Kubernetes クラスタ、SBOM、ライセンスコンプライアンスをカバーするオールインワンのセキュリティスキャナです。これらのテンプレートをパイプラインに直接組み込むことで、シェルスクリプトをほとんど書かずに、再現性のあるスキャン、GitLab ネイティブのレポート、ポータブルなアーティファクトを実現できます。
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
以下の各テンプレートは、コンポーネント仕様で定義されている利用可能な入力とデフォルト値を示し、その後に最小限の動作例を示します。
templates/main.yml| 入力 | 説明 | デフォルト |
|---|---|---|
job_name | CI ジョブの名前 | "trivy scanning" |
stage | パイプラインステージ | "test" |
image | Trivy を実行するコンテナイメージ | "ghcr.io/aquasecurity/trivy:0.68.1" |
TRIVY_NEEDED_STAGE | Trivy の実行前に完了している必要があるステージ | "build" |
TRIVY_SCAN_REMOTE_IMAGE | スキャン対象のリモートイメージ | "" |
TRIVY_SCAN_LOCAL_IMAGES | tar/OCI 入力へのパス(空の場合は . を検索) | "" |
TRIVY_SCANNERS | カンマ区切りのスキャナー | "vuln,secret,misconfig" |
severity | 含める重大度 | "CRITICAL,HIGH" |
exit_on_vulnerability | 問題が見つかった場合にジョブを失敗させる | true |
TRIVY_EXTRA_ARGS | 追加の CLI フラグ | "" |
allow_failure | パイプラインを失敗させずにジョブの失敗を許可する | false |
例
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| 入力 | 説明 | デフォルト |
|---|---|---|
job_name | CI ジョブ名 | "trivy:scan:containers" |
stage | パイプラインステージ | "test" |
image | Trivy コンテナイメージ | "ghcr.io/aquasecurity/trivy:0.68.1" |
TRIVY_SCAN_REMOTE_IMAGE | リモートイメージ参照 | "" |
TRIVY_SCAN_LOCAL_IMAGES | ローカルスキャン用のディレクトリ/tar | "" |
TRIVY_SCANNERS | 有効なスキャナー | "vuln,secret,misconfig" |
TRIVY_IMAGE_SRC | イメージソースバックエンド (remote/docker/...) | "" |
severity | 重大度 | "CRITICAL,HIGH" |
exit_on_vulnerability | 重大度一致時に失敗させる | true |
TRIVY_IGNORE_UNFIXED | 修正のない問題を無視する | true |
TRIVY_PKG_TYPES | パッケージタイプ | "os,library" |
TRIVY_VULN_TYPE | pkg タイプの非推奨エイリアス | "" |
TRIVY_TIMEOUT | コマンドタイムアウト | "10m" |
TRIVY_EXTRA_ARGS | 追加の CLI 引数 | "" |
TRIVY_DB_REPOSITORY | カスタム DB ミラー | "" |
TRIVY_JAVA_DB_REPOSITORY | カスタム Java DB ミラー | "" |
TRIVY_SKIP_FILES | ファイル glob 除外 | "" |
TRIVY_SKIP_DIRS | ディレクトリ除外 | "" |
allow_failure | パイプラインを失敗させずに失敗を許可する | false |
例
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| 入力 | 説明 | デフォルト |
|---|---|---|
job_name | CI ジョブ名 | "trivy:scan:filesystem" |
stage | パイプラインステージ | "test" |
image | Trivy イメージ | "ghcr.io/aquasecurity/trivy:0.68.1" |
TRIVY_FS_PATH | スキャン対象のファイルまたはディレクトリ | "." |
TRIVY_SCANNERS | 有効化するスキャナー | "vuln,secret" |
severity | 重大度 | "CRITICAL,HIGH" |
exit_on_vulnerability | 重大度一致時に失敗させる | true |
TRIVY_IGNORE_UNFIXED | 未修正の問題を無視する | true |
TRIVY_PKG_TYPES | パッケージ種別 | "os,library" |
TRIVY_TIMEOUT | タイムアウト | "10m" |
TRIVY_SKIP_FILES | スキップするファイルの glob | "" |
TRIVY_SKIP_DIRS | スキップするディレクトリ | "" |
TRIVY_EXTRA_ARGS | 追加の CLI 引数 | "" |
TRIVY_REPORT_BASENAME | アーティファクトのベース名 | "filesystem-scan" |
allow_failure | ジョブの失敗を許可する | false |
例
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| 入力 | 説明 | デフォルト |
|---|---|---|
job_name | ジョブ名 | "trivy:scan:rootfs" |
stage | ステージ | "test" |
image | Trivy イメージ | "ghcr.io/aquasecurity/trivy:0.68.1" |
TRIVY_ROOTFS_PATH | ルートファイルシステムのパス | "/" |
TRIVY_SCANNERS | スキャナー | "vuln,secret" |
severity | 重大度 | "CRITICAL,HIGH" |
exit_on_vulnerability | 検出時にジョブを失敗させる | true |
TRIVY_IGNORE_UNFIXED | 未修正を無視 | true |
TRIVY_PKG_TYPES | パッケージ種別 | "os,library" |
TRIVY_TIMEOUT | タイムアウト | "10m" |
TRIVY_SKIP_FILES | スキップするファイル | "" |
TRIVY_SKIP_DIRS | スキップするディレクトリ | "" |
TRIVY_EXTRA_ARGS | 追加引数 | "" |
TRIVY_REPORT_BASENAME | アーティファクトのベース名 | "rootfs-scan" |
allow_failure | 失敗を許可 | false |
例
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| 入力 | 説明 | デフォルト |
|---|---|---|
job_name | ジョブ名 | "trivy:scan:repo" |
stage | ステージ | "test" |
image | Trivy イメージ | "ghcr.io/aquasecurity/trivy:0.68.1" |
TRIVY_REPO_TARGET | ローカルパスまたは Git URL | "." |
TRIVY_REPO_BRANCH | リモートブランチ | "" |
TRIVY_REPO_COMMIT | コミットハッシュ | "" |
TRIVY_REPO_TAG | タグ名 | "" |
TRIVY_SCANNERS | スキャナー | "vuln,secret" |
severity | 重大度 | "CRITICAL,HIGH" |
exit_on_vulnerability | 検出時にジョブを失敗させる | true |
TRIVY_IGNORE_UNFIXED | 未修正のものを無視 | true |
TRIVY_TIMEOUT | タイムアウト | "10m" |
TRIVY_SKIP_FILES | スキップするファイル | "" |
TRIVY_SKIP_DIRS | スキップするディレクトリ | "" |
TRIVY_EXTRA_ARGS | 追加引数 | "" |
TRIVY_REPORT_BASENAME | アーティファクトのベース名 | "repo-scan" |
allow_failure | 失敗を許可 | false |
例
include:
- component: $CI_SERVER_FQDN/niclas-zone/ci/trivy/target_repository@latest
inputs:
TRIVY_REPO_TARGET: "https://github.com/aquasecurity/trivy"
TRIVY_REPO_BRANCH: "main"
templates/target_vm.yml| 入力 | 説明 | デフォルト |
|---|---|---|
job_name | ジョブ名 | "trivy:scan:vm" |
stage | ステージ | "test" |
image | Trivy イメージ | "ghcr.io/aquasecurity/trivy:0.68.1" |
TRIVY_VM_TARGET | ローカルパスまたは ami:/ebs: 識別子 | "" |
TRIVY_AWS_REGION | AMI/EBS スキャン用の AWS リージョン | "" |
TRIVY_SCANNERS | スキャナー | "vuln" |
severity | 重大度 | "CRITICAL,HIGH" |
exit_on_vulnerability | 検出時にジョブを失敗させる | true |
TRIVY_IGNORE_UNFIXED | 未修正のものを無視する | true |
TRIVY_TIMEOUT | タイムアウト | "20m" |
TRIVY_EXTRA_ARGS | 追加引数 | "" |
TRIVY_REPORT_BASENAME | アーティファクトのベース名 | "vm-scan" |
allow_failure | 失敗を許可する | false |
例
include:
- component: $CI_SERVER_FQDN/niclas-zone/ci/trivy/target_vm@latest
inputs:
TRIVY_VM_TARGET: "ami-0123456789abcdef0"
TRIVY_AWS_REGION: "us-east-1"
templates/target_kubernetes.yml