使用基于代理的安装程序安装内部集群

1. 首选方法：install-config.yaml 和 agent-config.yaml

   agent-config.yaml.file 示例

   cat > agent-config.yaml << EOF
   apiVersion: v1alpha1
   kind: AgentConfig
   metadata:
     name: sno-cluster
   rendezvousIP: 192.168.111.80 

   1

   
   hosts:
     - hostname: master-0
       interfaces:
         - name: eno1
           macAddress: 00:ef:44:21:e6:a5 

   2

   
       networkConfig:
         interfaces:
           - name: eno1
             type: ethernet
             state: up
             mac-address: 00:ef:44:21:e6:a5
             ipv4:
               enabled: true
               address:
                 - ip: 192.168.111.80 

   3

   
                   prefix-length: 23 

   4

   
               dhcp: false
         dns-resolver:
           config:
             server:
               - 192.168.111.1 

   5

   
         routes:
           config:
             - destination: 0.0.0.0/0
               next-hop-address: 192.168.111.1 

   6

   
               next-hop-interface: eno1
               table-id: 254
   EOF

   Copy to Clipboard Toggle word wrap

   1

   如果没有为 rendezvousIP 字段指定值，则会从 networkConfig 字段中指定的静态 IP 地址选择一个地址。

   2

   主机上接口的 MAC 地址，用于决定要将配置应用到的主机。

   3

   目标裸机主机的静态 IP 地址。

   4

   目标裸机主机的静态 IP 地址子网前缀。

   5

   目标裸机主机的 DNS 服务器。

   6

   节点流量的下一跳地址。这必须与为特定接口设定的 IP 地址位于同一个子网中。

2. 可选方法：GitOps ZTP 清单

   GitOps ZTP 自定义资源的可选方法包含 6 个自定义资源 ; 您可以在 nmstateconfig.yaml 文件中配置静态 IP。

   apiVersion: agent-install.openshift.io/v1beta1
   kind: NMStateConfig
   metadata:
     name: master-0
     namespace: openshift-machine-api
     labels:
       cluster0-nmstate-label-name: cluster0-nmstate-label-value
   spec:
     config:
       interfaces:
         - name: eth0
           type: ethernet
           state: up
           mac-address: 52:54:01:aa:aa:a1
           ipv4:
             enabled: true
             address:
               - ip: 192.168.122.2 

   1

   
                 prefix-length: 23 

   2

   
             dhcp: false
       dns-resolver:
         config:
           server:
             - 192.168.122.1 

   3

   
       routes:
         config:
           - destination: 0.0.0.0/0
             next-hop-address: 192.168.122.1 

   4

   
             next-hop-interface: eth0
             table-id: 254
     interfaces:
       - name: eth0
         macAddress: 52:54:01:aa:aa:a1 

   5

   Copy to Clipboard Toggle word wrap

   1

   目标裸机主机的静态 IP 地址。

   2

   目标裸机主机的静态 IP 地址子网前缀。

   3

   目标裸机主机的 DNS 服务器。

   4

   节点流量的下一跳地址。这必须与为特定接口设定的 IP 地址位于同一个子网中。

   5

   主机上接口的 MAC 地址，用于决定要将配置应用到的主机。

1. API 负载均衡器 ：提供一个通用端点，供用户（包括人工和机器）与平台交互和配置。配置以下条件：

   • 仅第 4 层负载均衡.这可称为 Raw TCP、SSL Passthrough 或 SSL 网桥模式。如果使用 SSL Bridge 模式，必须为 API 路由启用 Server Name Indication(SNI)。
   • 无状态负载平衡算法。这些选项根据负载均衡器的实施而有所不同。
   重要

   不要为 API 负载均衡器配置会话持久性。

   在负载均衡器的前端和后端配置以下端口：

   Expand

   表 1.5. API 负载均衡器

   port	后端机器（池成员）	internal	外部	描述
   6443	控制平面。您必须为 API 服务器健康检查探测配置 /readyz 端点。	X	X	Kubernetes API 服务器
   22623	控制平面。	X		机器配置服务器

   Show more
   注意

   负载均衡器必须配置为，从 API 服务器关闭 /readyz 端点到从池中移除 API 服务器实例时最多需要 30 秒。在 /readyz 返回错误或健康后的时间范围内，端点必须被删除或添加。每 5 秒或 10 秒探测一次，有两个成功请求处于健康状态，三个成为不健康的请求是经过良好测试的值。

