7.9. roxctl 镜像
您可以在特定镜像上运行的命令。
使用方法
$ roxctl image [command] [flags]
命令 | 描述 |
---|---|
| 检查镜像是否有构建策略违反情况,并报告它们。 |
|
从镜像扫描生成 SPDX 2.3 SBOM。您必须具有 |
| 扫描指定的镜像,并返回扫描结果。 |
-t ,--timeout 持续时间 | 为代表请求最长持续时间的 API 请求设置超时。默认值为 10m0s 。 |
---|
7.9.1. roxctl image 命令选项从父命令继承
roxctl image
命令支持从父 roxctl
命令继承的以下选项:
选项 | 描述 |
---|---|
|
为安全连接指定自定义 CA 证书文件路径。或者,您可以使用 |
|
set |
|
设置要联系的服务的端点。另外,您可以使用 |
|
强制对所有连接使用 HTTP/1。或者,通过将 |
|
启用不安全的连接选项。或者,通过将 |
|
跳过 TLS 证书验证。或者,通过将 |
|
禁用颜色输出。或者,通过将 |
|
指定基本身份验证的密码。另外,您可以使用 |
|
使用未加密的连接。或者,通过将 |
|
设置用于 SNI 的 TLS 服务器名称。或者,您可以使用 |
|
使用指定文件中提供的 API 令牌进行身份验证。另外,您可以使用 |
这些选项适用于 roxctl image
命令的所有子命令。
7.9.2. roxctl image sbom
从镜像扫描生成 SPDX 2.3 SBOM。您必须具有 Image
资源的写入权限。
使用方法
$ roxctl image sbom [flags]
选项 | 描述 |
---|---|
|
绕过镜像的 Central 缓存,并强制从扫描程序进行新的拉取。默认值为 |
| 设置重试之间等待的时间(以秒为单位)。默认值为 3。 |
|
镜像名称和引用,如 |
| 设置 Scanner V4 在退出并显示错误前应重试的次数。默认值为 3。 |
7.9.3. roxctl 镜像扫描
扫描指定的镜像,并返回扫描结果。
使用方法
$ roxctl image scan [flags]
选项 | 描述 |
---|---|
| 指定要委派镜像扫描的集群名称或 ID。 |
|
以紧凑格式打印 JSON 输出。默认值为 |
|
如果发现漏洞,失败。默认值为 |
|
忽略 Central 的缓存,并强制从 Scanner 中重新拉取。默认值为 |
|
指定要在表格输出中打印的标头。默认值包括 |
|
在 CSV 表格输出中将标头作为注释打印。默认值为 |
|
指定镜像名称并引用扫描。例如: |
|
在扫描结果中包括 snoozed 和 unsnoozed CVE。默认值为 |
|
在表格输出中合并重复的单元。默认值为 |
|
不要打印表格输出的标头。默认值为 |
|
指定输出格式。输出格式包括 |
|
指定在退出作为错误前重试次数。默认值为 |
|
设置重试之间等待的时间(以秒为单位)。默认值为 |
|
指定 JSON 路径表达式,以从 JSON 对象创建行。如需了解更多详细信息,请运行 |
|
输出中要包含的严重性列表。使用它来过滤特定严重性。默认值包括 |
7.9.4. roxctl 镜像检查
检查镜像是否有构建策略违反情况,并报告它们。
使用方法
$ roxctl image check [flags]
选项 | 描述 |
---|---|
| 要执行的策略类别列表。默认情况下使用所有策略类别。 |
| 定义您要用作评估上下文的集群名称或 ID。 |
|
以紧凑格式打印 JSON 输出。默认值为 |
|
绕过镜像的 Central 缓存,并强制从 Scanner 中进行新的拉取。默认值为 |
|
定义要在表格输出中打印的标头。默认值包括 |
|
在 CSV 表格输出中将标头作为注释打印。默认值为 |
|
指定镜像名称和引用。例如: |
|
设置 JUnit 测试套件的名称。默认值为 |
|
在表格输出中合并重复的单元。默认值为 |
|
不要打印表格输出的标头。默认值为 |
|
选择输出格式。输出格式包括 |
|
在退出作为错误前设置重试次数。默认值为 |
|
设置重试之间等待的时间(以秒为单位)。默认值为 |
|
使用 JSON 路径表达式从 JSON 对象创建一个行。如需了解更多详细信息,请运行 |
|
定义是否在违反事件中发送通知。默认值为 |