20.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 以上である必要があります。IPv6Classless Inter-Domain Routing (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 仮想 IP を指定します。次の例と同様の設定を含む 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. installer-provisioned infrastructure 上で実行されるクラスターに対して、次の追加タスクを完了します。

   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 固有の設定を削除します。