2. 应用程序入口负载均衡器 ：为应用程序流量从集群外部流提供入口点。OpenShift Container Platform 集群需要正确配置入口路由器。

   配置以下条件：

   • 仅第 4 层负载均衡.这可称为 Raw TCP、SSL Passthrough 或 SSL 网桥模式。如果使用 SSL Bridge 模式，您必须为入口路由启用 Server Name Indication(SNI)。
   • 建议根据可用选项以及平台上托管的应用程序类型，使用基于连接的或基于会话的持久性。
   提示

   如果应用程序入口负载均衡器可以看到客户端的真实 IP 地址，启用基于 IP 的会话持久性可以提高使用端到端 TLS 加密的应用程序的性能。

   在负载均衡器的前端和后端配置以下端口：

   Expand

   表 1.6. 应用程序入口负载均衡器

   port	后端机器（池成员）	internal	外部	描述
   443	默认情况下，运行 Ingress Controller Pod、计算或 worker 的机器。	X	X	HTTPS 流量
   80	默认情况下，运行 Ingress Controller Pod、计算或 worker 的机器。	X	X	HTTP 流量

   Show more
   注意

   如果要部署一个带有零计算节点的三节点集群，Ingress Controller Pod 在 control plane 节点上运行。在三节点集群部署中，您必须配置应用程序入口负载均衡器，将 HTTP 和 HTTPS 流量路由到 control plane 节点。

流程

1. 如果您使用 oc-mirror 插件来镜像发行镜像：

   1. 打开位于结果目录中的 imageContentSourcePolicy.yaml，如 oc-mirror-workspace/results-1682697932/。
   2. 在 yaml 文件的 repositoryDigestMirrors 部分中复制文本。

2. 如果使用 oc adm release mirror 命令镜像发行镜像：

   • 在命令输出的 imageContentSources 部分中复制文本。
3. 将复制的文本粘贴到 install-config.yaml 文件的 imageContentSources 字段中。

4. 将用于镜像 registry 的证书文件添加到 yaml 文件的 additionalTrustBundle 字段中。

   重要

   该值必须是您用于镜像 registry 的证书文件内容。证书文件可以是现有的可信证书颁发机构，也可以是您为镜像 registry 生成的自签名证书。

   install-config.yaml 文件示例

     additionalTrustBundle: |
       -----BEGIN CERTIFICATE-----
       ZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZ
       -----END CERTIFICATE-----

   Copy to Clipboard Toggle word wrap

5. 如果使用 GitOps ZTP 清单：将 registry.conf 和 ca-bundle.crt 文件添加到 mirror 路径中，以便在代理 ISO 镜像中添加镜像配置。

   注意

   您可以从 oc adm release mirror 命令的输出或 oc mirror 插件创建 registries.conf 文件。/etc/containers/registries.conf 文件的格式已更改。现在它是第 2 版，采用 TOML 格式。

   registry.conf 文件示例

   [[registry]]
   location = "registry.ci.openshift.org/ocp/release" mirror-by-digest-only = true
   
   [[registry.mirror]] location = "virthost.ostest.test.metalkube.org:5000/localimages/local-release-image"
   
   [[registry]]
   location = "quay.io/openshift-release-dev/ocp-v4.0-art-dev" mirror-by-digest-only = true
   
   [[registry.mirror]] location = "virthost.ostest.test.metalkube.org:5000/localimages/local-release-image"

   Copy to Clipboard Toggle word wrap

