第 1 章 故障排除

在使用故障排除指南前，您可以运行 oc adm must-gather 命令来收集详情、日志和步骤来调试问题。

另外，查看您基于角色的访问。详情请参阅 基于角色的访问控制。

1.1. must-gather

首先，根据您的具体情况来决定在故障排除的过程中如何使用 must-gather 命令。

  • 场景一：如果您的问题已被记录，使用 已记录的故障排除文档部分进行解决。这个指南按照产品的主要功能进行组织。

    在这种情况下，您可以参阅本指南来查看您的问题的解决方案是否在文档中。例如，在创建建集群时出现问题，您可能会在这个指南的 管理集群部分中找到解决方案。

  • 场景 2：如果这个指南中没有与您的问题相关的内容，运行 must-gather 命令并使用输出来调试问题。
  • 场景 3：无法使用 must-gather 命令的输出结果无法帮助解决您的问题，请向红帽支持提供您的输出。

请参阅以下流程来使用 must-gather 命令：

要进行故障排除，参阅可以使用 must-gather 命令进行调试的用户情景信息，然后使用这个命令进行故障排除。

需要的访问权限：集群管理员

  1. 了解 must-gather 命令以及使用它的前提条件，Red Hat OpenShift Container Platform：收集数据。

  2. 登录到您的集群。对于通常的用例，在登录到您的 hub 集群时运行 must-gather 命令。

    备注：要检查您的受管集群，找到位于 cluster-scoped-resources 目录中的 gather-managed.log 文件： 

    <your-directory>/cluster-scoped-resources/gather-managed.log>

    检查 JOINED 和 AVAILABLE 栏没有被设置为 True 的受管集群。您可以在这些没有以 True 状态连接的集群中运行 must-gather 命令。

  3. 添加用于收集数据和目录的 Red Hat Advanced Cluster Management for Kubernetes 镜像。运行以下命令，在其中提供您要插入的镜像和输出目录： 

    oc adm must-gather --image=registry.redhat.io/rhacm2/acm-must-gather-rhel8:v2.1.0 --dest-dir=<directory>

  4. 进入您指定的目录查看输出。输出以以下级别进行组织：

    • 两个对等级别：cluster-scoped-resources 和 namespace 资源。
    • 每个子级别：用于 cluster-scope 和 namespace-scoped 资源的自定义资源定义的 API 组。
    • 每个的下一个级别：按 kind 进行排序的 YAML 文件。