14.3. 使用基于代理的安装程序安装 OpenShift Container Platform 集群

1. 使用您的登录凭证登录到 OpenShift Container Platform web 控制台。
2. 进入到 Datacenter。
3. 在本地点 Run Agent-based Installer。
4. 为 OpenShift Installer 和命令行界面选择操作系统和架构。
5. 点 Download Installer 下载并提取安装程序。
6. 通过点 Download pull secret 或 Copy pull secret 下载或复制 pull secret。
7. 点 Download command-line tools，将 openshift-install 二进制文件放在 PATH 中的目录中。

流程

1. 运行以下命令来安装 nmstate 依赖项：

   $ sudo dnf install /usr/bin/nmstatectl -y

2. 将 openshift-install 二进制文件放到 PATH 中的目录中。

3. 运行以下命令，创建一个目录来存储安装配置：

   $ mkdir ~/<directory_name>

   注意

   这是基于代理的安装的首选方法。使用 GitOps ZTP 清单是可选的。

4. 运行以下命令来创建 install-config.yaml 文件：

   $ cat << EOF > ./my-cluster/install-config.yaml
   apiVersion: v1
   baseDomain: test.example.com
   compute:
   - architecture: amd64 1
     hyperthreading: Enabled
     name: worker
     replicas: 0
   controlPlane:
     architecture: amd64
     hyperthreading: Enabled
     name: master
     replicas: 1
   metadata:
     name: sno-cluster 2
   networking:
     clusterNetwork:
     - cidr: 10.128.0.0/14
       hostPrefix: 23
     machineNetwork:
     - cidr: 192.168.0.0/16
     networkType: OVNKubernetes 3
     serviceNetwork:
     - 172.30.0.0/16
   platform:
     none: {}
   pullSecret: '<pull_secret>' 4
   sshKey: '<ssh_pub_key>' 5
   EOF

   1

   指定系统架构，有效值为 amd64 和 arm64。

   2

   必需。指定集群名称。

   3

   指定要安装的集群网络插件。支持的值有 OVNKubernetes 和 OpenShiftSDN。默认值为 OVNKubernetes。

   4

   指定 pull secret。

   5

   指定 SSH 公钥。

   注意

   如果将平台设置为 vSphere 或 baremetal，您可以使用三种方式为集群节点配置 IP 地址端点：

   • IPv4
   • IPv6
   • IPv4 和 IPv6 并行 (dual-stack)

   IPv6 仅在裸机平台上被支持。

   双栈网络示例

   networking:
     clusterNetwork:
       - cidr: 172.21.0.0/16
         hostPrefix: 23
       - cidr: fd02::/48
         hostPrefix: 64
     machineNetwork:
       - cidr: 192.168.11.0/16
       - cidr: 2001:DB8::/32
     serviceNetwork:
       - 172.22.0.0/16
       - fd03::/112
     networkType: OVNKubernetes
   platform:
     baremetal:
       apiVIPs:
       - 192.168.11.3
       - 2001:DB8::4
       ingressVIPs:
       - 192.168.11.4
       - 2001:DB8::5

   注意

   使用断开连接的镜像 registry 时，您必须将之前为镜像 registry 创建的证书文件添加到 install-config.yaml 文件的 additionalTrustBundle 字段中。

5. 运行以下命令来创建 agent-config.yaml 文件：

   $ cat > agent-config.yaml << EOF
   apiVersion: v1alpha1
   kind: AgentConfig
   metadata:
     name: sno-cluster
   rendezvousIP: 192.168.111.80 1
   hosts: 2
     - hostname: master-0 3
       interfaces:
         - name: eno1
           macAddress: 00:ef:44:21:e6:a5
       rootDeviceHints: 4
         deviceName: /dev/sdb
       networkConfig: 5
         interfaces:
           - name: eno1
             type: ethernet
             state: up
             mac-address: 00:ef:44:21:e6:a5
             ipv4:
               enabled: true
               address:
                 - ip: 192.168.111.80
                   prefix-length: 23
               dhcp: false
         dns-resolver:
           config:
             server:
               - 192.168.111.1
         routes:
           config:
             - destination: 0.0.0.0/0
               next-hop-address: 192.168.111.2
               next-hop-interface: eno1
               table-id: 254
   EOF

   1

   此 IP 地址用于确定哪些节点执行 bootstrap 过程，以及运行 assisted-service 组件。当您没有在 networkConfig 参数中指定至少一个主机的 IP 地址时，您必须提供 rendezvous IP 地址。如果没有提供此地址，则会从提供的主机的 networkConfig 中选择一个 IP 地址。

   2

   可选：主机配置。定义的主机数量不能超过 install-config.yaml 文件中定义的主机总数，这是 compute.replicas 和 controlPlane.replicas 参数的值的总和。

   3

   可选：覆盖从动态主机配置协议(DHCP)或反向 DNS 查找中获取的主机名。每个主机必须具有由这些方法提供的唯一主机名。

   4

   启用将 Red Hat Enterprise Linux CoreOS (RHCOS)镜像置备到特定设备。它会按照发现设备的顺序检查设备，并将发现的值与 hint 值进行比较。它使用第一个与 hint 值匹配的发现设备。

   5

   可选：以 NMState 格式配置主机的网络接口。

