3.10. 配置 install-config.yaml 文件

1. 配置 install-config.yaml。更改适当的变量以匹配环境，包括 pullSecret 和 sshKey ：

   apiVersion: v1
   baseDomain: <domain>
   metadata:
     name: <cluster_name>
   networking:
     machineNetwork:
     - cidr: <public_cidr>
     networkType: OVNKubernetes
   compute:
   - name: worker
     replicas: 2 

   1

   
   controlPlane:
     name: master
     replicas: 3
     platform:
       baremetal: {}
   platform:
     baremetal:
       apiVIPs:
         - <api_ip>
       ingressVIPs:
         - <wildcard_ip>
       provisioningNetworkCIDR: <CIDR>
       bootstrapExternalStaticIP: <bootstrap_static_ip_address> 

   2

   
       bootstrapExternalStaticGateway: <bootstrap_static_gateway> 

   3

   
       hosts:
         - name: openshift-master-0
           role: master
           bmc:
             address: ipmi://<out_of_band_ip> 

   4

   
             username: <user>
             password: <password>
           bootMACAddress: <NIC1_mac_address>
           rootDeviceHints:
            deviceName: "<installation_disk_drive_path>" 

   5

   
         - name: <openshift_master_1>
           role: master
           bmc:
             address: ipmi://<out_of_band_ip>
             username: <user>
             password: <password>
           bootMACAddress: <NIC1_mac_address>
           rootDeviceHints:
            deviceName: "<installation_disk_drive_path>"
         - name: <openshift_master_2>
           role: master
           bmc:
             address: ipmi://<out_of_band_ip>
             username: <user>
             password: <password>
           bootMACAddress: <NIC1_mac_address>
           rootDeviceHints:
            deviceName: "<installation_disk_drive_path>"
         - name: <openshift_worker_0>
           role: worker
           bmc:
             address: ipmi://<out_of_band_ip>
             username: <user>
             password: <password>
           bootMACAddress: <NIC1_mac_address>
         - name: <openshift_worker_1>
           role: worker
           bmc:
             address: ipmi://<out_of_band_ip>
             username: <user>
             password: <password>
           bootMACAddress: <NIC1_mac_address>
           rootDeviceHints:
            deviceName: "<installation_disk_drive_path>"
   pullSecret: '<pull_secret>'
   sshKey: '<ssh_pub_key>'

   Copy to Clipboard Toggle word wrap

   1

   根据作为 OpenShift Container Platform 集群一部分的 worker 节点数量，扩展 worker 机器。replicas 值可以是 0，以及大于或等于 2 的整数。将副本数设置为 0 以部署一个三节点集群，该集群仅包含三个 control plane 机器。三节点集群是一个较小的、效率更高的集群，可用于测试、开发和生产。您不能只使用一个 worker 安装集群。

   2

   当使用静态 IP 地址部署集群时，您必须设置 bootstrapExternalStaticIP 配置设置，以便在裸机网络上没有 DHCP 服务器时可以指定 bootstrap 虚拟机的静态 IP 地址。

   3

   当使用静态 IP 地址部署集群时，您必须设置 bootstrapExternalStaticGateway 配置设置，以便当裸机网络上没有 DHCP 服务器时可以为 bootstrap 虚拟机指定网关 IP 地址。

   4

   如需了解更多选项，请参阅 BMC 寻址部分。

   5

   要设置安装磁盘驱动器的路径，请输入磁盘的内核名称。例如：/dev/sda。

   重要

   由于磁盘发现顺序无法保证，因此磁盘的内核名称可以在具有多个磁盘的机器的引导选项之间更改。例如，/dev/sda 变成 /dev/sdb，反之亦然。要避免这个问题，您必须使用持久性磁盘属性，如 disk World Wide Name (WWN)。要使用磁盘 WWN，请将 deviceName 参数替换为 wwnWithExtension 参数。根据您使用的参数，输入磁盘名称，如 /dev/sda 或磁盘 WWN，例如 "0x64cd98f04fde100024684cf3034da5c2"。确保您在引号中输入磁盘 WWN 值，使其用作字符串值，而不是十六进制值。

   无法满足 rootDeviceHints 参数的这些要求可能会导致以下错误：

   ironic-inspector inspection failed: No disks satisfied root device hints

   Copy to Clipboard Toggle word wrap

   注意

   在 OpenShift Container Platform 4.12 之前，集群安装程序只接受 apiVIP 和 ingressVIP 配置设置的 IPv4 地址或 IPv6 地址。在 OpenShift Container Platform 4.12 及更新的版本中，这些配置设置已弃用。反之，使用 apiVIPs 和 ingressVIPs 配置设置中的列表格式来指定 IPv4 地址、IPv6 地址或两个 IP 地址格式。

2. 创建用于存储集群配置的目录：

   $ mkdir ~/clusterconfigs

   Copy to Clipboard Toggle word wrap

3. 将 install-config.yaml 文件复制到新目录中：

   $ cp install-config.yaml ~/clusterconfigs

   Copy to Clipboard Toggle word wrap

4. 在安装 OpenShift Container Platform 集群前，请确保关闭所有裸机节点：

   $ ipmitool -I lanplus -U <user> -P <password> -H <management-server-ip> power off

   Copy to Clipboard Toggle word wrap

5. 如果以前的部署尝试中保留了旧的 bootstrap 资源，请删除旧的 bootstrap 资源：

   for i in $(sudo virsh list | tail -n +3 | grep bootstrap | awk {'print $2'});
   do
     sudo virsh destroy $i;
     sudo virsh undefine $i;
     sudo virsh vol-delete $i --pool $i;
     sudo virsh vol-delete $i.ign --pool $i;
     sudo virsh pool-destroy $i;
     sudo virsh pool-undefine $i;
   done

   Copy to Clipboard Toggle word wrap

