Compare commits
3 Commits
0.0.5
...
6e5f62d4dd
| Author | SHA1 | Date | |
|---|---|---|---|
|
6e5f62d4dd
|
|||
|
3d3c7b3265
|
|||
|
c1144841b1
|
+102
-18
@@ -4,33 +4,117 @@ on:
|
|||||||
pull_request:
|
pull_request:
|
||||||
|
|
||||||
jobs:
|
jobs:
|
||||||
test-setup-trivy:
|
|
||||||
strategy:
|
|
||||||
matrix:
|
|
||||||
arch: [ amd64, arm64 ]
|
|
||||||
name: Test Setup Trivy ${{ matrix.arch }}
|
|
||||||
runs-on:
|
|
||||||
- ubuntu-latest
|
|
||||||
- linux_${{ matrix.arch }}
|
|
||||||
steps:
|
|
||||||
- uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
|
|
||||||
- name: Setup Trivy
|
|
||||||
uses: ./setup-trivy
|
|
||||||
- name: Run Trivy
|
|
||||||
run: trivy --version
|
|
||||||
|
|
||||||
test-setup-db:
|
test-setup-db:
|
||||||
name: Test Setup DB
|
name: Test Setup DB
|
||||||
runs-on:
|
runs-on:
|
||||||
- ubuntu-latest
|
- ubuntu-latest
|
||||||
steps:
|
steps:
|
||||||
- uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
|
- uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
|
||||||
- uses: ./setup-trivy
|
|
||||||
- name: Setup DB
|
- name: Setup DB
|
||||||
id: setup-db
|
id: setup-db
|
||||||
uses: ./setup-db
|
uses: ./setup-db
|
||||||
- name: Run Trivy
|
- name: Verify vulnerability DB in cache
|
||||||
run: trivy fs --skip-db-update --cache-dir ${{ steps.setup-db.outputs.cache-dir }} .
|
run: |
|
||||||
|
set -euo pipefail
|
||||||
|
cache="${{ steps.setup-db.outputs.cache-dir }}"
|
||||||
|
db="$cache/db/trivy.db"
|
||||||
|
meta="$cache/db/metadata.json"
|
||||||
|
test -f "$meta" || { echo "FAIL: $meta missing (DB not downloaded?)"; exit 1; }
|
||||||
|
test -f "$db" || { echo "FAIL: $db missing (DB not downloaded?)"; exit 1; }
|
||||||
|
size=$(stat -c%s "$db")
|
||||||
|
min=$((3 * 1024 * 1024))
|
||||||
|
if [ "$size" -lt "$min" ]; then
|
||||||
|
echo "FAIL: trivy.db too small ($size bytes; expected at least $min bytes, i.e. a few MiB)"
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
echo "OK: trivy.db is present ($size bytes) and metadata.json exists."
|
||||||
|
|
||||||
|
test-scan-config:
|
||||||
|
name: Test scan-config
|
||||||
|
runs-on:
|
||||||
|
- ubuntu-latest
|
||||||
|
steps:
|
||||||
|
- uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
|
||||||
|
- name: Setup Trivy DB cache
|
||||||
|
id: db
|
||||||
|
uses: ./setup-db
|
||||||
|
- name: Create ephemeral config fixture
|
||||||
|
id: fixture
|
||||||
|
run: |
|
||||||
|
set -euo pipefail
|
||||||
|
scan="${{ runner.temp }}/trivy-ci-scan-config"
|
||||||
|
reports="${{ runner.temp }}/trivy-ci-reports-config"
|
||||||
|
mkdir -p "$scan" "$reports"
|
||||||
|
printf '%s\n' 'FROM alpine:3.20' > "$scan/Dockerfile"
|
||||||
|
echo "scan-path=$scan" >> "$GITHUB_OUTPUT"
|
||||||
|
echo "reports=$reports" >> "$GITHUB_OUTPUT"
|
||||||
|
- name: Run scan-config
|
||||||
|
id: scan
|
||||||
|
uses: ./scan-config
|
||||||
|
with:
|
||||||
|
scan-path: ${{ steps.fixture.outputs.scan-path }}
|
||||||
|
cache-dir: ${{ steps.db.outputs.cache-dir }}
|
||||||
|
output-dir: ${{ steps.fixture.outputs.reports }}
|
||||||
|
output-file: report.sarif
|
||||||
|
- name: Check output file exists
|
||||||
|
run: test -f "${{ steps.scan.outputs.output-path }}"
|
||||||
|
|
||||||
|
test-scan-fs:
|
||||||
|
name: Test scan-fs
|
||||||
|
runs-on:
|
||||||
|
- ubuntu-latest
|
||||||
|
steps:
|
||||||
|
- uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
|
||||||
|
- name: Setup Trivy DB cache
|
||||||
|
id: db
|
||||||
|
uses: ./setup-db
|
||||||
|
- name: Create ephemeral filesystem fixture
|
||||||
|
id: fixture
|
||||||
|
run: |
|
||||||
|
set -euo pipefail
|
||||||
|
scan="${{ runner.temp }}/trivy-ci-scan-fs"
|
||||||
|
reports="${{ runner.temp }}/trivy-ci-reports-fs"
|
||||||
|
mkdir -p "$scan" "$reports"
|
||||||
|
printf '%s\n' '{"private":true,"name":"trivy-ci-fixture"}' > "$scan/package.json"
|
||||||
|
echo "scan-path=$scan" >> "$GITHUB_OUTPUT"
|
||||||
|
echo "reports=$reports" >> "$GITHUB_OUTPUT"
|
||||||
|
- name: Run scan-fs
|
||||||
|
id: scan
|
||||||
|
uses: ./scan-fs
|
||||||
|
with:
|
||||||
|
scan-path: ${{ steps.fixture.outputs.scan-path }}
|
||||||
|
cache-dir: ${{ steps.db.outputs.cache-dir }}
|
||||||
|
output-dir: ${{ steps.fixture.outputs.reports }}
|
||||||
|
output-file: report.sarif
|
||||||
|
- name: Check output file exists
|
||||||
|
run: test -f "${{ steps.scan.outputs.output-path }}"
|
||||||
|
|
||||||
|
test-scan-image:
|
||||||
|
name: Test scan-image
|
||||||
|
runs-on:
|
||||||
|
- ubuntu-latest
|
||||||
|
steps:
|
||||||
|
- uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
|
||||||
|
- name: Setup Trivy DB cache
|
||||||
|
id: db
|
||||||
|
uses: ./setup-db
|
||||||
|
- name: Prepare report directory
|
||||||
|
id: fixture
|
||||||
|
run: |
|
||||||
|
set -euo pipefail
|
||||||
|
reports="${{ runner.temp }}/trivy-ci-reports-image"
|
||||||
|
mkdir -p "$reports"
|
||||||
|
echo "reports=$reports" >> "$GITHUB_OUTPUT"
|
||||||
|
- name: Run scan-image
|
||||||
|
id: scan
|
||||||
|
uses: ./scan-image
|
||||||
|
with:
|
||||||
|
image: ghcr.io/aquasecurity/trivy:0.69.3@sha256:bcc376de8d77cfe086a917230e818dc9f8528e3c852f7b1aff648949b6258d1c
|
||||||
|
cache-dir: ${{ steps.db.outputs.cache-dir }}
|
||||||
|
output-dir: ${{ steps.fixture.outputs.reports }}
|
||||||
|
output-file: report.sarif
|
||||||
|
- name: Check output file exists
|
||||||
|
run: test -f "${{ steps.scan.outputs.output-path }}"
|
||||||
|
|
||||||
test-get-images-from-files:
|
test-get-images-from-files:
|
||||||
name: Test Get Images From Files
|
name: Test Get Images From Files
|
||||||
|
|||||||
+3
-1
@@ -8,7 +8,9 @@
|
|||||||
{
|
{
|
||||||
"customType": "regex",
|
"customType": "regex",
|
||||||
"description": "Update Trivy docker image",
|
"description": "Update Trivy docker image",
|
||||||
"managerFilePatterns": ["/(^|/)setup-db/action\\.ya?ml$/"],
|
"managerFilePatterns": [
|
||||||
|
"/(^|/)(setup-db|scan-config|scan-fs|scan-image)/action\\.ya?ml$/"
|
||||||
|
],
|
||||||
"datasourceTemplate": "docker",
|
"datasourceTemplate": "docker",
|
||||||
"matchStrings": [
|
"matchStrings": [
|
||||||
"default:\\s*\"(?<depName>ghcr\\.io/aquasecurity/trivy):(?<currentValue>[\\d\\.]+)(?:@(?<currentDigest>sha256:[a-f0-9]+))?\""
|
"default:\\s*\"(?<depName>ghcr\\.io/aquasecurity/trivy):(?<currentValue>[\\d\\.]+)(?:@(?<currentDigest>sha256:[a-f0-9]+))?\""
|
||||||
|
|||||||
@@ -0,0 +1,57 @@
|
|||||||
|
# Trivy scan (misconfiguration)
|
||||||
|
|
||||||
|
Composite action that runs **`trivy config`** inside **Docker** with the same hardening style as [setup-db](../setup-db): read-only root filesystem, dropped capabilities, `no-new-privileges`, AppArmor `docker-default`, a private `tmpfs` on `/tmp`, and resource limits.
|
||||||
|
|
||||||
|
The directory you pass as **`scan-path`** is bind-mounted **read-only** at `/scan`. The vulnerability and policy cache from [setup-db](../setup-db) is mounted **read-only** at `/cache`. Your **`output-dir`** is mounted **read-write** at `/out`; the report is written as **`output-file`** inside that directory. The report format is always **SARIF** (`--format sarif`). Trivy is always run with **`--offline-scan`** (no API calls to resolve dependencies) and **`--exit-code 0`** (the step succeeds after writing the report even when findings are present).
|
||||||
|
|
||||||
|
**Misconfiguration scans do not need outbound network.** This action sets **`--network none`** so the container cannot reach the network. Rego check bundles are not fetched online (`--skip-check-update`); use a Trivy image that already includes the checks you need, or rely on the embedded defaults.
|
||||||
|
|
||||||
|
## Prerequisites
|
||||||
|
|
||||||
|
- Docker on the runner.
|
||||||
|
- A populated Trivy cache at **`cache-dir`** (typically from the [setup-db](../setup-db) action).
|
||||||
|
|
||||||
|
## Usage
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
- uses: actions/checkout@v4
|
||||||
|
- name: Setup Trivy DB cache
|
||||||
|
id: db
|
||||||
|
uses: ./setup-db
|
||||||
|
- name: Misconfiguration scan
|
||||||
|
id: scan
|
||||||
|
uses: ./scan-config
|
||||||
|
with:
|
||||||
|
scan-path: ${{ github.workspace }}
|
||||||
|
cache-dir: ${{ steps.db.outputs.cache-dir }}
|
||||||
|
output-dir: ${{ runner.temp }}/trivy-reports
|
||||||
|
output-file: misconfig.sarif
|
||||||
|
- name: Upload report
|
||||||
|
uses: actions/upload-artifact@v4
|
||||||
|
with:
|
||||||
|
name: trivy-misconfig
|
||||||
|
path: ${{ steps.scan.outputs.output-path }}
|
||||||
|
```
|
||||||
|
|
||||||
|
## Inputs
|
||||||
|
|
||||||
|
| Input | Description | Required | Default |
|
||||||
|
| --------------- | --------------------------------------------------------------------------- | -------- | ------- |
|
||||||
|
| `scan-path` | Host directory to scan (mounted read-only at `/scan`) | Yes | — |
|
||||||
|
| `cache-dir` | Trivy cache directory (mounted read-only at `/cache`) | No | `${{ runner.temp }}/trivy` |
|
||||||
|
| `output-dir` | Host directory for the report (mounted read-write at `/out`) | Yes | — |
|
||||||
|
| `output-file` | SARIF file name only (no `/`); created under `output-dir` | Yes | — |
|
||||||
|
| `trivy-version` | Trivy Docker image (digest pin recommended) | No | Same pin as `setup-db` / see `action.yaml` |
|
||||||
|
|
||||||
|
**`trivy-version` is optional.** Omit it to use the default image from `action.yaml`.
|
||||||
|
|
||||||
|
## Outputs
|
||||||
|
|
||||||
|
| Output | Description |
|
||||||
|
| -------------- | ------------------------------------ |
|
||||||
|
| `output-path` | Absolute path to the SARIF report on the host |
|
||||||
|
|
||||||
|
## Notes
|
||||||
|
|
||||||
|
- Paths should exist or be creatable: **`output-dir`** is created with `mkdir -p` if missing; **`scan-path`** and **`cache-dir`** must already exist.
|
||||||
|
- The step still fails if Docker or the container exits non-zero before Trivy completes (e.g. mount or runtime errors).
|
||||||
@@ -0,0 +1,81 @@
|
|||||||
|
name: "Trivy scan (misconfiguration)"
|
||||||
|
description: "Run trivy config in a locked-down Docker container (misconfiguration / IaC); report is always SARIF"
|
||||||
|
author: "Timo Behrendt <t.behrendt@t00n.de>"
|
||||||
|
branding:
|
||||||
|
icon: "shield"
|
||||||
|
color: "blue"
|
||||||
|
|
||||||
|
inputs:
|
||||||
|
scan-path:
|
||||||
|
description: "Host path to the directory to scan (mounted read-only at /scan in the container)"
|
||||||
|
required: true
|
||||||
|
cache-dir:
|
||||||
|
description: "Host path to the Trivy cache directory (mounted read-only at /cache; use the same path as setup-db)"
|
||||||
|
required: false
|
||||||
|
default: "${{ runner.temp }}/trivy"
|
||||||
|
output-dir:
|
||||||
|
description: "Host directory where the report file is written (mounted read-write at /out)"
|
||||||
|
required: true
|
||||||
|
output-file:
|
||||||
|
description: "SARIF report file name only (no slashes); written under output-dir"
|
||||||
|
required: true
|
||||||
|
trivy-version:
|
||||||
|
description: "Trivy Docker image reference (digest pin recommended)"
|
||||||
|
required: false
|
||||||
|
default: "ghcr.io/aquasecurity/trivy:0.69.3@sha256:bcc376de8d77cfe086a917230e818dc9f8528e3c852f7b1aff648949b6258d1c"
|
||||||
|
|
||||||
|
outputs:
|
||||||
|
output-path:
|
||||||
|
description: "Host path to the generated report file"
|
||||||
|
value: ${{ steps.scan.outputs.output-path }}
|
||||||
|
|
||||||
|
runs:
|
||||||
|
using: "composite"
|
||||||
|
steps:
|
||||||
|
- id: scan
|
||||||
|
shell: bash
|
||||||
|
env:
|
||||||
|
SCAN_PATH_IN: ${{ inputs.scan-path }}
|
||||||
|
CACHE_DIR_IN: ${{ inputs.cache-dir }}
|
||||||
|
OUTPUT_DIR_IN: ${{ inputs.output-dir }}
|
||||||
|
OUTPUT_FILE: ${{ inputs.output-file }}
|
||||||
|
TRIVY_IMAGE: ${{ inputs.trivy-version }}
|
||||||
|
run: |
|
||||||
|
set -euo pipefail
|
||||||
|
case "$OUTPUT_FILE" in */*|".."*) echo "FAIL: output-file must be a single file name (no path separators)"; exit 1 ;; esac
|
||||||
|
scan_path=$(realpath "$SCAN_PATH_IN")
|
||||||
|
cache_dir=$(realpath "$CACHE_DIR_IN")
|
||||||
|
mkdir -p "$OUTPUT_DIR_IN"
|
||||||
|
output_dir=$(realpath "$OUTPUT_DIR_IN")
|
||||||
|
test -d "$scan_path" || { echo "FAIL: scan-path is not a directory: $scan_path"; exit 1; }
|
||||||
|
test -d "$cache_dir" || { echo "FAIL: cache-dir is not a directory: $cache_dir"; exit 1; }
|
||||||
|
|
||||||
|
docker run --rm \
|
||||||
|
--name trivy-scan-config \
|
||||||
|
--user "$(id -u):$(id -g)" \
|
||||||
|
--read-only \
|
||||||
|
--env-file /dev/null \
|
||||||
|
--cap-drop ALL \
|
||||||
|
--pids-limit 64 \
|
||||||
|
--memory=512m \
|
||||||
|
--memory-swap=512m \
|
||||||
|
--cpus=1 \
|
||||||
|
--ipc private \
|
||||||
|
--cgroupns private \
|
||||||
|
--security-opt no-new-privileges \
|
||||||
|
--security-opt apparmor=docker-default \
|
||||||
|
--tmpfs /tmp:rw,noexec,nosuid,nodev,size=1g \
|
||||||
|
--network none \
|
||||||
|
--mount type=bind,src="$scan_path",dst=/scan,ro \
|
||||||
|
--mount type=bind,src="$cache_dir",dst=/cache,ro \
|
||||||
|
--mount type=bind,src="$output_dir",dst=/out \
|
||||||
|
"$TRIVY_IMAGE" \
|
||||||
|
config /scan \
|
||||||
|
--cache-dir /cache \
|
||||||
|
--skip-check-update \
|
||||||
|
--offline-scan \
|
||||||
|
--format sarif \
|
||||||
|
--exit-code 0 \
|
||||||
|
-o "/out/$OUTPUT_FILE"
|
||||||
|
|
||||||
|
echo "output-path=$output_dir/$OUTPUT_FILE" >> "$GITHUB_OUTPUT"
|
||||||
@@ -0,0 +1,58 @@
|
|||||||
|
# Trivy scan (filesystem)
|
||||||
|
|
||||||
|
Composite action that runs **`trivy filesystem`** inside **Docker** with the same hardening style as [setup-db](../setup-db): read-only root filesystem, dropped capabilities, `no-new-privileges`, AppArmor `docker-default`, a private `tmpfs` on `/tmp`, and resource limits.
|
||||||
|
|
||||||
|
The directory you pass as **`scan-path`** is bind-mounted **read-only** at `/scan`. The Trivy cache from [setup-db](../setup-db) is mounted **read-only** at `/cache`. Your **`output-dir`** is mounted **read-write** at `/out`; the report is written as **`output-file`** inside that directory. The report format is always **SARIF** (`--format sarif`). Trivy is always run with **`--offline-scan`** (no API calls to identify dependencies) and **`--exit-code 0`** (the step succeeds after writing the report even when findings are present).
|
||||||
|
|
||||||
|
**Filesystem scans use `--network none`** so the scan container cannot reach the network. The vulnerability database must already be present under **`cache-dir`**; the action passes **`--skip-db-update`** and **`--skip-check-update`** so Trivy does not try to refresh data online.
|
||||||
|
|
||||||
|
## Prerequisites
|
||||||
|
|
||||||
|
- Docker on the runner.
|
||||||
|
- A populated Trivy cache at **`cache-dir`** (typically from the [setup-db](../setup-db) action).
|
||||||
|
|
||||||
|
## Usage
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
- uses: actions/checkout@v4
|
||||||
|
- name: Setup Trivy DB cache
|
||||||
|
id: db
|
||||||
|
uses: ./setup-db
|
||||||
|
- name: Filesystem scan
|
||||||
|
id: scan
|
||||||
|
uses: ./scan-fs
|
||||||
|
with:
|
||||||
|
scan-path: ${{ github.workspace }}
|
||||||
|
cache-dir: ${{ steps.db.outputs.cache-dir }}
|
||||||
|
output-dir: ${{ runner.temp }}/trivy-reports
|
||||||
|
output-file: fs.sarif
|
||||||
|
- name: Upload report
|
||||||
|
uses: actions/upload-artifact@v4
|
||||||
|
with:
|
||||||
|
name: trivy-fs
|
||||||
|
path: ${{ steps.scan.outputs.output-path }}
|
||||||
|
```
|
||||||
|
|
||||||
|
## Inputs
|
||||||
|
|
||||||
|
| Input | Description | Required | Default |
|
||||||
|
| --------------- | --------------------------------------------------------------------------- | -------- | ------- |
|
||||||
|
| `scan-path` | Host directory to scan (mounted read-only at `/scan`) | Yes | — |
|
||||||
|
| `cache-dir` | Trivy cache directory (mounted read-only at `/cache`) | No | `${{ runner.temp }}/trivy` |
|
||||||
|
| `output-dir` | Host directory for the report (mounted read-write at `/out`) | Yes | — |
|
||||||
|
| `output-file` | SARIF file name only (no `/`); created under `output-dir` | Yes | — |
|
||||||
|
| `trivy-version` | Trivy Docker image (digest pin recommended) | No | Same pin as `setup-db` / see `action.yaml` |
|
||||||
|
|
||||||
|
**`trivy-version` is optional.** Omit it to use the default image from `action.yaml`.
|
||||||
|
|
||||||
|
## Outputs
|
||||||
|
|
||||||
|
| Output | Description |
|
||||||
|
| -------------- | ------------------------------------ |
|
||||||
|
| `output-path` | Absolute path to the SARIF report on the host |
|
||||||
|
|
||||||
|
## Notes
|
||||||
|
|
||||||
|
- Paths should exist or be creatable: **`output-dir`** is created with `mkdir -p` if missing; **`scan-path`** and **`cache-dir`** must already exist.
|
||||||
|
- Default Trivy filesystem scanners include **vuln** and **secret**; misconfig-related network fetches are avoided via **`--skip-check-update`**.
|
||||||
|
- The step still fails if Docker or the container exits non-zero before Trivy completes (e.g. mount or runtime errors).
|
||||||
@@ -0,0 +1,82 @@
|
|||||||
|
name: "Trivy scan (filesystem)"
|
||||||
|
description: "Run trivy filesystem in a locked-down Docker container; report is always SARIF"
|
||||||
|
author: "Timo Behrendt <t.behrendt@t00n.de>"
|
||||||
|
branding:
|
||||||
|
icon: "search"
|
||||||
|
color: "blue"
|
||||||
|
|
||||||
|
inputs:
|
||||||
|
scan-path:
|
||||||
|
description: "Host path to the directory to scan (mounted read-only at /scan in the container)"
|
||||||
|
required: true
|
||||||
|
cache-dir:
|
||||||
|
description: "Host path to the Trivy cache directory (mounted read-only at /cache; use the same path as setup-db)"
|
||||||
|
required: false
|
||||||
|
default: "${{ runner.temp }}/trivy"
|
||||||
|
output-dir:
|
||||||
|
description: "Host directory where the report file is written (mounted read-write at /out)"
|
||||||
|
required: true
|
||||||
|
output-file:
|
||||||
|
description: "SARIF report file name only (no slashes); written under output-dir"
|
||||||
|
required: true
|
||||||
|
trivy-version:
|
||||||
|
description: "Trivy Docker image reference (digest pin recommended)"
|
||||||
|
required: false
|
||||||
|
default: "ghcr.io/aquasecurity/trivy:0.69.3@sha256:bcc376de8d77cfe086a917230e818dc9f8528e3c852f7b1aff648949b6258d1c"
|
||||||
|
|
||||||
|
outputs:
|
||||||
|
output-path:
|
||||||
|
description: "Host path to the generated report file"
|
||||||
|
value: ${{ steps.scan.outputs.output-path }}
|
||||||
|
|
||||||
|
runs:
|
||||||
|
using: "composite"
|
||||||
|
steps:
|
||||||
|
- id: scan
|
||||||
|
shell: bash
|
||||||
|
env:
|
||||||
|
SCAN_PATH_IN: ${{ inputs.scan-path }}
|
||||||
|
CACHE_DIR_IN: ${{ inputs.cache-dir }}
|
||||||
|
OUTPUT_DIR_IN: ${{ inputs.output-dir }}
|
||||||
|
OUTPUT_FILE: ${{ inputs.output-file }}
|
||||||
|
TRIVY_IMAGE: ${{ inputs.trivy-version }}
|
||||||
|
run: |
|
||||||
|
set -euo pipefail
|
||||||
|
case "$OUTPUT_FILE" in */*|".."*) echo "FAIL: output-file must be a single file name (no path separators)"; exit 1 ;; esac
|
||||||
|
scan_path=$(realpath "$SCAN_PATH_IN")
|
||||||
|
cache_dir=$(realpath "$CACHE_DIR_IN")
|
||||||
|
mkdir -p "$OUTPUT_DIR_IN"
|
||||||
|
output_dir=$(realpath "$OUTPUT_DIR_IN")
|
||||||
|
test -d "$scan_path" || { echo "FAIL: scan-path is not a directory: $scan_path"; exit 1; }
|
||||||
|
test -d "$cache_dir" || { echo "FAIL: cache-dir is not a directory: $cache_dir"; exit 1; }
|
||||||
|
|
||||||
|
docker run --rm \
|
||||||
|
--name trivy-scan-fs \
|
||||||
|
--user "$(id -u):$(id -g)" \
|
||||||
|
--read-only \
|
||||||
|
--env-file /dev/null \
|
||||||
|
--cap-drop ALL \
|
||||||
|
--pids-limit 64 \
|
||||||
|
--memory=512m \
|
||||||
|
--memory-swap=512m \
|
||||||
|
--cpus=1 \
|
||||||
|
--ipc private \
|
||||||
|
--cgroupns private \
|
||||||
|
--security-opt no-new-privileges \
|
||||||
|
--security-opt apparmor=docker-default \
|
||||||
|
--tmpfs /tmp:rw,noexec,nosuid,nodev,size=1g \
|
||||||
|
--network none \
|
||||||
|
--mount type=bind,src="$scan_path",dst=/scan,ro \
|
||||||
|
--mount type=bind,src="$cache_dir",dst=/cache,ro \
|
||||||
|
--mount type=bind,src="$output_dir",dst=/out \
|
||||||
|
"$TRIVY_IMAGE" \
|
||||||
|
filesystem /scan \
|
||||||
|
--cache-dir /cache \
|
||||||
|
--skip-db-update \
|
||||||
|
--skip-check-update \
|
||||||
|
--offline-scan \
|
||||||
|
--format sarif \
|
||||||
|
--exit-code 0 \
|
||||||
|
-o "/out/$OUTPUT_FILE"
|
||||||
|
|
||||||
|
echo "output-path=$output_dir/$OUTPUT_FILE" >> "$GITHUB_OUTPUT"
|
||||||
@@ -0,0 +1,57 @@
|
|||||||
|
# Trivy scan (image)
|
||||||
|
|
||||||
|
Composite action that runs **`trivy image`** inside **Docker** with the same hardening style as [setup-db](../setup-db): read-only root filesystem, dropped capabilities, `no-new-privileges`, AppArmor `docker-default`, a private `tmpfs` on `/tmp`, and resource limits.
|
||||||
|
|
||||||
|
You pass a pullable **`image`** reference (e.g. `alpine:3.20` or a digest). Trivy pulls and scans it inside the container. The Trivy cache from [setup-db](../setup-db) is mounted **read-only** at `/cache` (**`--skip-db-update`** avoids re-downloading the DB). Your **`output-dir`** is mounted **read-write** at `/out`; the report is written as **`output-file`** inside that directory. The report format is always **SARIF** (`--format sarif`). Trivy is always run with **`--offline-scan`** (no API calls to identify dependencies) and **`--exit-code 0`** (the step succeeds after writing the report even when findings are present). Image layers are still pulled over the network when needed.
|
||||||
|
|
||||||
|
**Image scans need network access** to pull the image (and possibly layers). This action does **not** set `--network none` (unlike [scan-config](../scan-config) and [scan-fs](../scan-fs)).
|
||||||
|
|
||||||
|
## Prerequisites
|
||||||
|
|
||||||
|
- Docker on the runner.
|
||||||
|
- A populated Trivy cache at **`cache-dir`** (typically from the [setup-db](../setup-db) action).
|
||||||
|
|
||||||
|
## Usage
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
- name: Setup Trivy DB cache
|
||||||
|
id: db
|
||||||
|
uses: ./setup-db
|
||||||
|
- name: Image scan
|
||||||
|
id: scan
|
||||||
|
uses: ./scan-image
|
||||||
|
with:
|
||||||
|
image: alpine:3.20
|
||||||
|
cache-dir: ${{ steps.db.outputs.cache-dir }}
|
||||||
|
output-dir: ${{ runner.temp }}/trivy-reports
|
||||||
|
output-file: image.sarif
|
||||||
|
- name: Upload report
|
||||||
|
uses: actions/upload-artifact@v4
|
||||||
|
with:
|
||||||
|
name: trivy-image
|
||||||
|
path: ${{ steps.scan.outputs.output-path }}
|
||||||
|
```
|
||||||
|
|
||||||
|
## Inputs
|
||||||
|
|
||||||
|
| Input | Description | Required | Default |
|
||||||
|
| --------------- | --------------------------------------------------------------------------- | -------- | ------- |
|
||||||
|
| `image` | Image reference to scan (pulled inside the container) | Yes | — |
|
||||||
|
| `cache-dir` | Trivy cache directory (mounted read-only at `/cache`) | No | `${{ runner.temp }}/trivy` |
|
||||||
|
| `output-dir` | Host directory for the report (mounted read-write at `/out`) | Yes | — |
|
||||||
|
| `output-file` | SARIF file name only (no `/`); created under `output-dir` | Yes | — |
|
||||||
|
| `trivy-version` | Trivy Docker image (digest pin recommended) | No | Same pin as `setup-db` / see `action.yaml` |
|
||||||
|
|
||||||
|
**`trivy-version` is optional.** Omit it to use the default image from `action.yaml`.
|
||||||
|
|
||||||
|
## Outputs
|
||||||
|
|
||||||
|
| Output | Description |
|
||||||
|
| -------------- | ------------------------------------ |
|
||||||
|
| `output-path` | Absolute path to the SARIF report on the host |
|
||||||
|
|
||||||
|
## Notes
|
||||||
|
|
||||||
|
- **`output-dir`** is created with `mkdir -p` if missing; **`cache-dir`** must already exist.
|
||||||
|
- Local-only images (e.g. built on the host) are not supported unless they are available to the **inner** Docker pull (this action does not mount `docker.sock`).
|
||||||
|
- The step still fails if Docker or the container exits non-zero before Trivy completes (e.g. mount or runtime errors).
|
||||||
@@ -0,0 +1,77 @@
|
|||||||
|
name: "Trivy scan (image)"
|
||||||
|
description: "Run trivy image in a locked-down Docker container; report is always SARIF"
|
||||||
|
author: "Timo Behrendt <t.behrendt@t00n.de>"
|
||||||
|
branding:
|
||||||
|
icon: "package"
|
||||||
|
color: "blue"
|
||||||
|
|
||||||
|
inputs:
|
||||||
|
image:
|
||||||
|
description: "Container image reference to scan (pulled by Trivy inside the container; requires network)"
|
||||||
|
required: true
|
||||||
|
cache-dir:
|
||||||
|
description: "Host path to the Trivy cache directory (mounted read-only at /cache; use the same path as setup-db)"
|
||||||
|
required: false
|
||||||
|
default: "${{ runner.temp }}/trivy"
|
||||||
|
output-dir:
|
||||||
|
description: "Host directory where the report file is written (mounted read-write at /out)"
|
||||||
|
required: true
|
||||||
|
output-file:
|
||||||
|
description: "SARIF report file name only (no slashes); written under output-dir"
|
||||||
|
required: true
|
||||||
|
trivy-version:
|
||||||
|
description: "Trivy Docker image reference (digest pin recommended)"
|
||||||
|
required: false
|
||||||
|
default: "ghcr.io/aquasecurity/trivy:0.69.3@sha256:bcc376de8d77cfe086a917230e818dc9f8528e3c852f7b1aff648949b6258d1c"
|
||||||
|
|
||||||
|
outputs:
|
||||||
|
output-path:
|
||||||
|
description: "Host path to the generated report file"
|
||||||
|
value: ${{ steps.scan.outputs.output-path }}
|
||||||
|
|
||||||
|
runs:
|
||||||
|
using: "composite"
|
||||||
|
steps:
|
||||||
|
- id: scan
|
||||||
|
shell: bash
|
||||||
|
env:
|
||||||
|
IMAGE_REF: ${{ inputs.image }}
|
||||||
|
CACHE_DIR_IN: ${{ inputs.cache-dir }}
|
||||||
|
OUTPUT_DIR_IN: ${{ inputs.output-dir }}
|
||||||
|
OUTPUT_FILE: ${{ inputs.output-file }}
|
||||||
|
TRIVY_IMAGE: ${{ inputs.trivy-version }}
|
||||||
|
run: |
|
||||||
|
set -euo pipefail
|
||||||
|
case "$OUTPUT_FILE" in */*|".."*) echo "FAIL: output-file must be a single file name (no path separators)"; exit 1 ;; esac
|
||||||
|
cache_dir=$(realpath "$CACHE_DIR_IN")
|
||||||
|
mkdir -p "$OUTPUT_DIR_IN"
|
||||||
|
output_dir=$(realpath "$OUTPUT_DIR_IN")
|
||||||
|
test -d "$cache_dir" || { echo "FAIL: cache-dir is not a directory: $cache_dir"; exit 1; }
|
||||||
|
|
||||||
|
docker run --rm \
|
||||||
|
--name trivy-scan-image \
|
||||||
|
--user "$(id -u):$(id -g)" \
|
||||||
|
--read-only \
|
||||||
|
--env-file /dev/null \
|
||||||
|
--cap-drop ALL \
|
||||||
|
--pids-limit 64 \
|
||||||
|
--memory=512m \
|
||||||
|
--memory-swap=512m \
|
||||||
|
--cpus=1 \
|
||||||
|
--ipc private \
|
||||||
|
--cgroupns private \
|
||||||
|
--security-opt no-new-privileges \
|
||||||
|
--security-opt apparmor=docker-default \
|
||||||
|
--tmpfs /tmp:rw,noexec,nosuid,nodev,size=1g \
|
||||||
|
--mount type=bind,src="$cache_dir",dst=/cache,ro \
|
||||||
|
--mount type=bind,src="$output_dir",dst=/out \
|
||||||
|
"$TRIVY_IMAGE" \
|
||||||
|
image "$IMAGE_REF" \
|
||||||
|
--cache-dir /cache \
|
||||||
|
--skip-db-update \
|
||||||
|
--offline-scan \
|
||||||
|
--format sarif \
|
||||||
|
--exit-code 0 \
|
||||||
|
-o "/out/$OUTPUT_FILE"
|
||||||
|
|
||||||
|
echo "output-path=$output_dir/$OUTPUT_FILE" >> "$GITHUB_OUTPUT"
|
||||||
@@ -1,39 +0,0 @@
|
|||||||
# Setup Trivy Action
|
|
||||||
|
|
||||||
A reusable Gitea Action that downloads and sets up the Trivy binary for vulnerability scanning.
|
|
||||||
|
|
||||||
## Usage
|
|
||||||
|
|
||||||
### Basic Usage
|
|
||||||
|
|
||||||
```yaml
|
|
||||||
- name: Setup Trivy
|
|
||||||
uses: your-username/trivy-actions@main/setup-trivy
|
|
||||||
with:
|
|
||||||
version: "v0.66.0" # Optional: Trivy version (default: latest)
|
|
||||||
```
|
|
||||||
|
|
||||||
### Complete Example
|
|
||||||
|
|
||||||
```yaml
|
|
||||||
name: Security Scan
|
|
||||||
on: [push, pull_request]
|
|
||||||
|
|
||||||
jobs:
|
|
||||||
security:
|
|
||||||
runs-on:
|
|
||||||
- ubuntu-latest
|
|
||||||
- linux_amd64
|
|
||||||
steps:
|
|
||||||
- uses: actions/checkout@v4
|
|
||||||
- name: Setup Trivy
|
|
||||||
uses: your-username/trivy-actions@main/setup-trivy
|
|
||||||
- name: Scan for vulnerabilities
|
|
||||||
run: trivy fs .
|
|
||||||
```
|
|
||||||
|
|
||||||
## Inputs
|
|
||||||
|
|
||||||
| Input | Description | Required | Default |
|
|
||||||
| --------- | ----------------------------------------- | -------- | -------- |
|
|
||||||
| `version` | Trivy version to download (e.g., v0.66.0) | No | `latest` |
|
|
||||||
@@ -1,68 +0,0 @@
|
|||||||
name: "Setup Trivy"
|
|
||||||
description: "Download and setup Trivy binary for vulnerability scanning"
|
|
||||||
author: "Gitea Actions"
|
|
||||||
branding:
|
|
||||||
icon: "shield"
|
|
||||||
color: "blue"
|
|
||||||
|
|
||||||
inputs:
|
|
||||||
version:
|
|
||||||
description: "Trivy version to download (e.g., latest)"
|
|
||||||
required: false
|
|
||||||
default: "latest"
|
|
||||||
|
|
||||||
runs:
|
|
||||||
using: "composite"
|
|
||||||
steps:
|
|
||||||
- shell: bash
|
|
||||||
id: arch
|
|
||||||
run: |
|
|
||||||
set -e
|
|
||||||
case "$(uname -m)" in
|
|
||||||
x86_64)
|
|
||||||
ARCH="64bit"
|
|
||||||
;;
|
|
||||||
aarch64)
|
|
||||||
ARCH="ARM64"
|
|
||||||
;;
|
|
||||||
esac
|
|
||||||
echo "ARCH=$ARCH" >> $GITHUB_OUTPUT
|
|
||||||
- name: Resolve version
|
|
||||||
shell: bash
|
|
||||||
id: version
|
|
||||||
run: |
|
|
||||||
set -e
|
|
||||||
if [ "${{ inputs.version }}" = "latest" ]; then
|
|
||||||
VERSION=$(curl -s https://api.github.com/repos/aquasecurity/trivy/releases/latest | jq -r '.tag_name')
|
|
||||||
else
|
|
||||||
VERSION="${{ inputs.version }}"
|
|
||||||
fi
|
|
||||||
echo "VERSION=$VERSION" >> $GITHUB_OUTPUT
|
|
||||||
- name: Cache Trivy binary
|
|
||||||
id: cache-trivy
|
|
||||||
uses: actions/cache@cdf6c1fa76f9f475f3d7449005a359c84ca0f306 # v5
|
|
||||||
with:
|
|
||||||
path: /usr/local/bin/trivy
|
|
||||||
key: trivy-${{ steps.version.outputs.version }}-${{ steps.arch.outputs.arch }}
|
|
||||||
restore-keys: |
|
|
||||||
trivy-${{ steps.version.outputs.version }}-${{ steps.arch.outputs.arch }}
|
|
||||||
- name: Download and install Trivy
|
|
||||||
if: steps.cache-trivy.outputs.cache-hit != 'true'
|
|
||||||
shell: bash
|
|
||||||
run: |
|
|
||||||
set -e
|
|
||||||
|
|
||||||
VERSION="${{ steps.version.outputs.version }}"
|
|
||||||
|
|
||||||
mkdir -p /usr/local/bin
|
|
||||||
|
|
||||||
curl -sL "https://github.com/aquasecurity/trivy/releases/download/${VERSION}/trivy_${VERSION#v}_Linux-${{ steps.arch.outputs.arch }}.tar.gz" -o trivy.tar.gz
|
|
||||||
tar -xzf trivy.tar.gz
|
|
||||||
chmod +x trivy
|
|
||||||
mv trivy /usr/local/bin/
|
|
||||||
rm trivy.tar.gz
|
|
||||||
|
|
||||||
- name: Add Trivy to PATH
|
|
||||||
shell: bash
|
|
||||||
run: |
|
|
||||||
echo "/usr/local/bin" >> $GITHUB_PATH
|
|
||||||
Reference in New Issue
Block a user