Dagger
Search

trivy

This module provides Dagger functions for scanning Docker images and filesystem
directories using Trivy, the open-source vulnerability scanner from Aqua Security.
It demonstrates how to configure containers with Trivy, accept optional inputs
like scan severity and credentials, and return results as Dagger file outputs or
raw text.

The `ScanFilesystem` function scans a directory for vulnerabilities and returns
a Trivy report as a file. The `ScanImage` function scans a container image by
reference and returns the vulnerability report as plain text. These functions
serve as a reference for integrating Trivy into secure CI/CD pipelines using Dagger.

Installation

dagger install github.com/stuttgart-things/dagger/trivy@v0.74.0

Entrypoint

Return Type 
Trivy
Example
dagger -m github.com/stuttgart-things/dagger/trivy@53a955312c5fc74b04edf1dc4f12831e5177b118 call \

func (m *MyModule) Example() *dagger.Trivy  {
	return dag.
			Trivy()
}
@function
def example() -> dagger.Trivy:
	return (
		dag.trivy()
	)
@func()
example(): Trivy {
	return dag
		.trivy()
}

Types

Trivy 🔗

scanImage() 🔗

TrivyScan performs a security scan on a Docker image using its reference

Return Type 
File !
Arguments
NameTypeDefault ValueDescription
imageRefString !-Fully qualified image reference (e.g., "ttl.sh/my-repo:1.0.0")
registryUserSecret -No description provided
registryPasswordSecret -No description provided
severityString "HIGH,CRITICAL"No description provided
trivyVersionString "0.64.1"No description provided
Example
dagger -m github.com/stuttgart-things/dagger/trivy@53a955312c5fc74b04edf1dc4f12831e5177b118 call \
 scan-image --image-ref string
func (m *MyModule) Example(imageRef string) *dagger.File  {
	return dag.
			Trivy().
			ScanImage(imageRef)
}
@function
def example(image_ref: str) -> dagger.File:
	return (
		dag.trivy()
		.scan_image(image_ref)
	)
@func()
example(imageRef: string): File {
	return dag
		.trivy()
		.scanImage(imageRef)
}

scanFilesystem() 🔗

Return Type 
File !
Arguments
NameTypeDefault ValueDescription
srcDirectory !-No description provided
severityString "HIGH,CRITICAL"No description provided
trivyVersionString "0.64.1"No description provided
Example
dagger -m github.com/stuttgart-things/dagger/trivy@53a955312c5fc74b04edf1dc4f12831e5177b118 call \
 scan-filesystem --src DIR_PATH
func (m *MyModule) Example(src *dagger.Directory) *dagger.File  {
	return dag.
			Trivy().
			ScanFilesystem(src)
}
@function
def example(src: dagger.Directory) -> dagger.File:
	return (
		dag.trivy()
		.scan_filesystem(src)
	)
@func()
example(src: Directory): File {
	return dag
		.trivy()
		.scanFilesystem(src)
}