1.15. 使用 must-gather 命令进行故障排除
1.15.1. 症状:带有多集群全局 hub 的错误
您可能会遇到多集群全局 hub 的各种错误。您可以运行 must-gather
命令来排除多集群全局 hub 的问题。
1.15.2. 解决问题: 运行 must-gather 命令进行 dubugging
运行 must-gather
命令来收集详情、日志并采取调试问题的步骤。当您请求支持时,这个调试信息会很有用。oc adm must-gather
CLI 命令会收集解决问题通常需要的集群信息,包括:
- 资源定义
- 服务日志
1.15.2.1. 先决条件
运行 must-gather
命令必须满足以下先决条件:
-
使用具有
cluster-admin
角色的用户访问全局 hub 和受管 hub 集群。 - 安装了 OpenShift Container Platform CLI(oc)。
1.15.2.2. 运行 must-gather 命令
完成以下步骤,使用 must-gather 命令收集信息:
-
了解
must-gather
命令以及通过阅读 OpenShift Container Platform 文档中的 收集集群数据 来安装所需的先决条件。 登录到您的全局 hub 集群。对于典型的用例,在登录到您的全局 hub 集群时运行以下命令:
oc adm must-gather --image=quay.io/stolostron/must-gather:SNAPSHOTNAME
如果要检查受管 hub 集群,请在这些集群中运行
must-gather
命令。可选:如果要将结果保存到
SOMENAME
目录中,您可以运行以下命令而不是上一步中的结果:oc adm must-gather --image=quay.io/stolostron/must-gather:SNAPSHOTNAME --dest-dir=<SOMENAME> ; tar -cvzf <SOMENAME>.tgz <SOMENAME>
您可以为目录指定不同的名称。
注意: 命令包括创建 gzip 压缩 tarball 文件所需的添加内容。
从 must-gather
命令收集以下信息:
-
两个对等级别:
cluster-scoped-resources
和namespaces
资源。 - 每个对等级别下的子类:用于 cluster-scope 和 namespace-scoped 资源的自定义资源定义的 API 组。
- 每个的下一个级别:按 kind 进行排序的 YAML 文件。
-
对于全局 hub 集群,您可以在命名空间资源中检查
PostgresCluster
和Kafka
。 -
对于全局 hub 集群,您可以检查 multicluster global hub 相关 pod,并在
命名空间
资源的pod
中记录日志。 -
对于受管 hub 集群,您可以检查 multicluster global hub 代理 pod,并在
命名空间
资源的pod
中记录日志。