流程

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. 将 openshift-install 二进制文件放到 PATH 中的目录中。

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

   $ mkdir ~/<directory_name>

   Copy to Clipboard Toggle word wrap

3. 运行以下命令来创建 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: fd01::/48
       hostPrefix: 64
     machineNetwork:
     - cidr: fd2e:6f44:5dd8:c956::/120
     networkType: OVNKubernetes 

   3

   
     serviceNetwork:
     - fd02::/112
   platform: 

   4

   
     none: {}
   pullSecret: '<pull_secret>' 

   5

   
   sshKey: '<ssh_pub_key>' 

   6

   
   additionalTrustBundle: | 

   7

   
     -----BEGIN CERTIFICATE-----
     ZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZ
     -----END CERTIFICATE-----
   imageContentSources: 

   8

   
   - mirrors:
     - <local_registry>/<local_repository_name>/release
     source: quay.io/openshift-release-dev/ocp-release
   - mirrors:
     - <local_registry>/<local_repository_name>/release
     source: quay.io/openshift-release-dev/ocp-v4.0-art-dev
   EOF

   Copy to Clipboard Toggle word wrap

   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 公钥。

   7

   提供用于镜像 registry 的证书文件内容。证书文件可以是现有的可信证书颁发机构，也可以是您为镜像 registry 生成的自签名证书。如果使用断开连接的镜像 registry，则必须指定此参数。

   8

   根据您用来镜像存储库的命令输出提供 imageContentSources 部分。如果使用断开连接的镜像 registry，则必须指定此参数。

   重要

   • 使用 oc adm release mirror 命令时，请使用 imageContentSources 部分中的输出。
   • 使用 oc mirror 命令时，请使用 ImageContentSourcePolicy 文件的 repositoryDigestMirrors 部分，该文件源自运行命令。
   • ImageContentSourcePolicy 资源已弃用。

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

   $ cat > agent-config.yaml << EOF
   apiVersion: v1beta1
   kind: AgentConfig
   metadata:
     name: sno-cluster
   rendezvousIP: fd2e:6f44:5dd8:c956::50 

   1

   
   EOF

   Copy to Clipboard Toggle word wrap

   1

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

流程

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

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

   Copy to Clipboard Toggle word wrap
   注意

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

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

流程

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

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

   注意

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

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

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

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

      

      View larger image

      
   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

   Copy to Clipboard Toggle word wrap

   1

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

   2

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

   输出示例

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

   Copy to Clipboard Toggle word wrap

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

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

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

   1

   Copy to Clipboard Toggle word wrap

   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

   Copy to Clipboard Toggle word wrap

流程

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. 登录 OpenShift CLI (oc)。

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

   $ ./openshift-install version

   Copy to Clipboard Toggle word wrap

   输出示例

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

   Copy to Clipboard Toggle word wrap

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

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

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

   1

   Copy to Clipboard Toggle word wrap

   1

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

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

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

   Copy to Clipboard Toggle word wrap

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

流程

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

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

   Copy to Clipboard Toggle word wrap
2. 将 openshift-install 二进制文件放到 PATH 中的目录中。

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

   $ mkdir ~/<directory_name>

   Copy to Clipboard Toggle word wrap

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

   Copy to Clipboard Toggle word wrap

   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，您可以使用三种方式为集群节点配置 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

   Copy to Clipboard Toggle word wrap

   注意

   使用断开连接的镜像 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

   Copy to Clipboard Toggle word wrap

   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>

   Copy to Clipboard Toggle word wrap
   重要

   如果您已创建了 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

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

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

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

      $ cd ../mirror

      Copy to Clipboard Toggle word wrap
   2. 在 mirror 目录中配置清单文件。

流程

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

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

   Copy to Clipboard Toggle word wrap
   重要

   如果您已创建了 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

   Copy to Clipboard Toggle word wrap

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

   diskEncryption:
       enableOn: all 

   1

   
       mode: tang 

   2

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

   3

   Copy to Clipboard Toggle word wrap

   1

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

   2

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

   3

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

