第 1 章 收集安装日志

为帮助排查 OpenShift Container Platform 安装失败的问题，您可以从 bootstrap 和 control plane 或 master 机器中收集日志。

先决条件

  • 已尝试安装 OpenShift Container Platform 集群，但安装失败。
  • 您为安装程序提供了 SSH 密钥，且该密钥已加入到正在运行的 ss-agent 进程中。

1.1. 从失败安装中收集日志

如果为安装程序提供了 SSH 密钥，则可以收集与失败安装相关的数据。

注意

用于收集失败安装日志的命令与从正在运行的集群收集日志时所用的命令不同。如果需要从正在运行的集群收集日志，请使用 oc adm must-gather 命令。

先决条件

  • OpenShift Container Platform 安装在 bootstrap 过程完成前失败。bootstrap 节点必须正在运行，并可通过 SSH 访问。
  • ssh-agent 进程在您的计算机上处于活跃状态，并且为 ssh-agent 进程和安装程序提供了相同的 SSH 密钥。
  • 如果尝试在您置备的基础架构中安装集群，则一定需要有 control plane 或 master 机器的完全限定域名。

流程

  1. 生成从 bootstrap 和 control plane 机器获取安装日志的命令：

    • 如果使用了安装程序置备的基础架构，请运行以下命令： 

      $ ./openshift-install gather bootstrap --dir=<directory> 1
      1
      installation_directory 是安装程序所创建的用来保存 OpenShift Container Platform 定义文件的目录。

      对于安装程序置备的基础架构，安装程序会保存有关集群的信息，因此您不用指定主机名或 IP 地址。

    • 如果使用了您置备的基础架构，请运行以下命令： 

      $ ./openshift-install gather bootstrap --dir=<directory> \ 1
    --bootstrap <bootstrap_address> \ 2
    --master <master_1_address> \ 3
    --master <master_2_address> \ 4
    --master <master_3_address>" 5
      1
      installation_directory 是安装程序所创建的用来保存 OpenShift Container Platform 定义文件的目录。
      2
      <bootstrap_address> 是集群 bootstrap 机器的完全限定域名或 IP 地址。
      3 4 5
      <master_address> 是集群中 control plane 或 master 机器的完全限定域名或 IP 地址。
      注意

      默认集群包含三个 control plane 机器。如所示，列出所有 control plane 机器，无论集群使用了多少个。

    命令输出类似以下示例： 

    INFO Pulling debug logs from the bootstrap machine
INFO Bootstrap gather logs captured here "<directory>/log-bundle-<timestamp>.tar.gz"

    如果需要创建关安装失败的红帽支持问题单，请在问题单中附上压缩日志。