搜索

6.6. Clair 安全扫描程序

download PDF

6.6.1. Clair 故障排除问题

使用以下步骤对 Clair 进行故障排除。

6.6.1.1. 验证镜像兼容性

如果使用 Clair,请确保 Clair 支持您要扫描的镜像。Clair 具有特定要求,不支持所有镜像格式或配置。

如需更多信息,请参阅 Clair 漏洞数据库

6.6.1.2. allowlisting Clair updaters

如果您在代理配置后面使用 Clair,则必须列出代理或防火墙配置中的 updaters。如需有关 updater URL 的更多信息,请参阅 Clair updater URL

6.6.1.3. 更新 Clair 扫描程序及其依赖项

确保您使用最新版本的 Clair 安全扫描程序。过时的版本可能缺少对较新镜像格式的支持,或者可能存在一个已知问题。

使用以下步骤检查 Clair 的版本。

注意

检查 Clair 日志也可用于检查 Clair 日志中是否有 updaters 微服务的错误。默认情况下,Clair 每 30 分钟更新漏洞数据库。

步骤

  1. 检查您的 Clair 版本。

    1. 如果您在 OpenShift Container Platform 上的 Red Hat Quay 上运行 Clair,请输入以下命令:

      $ oc logs clair-pod
    2. 如果您正在运行 Red Hat Quay 的独立部署并使用 Clair 容器,请输入以下命令:

      $ podman logs clair-container

      输出示例

      "level":"info",
      "component":"main",
      "version":"v4.5.1",

6.6.1.4. 为 Clair 启用调试模式

默认情况下,Clair 的调试模式被禁用。您可以通过更新 clair-config.yaml 文件为 Clair 启用调试模式。

先决条件

使用以下步骤为 Clair 启用调试模式。

步骤

  1. 更新 clair-config.yaml 文件,使其包含 debug 选项。

    1. 在独立 Red Hat Quay 部署中:

      1. 在您的 clair-config.yaml 文件中添加以下配置字段:

        log_level: debug
      2. 输入以下命令重启 Clair 部署:

        $ podman restart <clair_container_name>
    2. 在 OpenShift Container Platform 部署的 Red Hat Quay 中:

      1. 在 OpenShift Container Platform web 控制台中,点 Operators Installed Operators Quay Registry
      2. 单击 registry 的名称,如 示例 Registry。您将被重定向到 registry 的 Details 页面。
      3. 单击 Config Bundle Secret,如 example-registry-config-bundle-xncls
      4. 通过在 secret 的 Details 页面的 Data 部分查找 clair-config.yaml 文件,确认您正在运行自定义 Clair 配置。
      5. 如果您有一个 clair-config.yaml 文件,请点击 Actions Edit Secret。如果没有,请参阅"使用受管 Clair 数据库运行自定义 Clair 配置"。
      6. 更新 clair-config.yaml 文件,使其包含 log_level: debug 配置变量。例如:

        log_level: debug
      7. 点击 Save
      8. 您可以点击 Workloads Pods 来检查 Clair 部署的状态。clair-app pod 应该会在 Ready 类别下报告 1/1
      9. 您可以点 Ready Logsclair-app pod 确认 Clair 正在返回调试信息。

6.6.1.5. 检查 Clair 配置

检查 Clair config.yaml 文件,以确保没有可能导致问题的错误配置或不一致。如需更多信息,请参阅 Clair 配置概述

6.6.1.6. 检查镜像元数据

在某些情况下,您可能会收到 Unsupported 信息。这可能表示扫描程序无法从镜像中提取必要的元数据。检查镜像元数据是否已正确格式化并可访问。

其他资源

如需更多信息,请参阅 Clair 故障排除

Red Hat logoGithubRedditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务,以及可以信赖的内容,帮助红帽用户创新并实现他们的目标。

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情,请参阅红帽博客.

關於紅帽

我们提供强化的解决方案,使企业能够更轻松地跨平台和环境(从核心数据中心到网络边缘)工作。

© 2024 Red Hat, Inc.