1.3.3. 检查策略合规性

您可以使用 roxctl CLI 检查部署 YAML 文件和策略合规性的镜像。

当使用 部署检查、镜像检查 或镜像扫描命令检查策略合规性时，您可以使用 -o 选项指定输出格式。这个选项决定了在终端中如何显示命令的输出。

您可以通过在命令中添加 -o 选项来更改输出格式，并指定 json、表、csv 或 junit 的格式。

对于考试，以下命令检查部署，然后以 csv 格式显示结果：

roxctl -e "$ROX_CENTRAL_ADDRESS" \
  deployment check --file =<yaml_filename> \
  -o csv

$ roxctl -e "$ROX_CENTRAL_ADDRESS" \
  deployment check --file =<yaml_filename> \
  -o csv

Copy to Clipboard

Toggle word wrap

注意

当您没有为输出格式指定 -o 选项时，会使用以下默认行为：

部署检查 的格式，镜像检查 命令为 table。
镜像扫描命令的默认输出格式是 json。这是与旧版 CLI 兼容的旧 JSON 格式输出。要获得新的 JSON 格式的输出，请使用格式指定选项，格式为 -o json。

有不同的选项可用于配置输出。下表列出了可用的选项和格式。

Expand

选项	描述	格式
`--compact-output`	使用这个选项以紧凑格式显示 JSON 输出。	`json`
`--headers`	使用这个选项指定自定义标头。	`表` 和 `csv`
`--no-header`	使用此选项省略输出中的标头行。	`表` 和 `csv`
`--row-jsonpath-expressions`	使用这个选项指定 GJSON 路径来从输出中选择特定项目。例如，若要获取部署检查的策略名称和严重性，请使用以下命令： `$ roxctl -e "$ROX_CENTRAL_ADDRESS" \ deployment check --file=<yaml_filename> \ -o table --headers POLICY-NAME,SEVERITY \ --row-jsonpath-expressions="{results.#.violatedPolicies.#.name,results.#.violatedPolicies.#.severity}"` Copy to Clipboard Toggle word wrap	`表` 和 `csv`
`--merge-output`	使用这个选项合并具有相同值的表单元单元。	`表`
`标头( header-as-comment)`	使用此选项将标题行作为注释包含在输出中。	`csv`
`--junit-suite-name`	使用此选项指定 JUnit 测试套件的名称。	`junit`

以下命令检查 YAML 部署文件中您的安全策略的构建时间和运行时违反情况。使用这个命令验证：

roxctl -e "$ROX_CENTRAL_ADDRESS" deployment check --file=<yaml_filename>

$ roxctl -e "$ROX_CENTRAL_ADDRESS" deployment check --file=<yaml_filename>

Copy to Clipboard

Toggle word wrap

以下命令检查镜像中安全策略的构建时违反情况。

roxctl -e "$ROX_CENTRAL_ADDRESS" image check --image=<image_name>

$ roxctl -e "$ROX_CENTRAL_ADDRESS" image check --image=<image_name>

Copy to Clipboard

Toggle word wrap

您还可以检查特定镜像的扫描结果。

以下命令以 JSON 格式返回镜像中找到的组件和漏洞。格式在 API 引用中定义。

roxctl -e "$ROX_CENTRAL_ADDRESS" image scan --image <image_name>

$ roxctl -e "$ROX_CENTRAL_ADDRESS" image scan --image <image_name>

Copy to Clipboard

Toggle word wrap

要让 Red Hat Advanced Cluster Security for Kubernetes 从关联的 registry 和扫描程序重新拉取镜像元数据和镜像扫描结果，请添加 --force 选项。

注意

要检查特定的镜像扫描结果，必须具有镜像资源的 读写权限 的令牌。默认 持续集成 系统角色已经具有所需的权限。