4.2. 使用基于代理的安装程序安装 OpenShift Container Platform

流程

1. 使用您的登录凭证登录到 Red Hat Hybrid Cloud Console。
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. 登录 OpenShift CLI (oc)。

2. 运行以下命令检查您的发行镜像有效负载：

   $ ./openshift-install version

   输出示例

   ./openshift-install 4.19.0
   built from commit abc123def456
   release image quay.io/openshift-release-dev/ocp-release@sha256:123abc456def789ghi012jkl345mno678pqr901stu234vwx567yz0
   release architecture amd64

   如果您使用带有 multi 有效负载的发行镜像，这个命令的输出中显示的发行架构是默认的架构。

3. 要检查有效负载的架构，请运行以下命令：

   $ oc adm release info <release_image> -o jsonpath="{ .metadata.metadata}" 

   1

   1

   将 <release_image> 替换为发行镜像。例如：quay.io/openshift-release-dev/ocp-release@sha256:123abc456def789ghi012jkl345mno678pqr901stu234vwx567yz0。

   当发行镜像使用 multi 有效负载时的输出示例：

   {"release.openshift.io architecture":"multi"}

   如果使用带有 multi 有效负载的发行镜像，则可以在不同的架构上安装集群，如 arm64, amd64, s390x, 和 ppc64le。否则，您只能在 openshift-install version 命令的输出中所显示的发行构架上安装集群。

流程

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

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

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

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

   $ mkdir ~/<directory_name>

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

   $ cat << EOF > ./<directory_name>/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: 

   4

   
     none: {}
   pullSecret: '<pull_secret>' 

   5

   
   sshKey: '<ssh_pub_key>' 

   6

   
   EOF

   1

   指定系统架构。有效值为 amd64,arm64,ppc64le, 和 s390x。

   如果使用带有 multi 有效负载的发行镜像，则可以在不同的架构上安装集群，如 arm64, amd64, s390x, 和 ppc64le。否则，您只能在 openshift-install version 命令的输出中所显示的发行构架上安装集群。如需更多信息，请参阅"验证安装基于代理的安装程序集群的受支持架构"。

   2

   必需。指定集群名称。

   3

   要安装的集群网络插件。默认值 OVNKubernetes 是唯一支持的值。

   4

   指定您的平台。

   注意

   对于裸机平台，默认使用 install-config.yaml 文件的 platform 部分中进行的主机设置，除非它们被 agent-config.yaml 文件中的配置覆盖。

   5

   指定 pull secret。

   6

   指定 SSH 公钥。

   注意

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

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

   双栈网络示例

   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: v1beta1
   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 值匹配的发现设备。

   注意

   对于 IBM Z 上的 FCP 多路径配置，此参数是必须的。

   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. 运行以下命令来生成 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 集群清单中。

   注意

   如果您已经生成了 ZTP 清单，请跳过这一步。

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

   $ cd <installation_directory>/cluster-manifests

3. 在 agent-cluster-install.yaml 文件中添加以下部分：

   diskEncryption:
       enableOn: all 

   1

   
       mode: tang 

   2

   
       tangServers: "server1": "http://tang-server-1.example.com:7500" 

   3

   1

   指定要启用磁盘加密的节点。有效值为 none, all, masters, 和 workers。

   2

   指定要使用的磁盘加密模式。有效值为 tpmv2 和 tang。

   3

   可选：如果您使用 Tang，请指定 Tang 服务器。

流程

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, 或 agent.s390x.iso 镜像。

流程

1. 引导 RHEL KVM 机器。

2. 要部署虚拟服务器，请使用以下参数运行 virt-install 命令：

   ISO 引导

   $ virt-install
       --name <vm_name> \
       --autostart \
       --memory=<memory> \
       --cpu host \
       --vcpus=<vcpus> \
       --cdrom \<path_to_image>/<agent_iso_image> \ 

   1

   
       --disk pool=default,size=<disk_pool_size> \
       --network network:default,mac=<mac_address> \
       --graphics none \
       --noautoconsole \
       --os-variant rhel9.0 \
       --wait=-1

   1

   对于 --cdrom 参数，指定本地服务器上的 ISO 镜像的位置，例如 <path_to_image>/home/<image>.iso。

   注意

   对于在 IBM Z 上使用 DASD 设备的基于 KVM 的安装，必须使用 fdasd 分区工具创建一个分区（例如 /dev/dasdb1）。

3. 可选：启用 FIPS 模式。

   要使用 RHEL KVM 在 IBM Z® 集群上启用 FIPS 模式，您必须使用 PXE 引导，并使用以下参数运行 virt-install 命令：

   PXE 引导

   $ virt-install \
      --name <vm_name> \
      --autostart \
      --ram=16384 \
      --cpu host \
      --vcpus=8 \
      --location <path_to_kernel_initrd_image>,kernel=kernel.img,initrd=initrd.img \

   1

   
      --disk <qcow_image_path> \
      --network network:macvtap ,mac=<mac_address> \
      --graphics none \
      --noautoconsole \
      --wait=-1 \
      --extra-args "rd.neednet=1 nameserver=<nameserver>" \
      --extra-args "ip=<IP>::<nameserver>::<hostname>:enc1:none" \
      --extra-args "coreos.live.rootfs_url=http://<http_server>:8080/agent.s390x-rootfs.img" \
      --extra-args "random.trust_cpu=on rd.luks.options=discard" \
      --extra-args "ignition.firstboot ignition.platform.id=metal" \
      --extra-args "console=tty1 console=ttyS1,115200n8" \
      --extra-args "coreos.inst.persistent-kargs=console=tty1 console=ttyS1,115200n8" \
      --extra-args "fips=1" \

   2

   
      --osinfo detect=on,require=off

   注意

   对于在 IBM Z 上使用 DASD 设备的基于 KVM 的安装，必须使用 fdasd 分区工具创建一个分区（例如 /dev/dasdb1）。

   1

   对于 --location 参数，指定 HTTP 或 HTTPS 服务器中的 kernel/initrd 的位置。

   2

   要启用 FIPS 模式，请指定 fips=1。除了 install-config.yaml 文件中将 fips 参数设置为 true 外，还需要此条目。

   注意

   目前，只支持 PXE 引导在 IBM Z® 上启用 FIPS 模式。

流程

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