Skip to content

Commit 4955475

Browse files
author
Lukas Fischer
committed
#1837 Warn about rate limits in trivy-k8s docs
trivy-k8s does not support client/server mode to cache the vulnerability DB, until this is possible or fixed warn about it in the docs. Related to #1837 Signed-off-by: Lukas Fischer <lukas.fischer@iteratec.com>
1 parent ab4d2bb commit 4955475

3 files changed

Lines changed: 21 additions & 0 deletions

File tree

scanners/trivy/.helm-docs.gotmpl

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -77,6 +77,13 @@ Trivy [supports a client-server mode](https://aquasecurity.github.io/trivy/lates
7777
This mode is implemented and active by default.
7878
A separate Deployment for the trivy server will be created during the installation and the trivy scanTypes are automatically configured to run in client mode and connect to the server.
7979

80+
:::caution
81+
82+
Client/server mode is not used for `trivy-k8s` scans, because trivy does not support it for this type of scan.
83+
If you start many `trivy-k8s` scans you might run into rate limits.
84+
One way to avoid that is to [preemptively download](https://aquasecurity.github.io/trivy/latest/docs/advanced/air-gap/) the trivy database once and then provide it similar to how the [nuclei template cache](https://www.securecodebox.io/docs/scanners/nuclei/#install-nuclei-without-template-cache-cronjob--persistentvolume) is handled.
85+
:::
86+
8087
In case only a single scan or very few are run, and you want to avoid the small performance overhead, client/server mode can be disabled by setting `--set="trivyDatabaseCache.enabled=false"` during helm install.
8188
{{- end }}
8289

scanners/trivy/README.md

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -94,6 +94,13 @@ Trivy [supports a client-server mode](https://aquasecurity.github.io/trivy/lates
9494
This mode is implemented and active by default.
9595
A separate Deployment for the trivy server will be created during the installation and the trivy scanTypes are automatically configured to run in client mode and connect to the server.
9696
97+
:::caution
98+
99+
Client/server mode is not used for `trivy-k8s` scans, because trivy does not support it for this type of scan.
100+
If you start many `trivy-k8s` scans you might run into rate limits.
101+
One way to avoid that is to [preemptively download](https://aquasecurity.github.io/trivy/latest/docs/advanced/air-gap/) the trivy database once and then provide it similar to how the [nuclei template cache](https://www.securecodebox.io/docs/scanners/nuclei/#install-nuclei-without-template-cache-cronjob--persistentvolume) is handled.
102+
:::
103+
97104
In case only a single scan or very few are run, and you want to avoid the small performance overhead, client/server mode can be disabled by setting `--set="trivyDatabaseCache.enabled=false"` during helm install.
98105

99106
## Requirements

scanners/trivy/docs/README.ArtifactHub.md

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -101,6 +101,13 @@ Trivy [supports a client-server mode](https://aquasecurity.github.io/trivy/lates
101101
This mode is implemented and active by default.
102102
A separate Deployment for the trivy server will be created during the installation and the trivy scanTypes are automatically configured to run in client mode and connect to the server.
103103
104+
:::caution
105+
106+
Client/server mode is not used for `trivy-k8s` scans, because trivy does not support it for this type of scan.
107+
If you start many `trivy-k8s` scans you might run into rate limits.
108+
One way to avoid that is to [preemptively download](https://aquasecurity.github.io/trivy/latest/docs/advanced/air-gap/) the trivy database once and then provide it similar to how the [nuclei template cache](https://www.securecodebox.io/docs/scanners/nuclei/#install-nuclei-without-template-cache-cronjob--persistentvolume) is handled.
109+
:::
110+
104111
In case only a single scan or very few are run, and you want to avoid the small performance overhead, client/server mode can be disabled by setting `--set="trivyDatabaseCache.enabled=false"` during helm install.
105112

106113
## Requirements

0 commit comments

Comments
 (0)