×

可在特定镜像上运行的命令。

用法
$ roxctl image [command] [flags]
表1. 可用命令
命令 描述

check

检查镜像是否存在构建时策略冲突,并报告它们。

scan

扫描指定的镜像,并返回扫描结果。

表2. 选项
-t, --timeout duration 设置API请求的超时时间,表示请求的最大持续时间。默认值为10m0s

roxctl image 命令选项继承自父命令

roxctl image 命令支持从父 roxctl 命令继承的以下选项

选项 描述

--ca string

指定用于安全连接的自定义CA证书文件路径。或者,您可以使用ROX_CA_CERT_FILE环境变量指定文件路径。

--direct-grpc

设置--direct-grpc 以提高连接性能。或者,通过将ROX_DIRECT_GRPC_CLIENT环境变量设置为true,您可以启用直接gRPC。默认值为false

-e, --endpoint string

设置要联系的服务的端点。或者,您可以使用ROX_ENDPOINT环境变量设置端点。默认值为localhost:8443

--force-http1

强制对所有连接使用HTTP/1。或者,通过将ROX_CLIENT_FORCE_HTTP1环境变量设置为true,您可以强制使用HTTP/1。默认值为false

--insecure

启用不安全连接选项。或者,通过将ROX_INSECURE_CLIENT环境变量设置为true,您可以启用不安全连接选项。默认值为false

--insecure-skip-tls-verify

跳过TLS证书验证。或者,通过将ROX_INSECURE_CLIENT_SKIP_TLS_VERIFY环境变量设置为true,您可以跳过TLS证书验证。默认值为false

--no-color

禁用彩色输出。或者,通过将ROX_NO_COLOR环境变量设置为true,可以禁用彩色输出。默认值为false

-p, --password string

指定基本身份验证的密码。或者,您可以使用ROX_ADMIN_PASSWORD环境变量设置密码。

--plaintext

使用未加密的连接。或者,通过将ROX_PLAINTEXT环境变量设置为true,可以启用未加密的连接。默认值为false

-s, --server-name string

设置用于SNI的TLS服务器名称。或者,您可以使用ROX_SERVER_NAME环境变量设置服务器名称。

--token-file string

使用指定文件中提供的API令牌进行身份验证。或者,您可以使用ROX_API_TOKEN环境变量设置令牌。

这些选项适用于roxctl image命令的所有子命令。

roxctl image scan

扫描指定的镜像,并返回扫描结果。

用法
$ roxctl image scan [flags]
表3. 选项
选项 描述

--cluster string

指定要委托图像扫描的集群名称或ID。

--compact-output

以紧凑格式打印JSON输出。默认值为false

--fail

如果发现漏洞,则失败。默认值为false

-f, --force

忽略Central的缓存,并强制从Scanner重新拉取最新版本。默认值为false

--headers strings

指定以表格形式输出的标题。默认值包括COMPONENTVERSIONCVESEVERITYLINK

--headers-as-comments

在CSV表格输出中将标题作为注释打印。默认值为false

-i, --image string

指定要扫描的镜像名称和引用。例如,nginx:latestnginx@sha256:…​

-a, --include-snoozed

在扫描结果中包含已暂停和未暂停的CVE。默认值为false

--merge-output

合并表格输出中的重复单元格。默认值为true

--no-header

不打印表格输出的标题。默认值为false

-o, --output string

指定输出格式。输出格式包括tablecsvjsonsarif

-r, --retries int

指定在退出作为错误之前的重试次数。默认值为3

-d, --retry-delay int

设置以秒为单位的重试之间等待的时间。默认值为3

--row-jsonpath-expressions string

指定JSON路径表达式以从JSON对象创建行。更多详情,请运行roxctl image scan --help命令。

--severity strings

要包含在输出中的严重性列表。使用此选项筛选特定严重性。默认值包括LOWMODERATEIMPORTANTCRITICAL

roxctl image check

检查镜像是否存在构建时策略冲突,并报告它们。

用法
$ roxctl image check [flags]
表4. 选项
选项 描述

-c, --categories strings

要执行的策略类别列表。默认情况下,使用所有策略类别。

--cluster string

定义要作为评估上下文的集群名称或ID。

--compact-output

以紧凑格式打印JSON输出。默认值为false

-f, --force

绕过Central缓存中的镜像,并强制从Scanner中重新拉取。默认值为false

--headers strings

定义要在表格输出中打印的标题。默认值包括POLICYSEVERITYBREAKS BUILDDESCRIPTIONVIOLATIONREMEDIATION

--headers-as-comments

在CSV表格输出中将标题作为注释打印。默认值为false

-i, --image string

指定镜像名称和引用。例如,nginx:latestnginx@sha256:…​

--junit-suite-name string

设置JUnit测试套件的名称。默认值为image-check

--merge-output

合并表格输出中的重复单元格。默认值为false

--no-header

不打印表格输出的标题。默认值为false

-o, --output string

选择输出格式。输出格式包括junitsariftablecsvjson。默认值为table

-r, --retries int

设置在退出作为错误之前的重试次数。默认值为3

-d, --retry-delay int

设置以秒为单位的重试之间等待的时间。默认值为3

--row-jsonpath-expressions string

使用JSON路径表达式从JSON对象创建行。更多详情,请运行roxctl image check --help命令。

--send-notifications

定义是否要在违规事件中发送通知。默认值为false