流程

1. 可选：在 install-config.yaml 文件中包括 nmstatectl gc 前测试 NMState 语法，因为安装程序不会检查 NMState YAML 语法。

   注意

   YAML 语法中的错误可能会导致无法应用网络配置。另外，在部署后或在扩展集群时应用 Kubernetes NMState 更改时，维护所验证的 YAML 语法会很有用。

   1. 创建 NMState YAML 文件：

      interfaces:
      - name: <nic1_name> 

      1

      
        type: ethernet
        state: up
        ipv4:
          address:
          - ip: <ip_address> 

      2

      
            prefix-length: 24
          enabled: true
      dns-resolver:
        config:
          server:
          - <dns_ip_address> 

      3

      
      routes:
        config:
        - destination: 0.0.0.0/0
          next-hop-address: <next_hop_ip_address> 

      4

      
          next-hop-interface: <next_hop_nic1_name> 

      5

      Copy to Clipboard Toggle word wrap

      1 2 3 4 5

      使用适当的值替换 <nic1_name>, <ip_address>, <dns_ip_address>, <next_hop_ip_address> 和 <next_hop_nic1_name>。

   2. 运行以下命令来测试配置文件：

      $ nmstatectl gc <nmstate_yaml_file>

      Copy to Clipboard Toggle word wrap

      将 <nmstate_yaml_file> 替换为配置文件名称。

2. 通过在 install-config.yaml 文件中的主机中添加 NMState 配置，使用 networkConfig 配置设置：

       hosts:
         - name: openshift-master-0
           role: master
           bmc:
             address: redfish+http://<out_of_band_ip>/redfish/v1/Systems/
             username: <user>
             password: <password>
             disableCertificateVerification: null
           bootMACAddress: <NIC1_mac_address>
           bootMode: UEFI
           rootDeviceHints:
             deviceName: "/dev/sda"
           networkConfig: 

   1

   
             interfaces:
             - name: <nic1_name> 

   2

   
               type: ethernet
               state: up
               ipv4:
                 address:
                 - ip: <ip_address> 

   3

   
                   prefix-length: 24
                 enabled: true
             dns-resolver:
               config:
                 server:
                 - <dns_ip_address> 

   4

   
             routes:
               config:
               - destination: 0.0.0.0/0
                 next-hop-address: <next_hop_ip_address> 

   5

   
                 next-hop-interface: <next_hop_nic1_name> 

   6

   Copy to Clipboard Toggle word wrap

   1

   添加 NMState YAML 语法来配置主机接口。

   2 3 4 5 6

   使用适当的值替换 <nic1_name>, <ip_address>, <dns_ip_address>, <next_hop_ip_address> 和 <next_hop_nic1_name>。

   重要

   部署集群后，您无法修改 install-config.yaml 文件的 networkConfig 配置设置，以更改主机网络接口。在部署后，使用 Kubernetes NMState Operator 更改主机网络接口。

流程

1. 在使用静态 IP 地址时，将子网添加到 install-config.yaml 文件中的 machineNetwork 中：

   networking:
     machineNetwork:
     - cidr: 10.0.0.0/24
     - cidr: 192.168.0.0/24
     networkType: OVNKubernetes

   Copy to Clipboard Toggle word wrap

2. 在使用静态 IP 地址或高级网络（如绑定）时，使用 NMState 语法将网关和 DNS 配置添加到每个边缘计算节点的 networkConfig 参数中：

   networkConfig:
     interfaces:
     - name: <interface_name> 

   1

   
       type: ethernet
       state: up
       ipv4:
         enabled: true
         dhcp: false
         address:
         - ip: <node_ip> 

   2

   
           prefix-length: 24
         gateway: <gateway_ip> 

   3

   
     dns-resolver:
       config:
         server:
         - <dns_ip> 

   4

   Copy to Clipboard Toggle word wrap

   1

   将 <interface_name> 替换为接口名称。

   2

   将 <node_ip> 替换为节点的 IP 地址。

   3

   使用网关的 IP 地址替换 <gateway_ip>。

   4

   将 <dns_ip> 替换为 DNS 服务器的 IP 地址。

流程

1. 可选：在 install-config.yaml 文件中包括 nmstatectl gc 命令前使用 nmstatectl gc 命令测试 NMState YAML 语法，因为安装程序不会检查 NMState YAML 语法。

   1. 创建 NMState YAML 文件：

      interfaces:
      - name: eth0
        ipv6:
          addr-gen-mode: <address_mode> 

      1

      Copy to Clipboard Toggle word wrap

      1

      将 <address_mode> 替换为集群中 IPv6 地址所需的地址生成模式类型。有效值为 eui64、 stable-privacy 或 random。

   2. 运行以下命令来测试配置文件：

      $ nmstatectl gc <nmstate_yaml_file> 

      1

      Copy to Clipboard Toggle word wrap

      1

      将 <nmstate_yaml_file> 替换为测试配置文件的名称。

2. 将 NMState 配置添加到 install-config.yaml 文件中的 hosts.networkConfig 部分：

       hosts:
         - name: openshift-master-0
           role: master
           bmc:
             address: redfish+http://<out_of_band_ip>/redfish/v1/Systems/
             username: <user>
             password: <password>
             disableCertificateVerification: null
           bootMACAddress: <NIC1_mac_address>
           bootMode: UEFI
           rootDeviceHints:
             deviceName: "/dev/sda"
           networkConfig:
             interfaces:
             - name: eth0
               ipv6:
                 addr-gen-mode: <address_mode> 

   1

   
   ...

   Copy to Clipboard Toggle word wrap

   1

   将 <address_mode> 替换为集群中 IPv6 地址所需的地址生成模式类型。有效值为 eui64、 stable-privacy 或 random。