> For the complete CircleCI developer hub index, see [llms.txt](https://circleci.com/developer/llms.txt)

# fifteen5/trivy-orb

Orb for running Trivy, a security scanner


## Commands

### scan

This command runs Trivy.


| Parameter | Type | Default | Description |
|---|---|---|---|
| `args` | string | -h | Arguments to pass into trivy. See https://aquasecurity.github.io/trivy/v0.19.2/getting-started/cli. |
| `install_location` | string | . | Where to install Trivy |
| `version` | string | 0.19.2 | Version of trivy to download |

## Jobs

### scan

Runs Trivy


| Parameter | Type | Default | Description |
|---|---|---|---|
| `args` | string | -h | Arguments to pass into trivy. See https://aquasecurity.github.io/trivy/v0.19.2/getting-started/cli. |
| `install_location` | string | . | Where to install Trivy |
| `version` | string | 0.19.2 | Version of trivy to download |

## Executors

### default

Executor for trivy


| Parameter | Type | Default | Description |
|---|---|---|---|
| `tag` | string | 2021.07 | Tag for 'cimg/base' docker container
 |

## Examples

### example

Example of scanning a image via Trivy.


```yaml
version: '2.1'
orbs:
  trivy: fifteen5/trivy@1.0.0
workflows:
  use-my-orb:
    jobs:
      - trivy/scan:
          args: '--no-progress --exit-code 1 image busybox'
```