流程

1. 运行以下命令来生成 ZTP 集群清单：

   $ openshift-install agent create cluster-manifests --dir <installation_directory>

   重要

   如果您已创建了 install-config.yaml 和 agent-config.yaml 文件，则这些文件将被删除，并替换为通过这个命令生成的集群清单。

   在运行 openshift-install agent create cluster-manifests 命令时，对 install-config.yaml 和 agent-config.yaml 文件所做的任何配置都会导入到 ZTP 集群清单中。

2. 运行以下命令，进入 cluster-manifests 目录：

   $ cd <installation_directory>/cluster-manifests

3. 在 cluster-manifests 目录中配置清单文件。如需示例文件，请参阅 "Sample GitOps ZTP 自定义资源" 部分。

4. 断开连接的集群： 如果您在生成 ZTP 清单前没有在 install-config.yaml 文件中定义镜像配置，请执行以下步骤：

   1. 运行以下命令来进入 mirror 目录：

      $ cd ../mirror

   2. 在 mirror 目录中配置清单文件。

流程

1. 运行以下命令来创建代理镜像：

   $ openshift-install --dir <install_directory> agent create image

   注意

   Red Hat Enterprise Linux CoreOS (RHCOS) 支持主磁盘上的多路径，允许对硬件故障进行更强大的弹性，以实现更高的主机可用性。在代理 ISO 镜像中默认启用多路径，默认 /etc/multipath.conf 配置。

2. 在裸机机器上引导 agent.x86_64.iso 或 agent.aarch64.iso 镜像。

流程

1. 等待代理控制台应用程序检查是否可以从 registry 中拉取配置的发行镜像。

2. 如果代理控制台应用程序指出安装程序连接检查已通过，请等待提示符超时。

   注意

   您仍然可以选择查看或更改网络配置设置，即使连接检查已通过了。

   但是，如果您选择与代理控制台应用程序交互，而不是让其超时，您必须手动退出 TUI 才能继续安装。

3. 如果代理控制台应用程序检查失败（由 发行镜像 URL pull 检查旁的红色图标表示），请按照以下步骤重新配置主机的网络设置：

   1. 阅读 TUI 的检查错误部分。本节显示特定于失败检查的错误消息。

      
   2. 选择 Configure network 以启动 NetworkManager TUI。
   3. 选择 Edit a connection 并选择您要重新配置的连接。
   4. 编辑配置并选择 OK 保存您的更改。
   5. 选择 Back 返回到 NetworkManager TUI 的主屏幕。
   6. 选择 Activate a Connection。
   7. 选择重新配置的网络来取消激活它。
   8. 再次选择重新配置的网络来重新激活它。
   9. 选择 Back，然后选择 Quit 以返回到代理控制台应用程序。
   10. 至少等待五秒，以便持续网络检查使用新的网络配置重新启动。
   11. 如果 Release image URL pull 检查成功，并显示 URL 旁边的绿色图标，请选择 Quit 退出代理控制台应用程序并继续安装。

流程

1. 可选： 要了解 bootstrap 主机（渲染主机）何时重启，请运行以下命令：

   $ ./openshift-install --dir <install_directory> agent wait-for bootstrap-complete \ 1
       --log-level=info 2

   1

   对于 <install_directory>，请指定到生成代理 ISO 的目录的路径。

   2

   要查看不同的安装详情，请指定 warn、debug 或 error，而不是 info。

   输出示例

   ...................................................................
   ...................................................................
   INFO Bootstrap configMap status is complete
   INFO cluster bootstrap is complete

   当 Kubernetes API 服务器提示已在 control plane 机器上引导它时，该命令会成功。

2. 要跟踪进度并验证安装是否成功，请运行以下命令：

   $ openshift-install --dir <install_directory> agent wait-for install-complete 1

   1

   对于 <install_directory> 目录，请指定到生成代理 ISO 的目录的路径。

   输出示例

   ...................................................................
   ...................................................................
   INFO Cluster is installed
   INFO Install complete!
   INFO To access the cluster as the system:admin user when using 'oc', run
   INFO     export KUBECONFIG=/home/core/installer/auth/kubeconfig
   INFO Access the OpenShift web-console here: https://console-openshift-console.apps.sno-cluster.test.example.com