第 1 章诊断问题

要开始对 Ansible Automation Platform 进行故障排除，请使用 OpenShift Container Platform 上的 must-gather 命令或基于虚拟机的安装上的 sos 实用程序来收集配置和诊断信息。您可以将这些工具的输出附加到支持问题单中。

1.1. 使用 must-gather 命令在 OpenShift Container Platform 上对 Ansible Automation Platform 进行故障排除

oc adm must-gather 命令行界面(CLI)命令从 OpenShift Container Platform 上部署的 Ansible Automation Platform 安装收集信息。它收集调试问题通常需要的信息，包括资源定义和服务日志。

运行 oc adm must-gather CLI 命令会创建一个新目录，其中包含可用于排除故障或附加到支持问题单的新目录。

如果您的 OpenShift 环境无法访问 registry.redhat.io，且您无法运行 must-gather 命令，则运行 oc adm inspect 命令。

先决条件

流程

登录到集群：
```
oc login <openshift_url>
```
根据集群中的访问级别运行以下命令之一：
- 在整个集群中运行 must-gather ：
```
oc adm must-gather --image=registry.redhat.io/ansible-automation-platform-24/aap-must-gather-rhel8 --dest-dir <dest_dir>
```
  - --image 指定收集数据的镜像
  - --dest-dir 指定输出的目录
- 为集群中的特定命名空间运行 must-gather ：
```
oc adm must-gather --image=registry.redhat.io/ansible-automation-platform-24/aap-must-gather-rhel8 --dest-dir <dest_dir> – /usr/bin/ns-gather <namespace>
```
  - - /usr/bin/ns-gather 将 must-gather 数据收集限制为指定命名空间
要将 must-gather 归档附加到支持问题单中，请从之前创建的 must-gather 目录创建一个压缩文件，并将其附加到您的支持问题单中。
- 例如，在使用 Linux 操作系统的计算机中，运行以下命令，将 < must-gather-local.5421342344627712289/&gt; 替换为 must-gather 目录名称：
```
$ tar cvaf must-gather.tar.gz <must-gather.local.5421342344627712289/>
```

其他资源

有关安装 OpenShift CLI (oc)的详情，请参考 OpenShift Container Platform 文档中的安装 OpenShift CLI。
有关运行 oc adm inspect 命令的详情，请参考 OpenShift Container Platform 文档中的 ocm adm inspect 部分。