24.7. 转换为 IPv4/IPv6 双栈网络

流程

1. 要为集群和服务网络指定 IPv6 地址块，请创建一个类似以下示例的 YAML 配置补丁文件：

   - op: add
     path: /spec/clusterNetwork/-
     value: 1
       cidr: fd01::/48
       hostPrefix: 64
   - op: add
     path: /spec/serviceNetwork/-
     value: fd02::/112 2

   1

   使用 cidr 和 hostPrefix 字段指定对象。主机前缀必须为 64 或更高。IPv6 无类别域间路由 (CIDR) 前缀必须足够大，以适应指定的主机前缀。

   2

   指定一个带有 112 前缀的 IPv6 CIDR。Kubernetes 仅使用最低 16 位。对于前缀 112，IP 地址从 112 分配给 128 位。

2. 在 CLI 中输入以下命令来修补集群网络配置：

   $ oc patch network.config.openshift.io cluster \1
     --type='json' --patch-file <file>.yaml

   1

   其中 file 指定您创建的 YAML 文件的名称。

   输出示例

   network.config.openshift.io/cluster patched

3. 为集群指定 API 和 Ingress 服务的 IPv6 VIP。创建类似以下示例的 YAML 配置补丁文件：

   - op: add
     path: /spec/platformSpec/baremetal/machineNetworks/- 1
     value: fd2e:6f44:5dd8::/64
   - op: add
     path: /spec/platformSpec/baremetal/apiServerInternalIPs/- 2
     value: fd2e:6f44:5dd8::4
   - op: add
     path: /spec/platformSpec/baremetal/ingressIPs/-
     value: fd2e:6f44:5dd8::5

   1

   确保为机器操作的 machineNetwork 网络指定地址块。您必须为机器网络选择 API 和 Ingress IP 地址。

   2

   确保根据您的平台指定每个文件路径。该示例展示了裸机平台上的文件路径。

4. 在 CLI 中输入以下命令来修补基础架构：

   $ oc patch infrastructure cluster \1
     --type='json' --patch-file <file>.yaml

   1

   其中 file 指定您创建的 YAML 文件的名称。

   输出示例

   infrastructure/cluster patched

验证

1. 在 CLI 中输入以下命令来显示集群网络配置：

   $ oc describe network

2. 检查集群网络配置是否识别您在 YAML 文件中指定的 IPv6 地址块，以验证在网络配置中成功安装补丁。

   输出示例

   # ...
   Status:
     Cluster Network:
       Cidr:               10.128.0.0/14
       Host Prefix:        23
       Cidr:               fd01::/48
       Host Prefix:        64
     Cluster Network MTU:  1400
     Network Type:         OVNKubernetes
     Service Network:
       172.30.0.0/16
       fd02::/112
   # ...

3. 为在安装程序置备的基础架构中运行的集群完成以下附加任务：

   1. 在 CLI 中输入以下命令来显示集群基础架构配置：

      $ oc describe infrastructure

   2. 检查基础架构是否识别您在 YAML 文件中指定的 IPv6 地址块，以验证在集群基础架构上安装补丁是否成功。

      输出示例

      # ...
      spec:
      # ...
        platformSpec:
          baremetal:
            apiServerInternalIPs:
            - 192.168.123.5
            - fd2e:6f44:5dd8::4
            ingressIPs:
            - 192.168.123.10
            - fd2e:6f44:5dd8::5
      status:
      # ...
        platformStatus:
          baremetal:
            apiServerInternalIP: 192.168.123.5
            apiServerInternalIPs:
            - 192.168.123.5
            - fd2e:6f44:5dd8::4
            ingressIP: 192.168.123.10
            ingressIPs:
            - 192.168.123.10
            - fd2e:6f44:5dd8::5
      # ...

流程

1. 运行以下命令来编辑 networks.config.openshift.io 自定义资源 (CR)：

   $ oc edit networks.config.openshift.io

2. 删除在前面的步骤中添加到 cidr 和 hostPrefix 字段中的 IPv6 具体配置。