6.5. 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 以上である必要があります。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

   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 仮想 IP を追加した installer-provisioned infrastructure で、次の手順を実行します。

   1. クラスターの 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

      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. installer-provisioned infrastructure 上で実行されるクラスターに対して、次の追加タスクを完了します。

   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. 「デュアルスタッククラスターネットワークへの変換」手順の実行時に cidr および hostPrefix パラメーターに追加した IPv4 または IPv6 設定を削除します。