1.2. 运行 must-gather 命令进行故障排除

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

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

场景一： 如果您的问题已被记录，使用已记录的故障排除文档部分进行解决。这个指南按照产品的主要功能进行组织。
在这种情况下，您可以参阅本指南来查看您的问题的解决方案是否在文档中。例如，在创建建集群时出现问题，您可能会在这个指南的 管理集群部分中找到解决方案。
情况 2：如果这个指南中没有与您的问题相关的内容，运行 must-gather 命令并使用输出来调试问题。
情况 3：无法使用 must-gather 命令的输出结果无法帮助解决您的问题，请向红帽支持提供您的输出。

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

了解 must-gather 命令以及按照 Red Hat OpenShift Container Platform 文档中的收集集群数据所需的先决条件。
登录到您的集群。添加用于收集数据和目录的 Red Hat Advanced Cluster Management for Kubernetes 镜像。运行以下命令，在其中提供您要插入的镜像和输出目录：
```
oc adm must-gather --image=registry.redhat.io/rhacm2/acm-must-gather-rhel8:v2.8 --dest-dir=<directory>
```
对于通常的用例，在登录到您的 hub 集群时运行 must-gather 命令。
注：如果要检查您的受管集群，找到位于 cluster-scoped-resources 目录中的 gather-managed.log 文件：
```
<your-directory>/cluster-scoped-resources/gather-managed.log>
```
检查 JOINED 和 AVAILABLE 栏没有被设置为 True 的受管集群。您可以在这些没有以 True 状态连接的集群中运行 must-gather 命令。
进入您指定的目录查看输出。输出以以下级别进行组织：
- 两个对等级别：cluster-scoped-resources 和 namespace 资源。
- 每个对等级别下的子类：用于 cluster-scope 和 namespace-scoped 资源的自定义资源定义的 API 组。
- 每个子类的下一级：按 kind 进行排序的 YAML 文件。

在断开连接的环境中，按照以下步骤运行 must-gather 命令：

在断开连接的环境中，将 RedHat operator 目录镜像镜像（mirror）到其 mirror registry 中。如需更多信息，请参阅在断开连接的网络中安装。

运行以下命令来收集所有信息：

REGISTRY=<internal.repo.address:port>
IMAGE1=$REGISTRY/rhacm2/acm-must-gather-rhel8:v2.8
oc adm must-gather --image=$IMAGE1 --dest-dir=<directory>

如果您在当前支持的某个版本或产品文档时遇到问题，请访问红帽支持，您可以在其中进行故障排除、查看知识库文章、与支持团队连接，或者创建一个问题单。您必须使用您的红帽凭证登录。