流程

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

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

   Copy to Clipboard Toggle word wrap
   注意

   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

   Copy to Clipboard Toggle word wrap

   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

   Copy to Clipboard Toggle word wrap

   注意

   对于在 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 的检查错误部分。本节显示特定于失败检查的错误消息。

      

      View larger image

      
   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

   Copy to Clipboard Toggle word wrap

   1

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

   2

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

   输出示例

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

   Copy to Clipboard Toggle word wrap

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

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

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

   1

   Copy to Clipboard Toggle word wrap

   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

   Copy to Clipboard Toggle word wrap

1. 支持 ：当安装过程需要 ai.ip_cfg_override 参数时。
2. 不适用：当网卡不适用于在 hypervisor 上使用时。
3. 不需要：当安装过程不需要 ai.ip_cfg_override 参数时。

流程

1. 为 z/VM 客户机创建一个参数文件：

   参数文件示例

   +

   rd.neednet=1 \
   console=ttysclp0 \
   coreos.live.rootfs_url=<rootfs_url> \

   1

   
   ip=172.18.78.2::172.18.78.1:255.255.255.0:::none nameserver=172.18.78.1 \

   2

   
   zfcp.allow_lun_scan=0 \

   3

   
   ai.ip_cfg_override=1 \
   rd.znet=qeth,0.0.bdd0,0.0.bdd1,0.0.bdd2,layer2=1 \
   rd.dasd=0.0.4411 \

   4

   
   rd.zfcp=0.0.8001,0x50050763040051e3,0x4000406300000000 \

   5

   
   fips=1 \

   6

   
   random.trust_cpu=on rd.luks.options=discard \
   ignition.firstboot ignition.platform.id=metal \
   console=tty1 console=ttyS1,115200n8 \
   coreos.inst.persistent-kargs="console=tty1 console=ttyS1,115200n8"

   Copy to Clipboard Toggle word wrap

   1

   对于 coreos.live.rootfs_url 工件，请为您要引导的内核 和 initramfs 指定匹配的 rootfs 工件。仅支持 HTTP 和 HTTPS 协议。

   2

   对于 ip 参数，使用 DHCP 自动分配 IP 地址，或者手动分配 IP 地址，如"在 IBM Z® 和 IBM® LinuxONE 上使用 z/VM 安装集群"中所述。

   3

   默认值为 1。使用 OSA 网络适配器时省略此条目。

   4

   对于在 DASD 类型磁盘中安装，请使用 rd.dasd 指定要安装 Red Hat Enterprise Linux CoreOS (RHCOS) 的 DASD。为 FCP 类型磁盘省略此条目。

   5

   对于在 FCP 类型磁盘中安装，请使用 rd.zfcp=<adapter>,<wwpn>,<lun> 指定要安装 RHCOS 的 FCP 磁盘。为 DASD 类型磁盘省略这个条目。

   注意

   对于 FCP 多路径配置，请提供两个磁盘而不是一个。

   Example

   rd.zfcp=<adapter1>,<wwpn1>,<lun1> \
   rd.zfcp=<adapter2>,<wwpn2>,<lun2>

   Copy to Clipboard Toggle word wrap

   6

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

   所有其他参数保持不变。

2. 将 kernel.img、common.parm 和 initrd.img 文件与 z/VM 客户机虚拟机的虚拟读取器中解放。

   如需更多信息，请参阅 PUNCH (IBM 文档)。

   提示

   您可以使用 CP PUNCH 命令，或者使用 Linux ( vmur 命令) 在两个 z/VM 虚拟机之间传输文件。

3. 登录到 bootstrap 机器上的对话监控系统 (CMS)。

4. 运行以下命令，从 reader IPL bootstrap 机器：

   $ ipl c

   Copy to Clipboard Toggle word wrap

   如需更多信息，请参阅 IPL (IBM 文档)。