19.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

   Copy to Clipboard Toggle word wrap

   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

   Copy to Clipboard Toggle word wrap

   1

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

   输出示例

   network.config.openshift.io/cluster patched

   Copy to Clipboard Toggle word wrap

3. 在为 API 和 Ingress 服务添加了 IPv6 VIP 的安装程序置备的基础架构中，完成以下步骤：

   1. 为集群指定 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

      Copy to Clipboard Toggle word wrap

      1

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

      2

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

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

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

      Copy to Clipboard Toggle word wrap

      其中：

      <file>

      指定创建的 YAML 文件的名称。

      输出示例

      infrastructure/cluster patched

      Copy to Clipboard Toggle word wrap

验证

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

   $ oc describe network

   Copy to Clipboard Toggle word wrap

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
   # ...

   Copy to Clipboard Toggle word wrap

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

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

      $ oc describe infrastructure

      Copy to Clipboard Toggle word wrap

   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
      # ...

      Copy to Clipboard Toggle word wrap

流程

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

   $ oc edit networks.config.openshift.io

   Copy to Clipboard Toggle word wrap
2. 删除在 "Converting to a dual-stack cluster network " 步骤中添加到 cidr 和 hostPrefix 参数中的 IPv4 或 IPv6 配置。