3.7. セカンダリーネットワークでの IP アドレス割り当ての設定

手順

1. 以下のコマンドを実行して、Network.operator.openshift.io CR を編集します。

   $ oc edit network.operator.openshift.io cluster

   Copy to Clipboard Toggle word wrap

2. このサンプル YAML に示す additionalNetworks セクションを、CR の spec 定義内に含めます。

   apiVersion: operator.openshift.io/v1
   kind: Network
   metadata:
     name: cluster
   # ...
   spec:
     additionalNetworks:
     - name: whereabouts-shim
       namespace: default
       rawCNIConfig: |-
         {
          "name": "whereabouts-shim",
          "cniVersion": "0.3.1",
          "type": "bridge",
          "ipam": {
            "type": "whereabouts"
          }
         }
       type: Raw
   # ...

   Copy to Clipboard Toggle word wrap
3. ファイルを保存し、テキストエディターを編集します。

4. 次のコマンドを実行して、whereabouts-reconciler デーモンセットが正常にデプロイされたことを確認します。

   $ oc get all -n openshift-multus | grep whereabouts-reconciler

   Copy to Clipboard Toggle word wrap

   pod/whereabouts-reconciler-jnp6g 1/1 Running 0 6s
   pod/whereabouts-reconciler-k76gg 1/1 Running 0 6s
   daemonset.apps/whereabouts-reconciler 6 6 6 6 6 kubernetes.io/os=linux 6s

   Copy to Clipboard Toggle word wrap

手順

1. 次のコマンドを実行して、IP リコンサイラー用の特定の cron 式を使用し、openshift-multus namespace に whereabouts-config という名前の ConfigMap オブジェクトを作成します。

   $ oc create configmap whereabouts-config -n openshift-multus --from-literal=reconciler_cron_expression="*/15 * * * *"

   Copy to Clipboard Toggle word wrap

   この cron 式は、IP リコンサイラーを 15 分ごとに実行するよう指定します。この式は固有の要件に基づいて調整してください。

   注記

   whereabouts-reconciler デーモンセットは、5 つのアスタリスクを含む cron 式パターンのみを使用できます。Red Hat は、秒を示すために使用される 6 番目のアスタリスクをサポートしていません。

2. 次のコマンドを実行して、openshift-multus namespace 内の whereabouts-reconciler デーモンセットおよび Pod に関連するリソースに関する情報を取得します。

   $ oc get all -n openshift-multus | grep whereabouts-reconciler

   Copy to Clipboard Toggle word wrap

   pod/whereabouts-reconciler-2p7hw                   1/1     Running   0             4m14s
   pod/whereabouts-reconciler-76jk7                   1/1     Running   0             4m14s
   daemonset.apps/whereabouts-reconciler          6         6         6       6            6           kubernetes.io/os=linux   4m16s

   Copy to Clipboard Toggle word wrap

3. 次のコマンドを実行して、設定した間隔で whereabouts-reconciler Pod が IP リコンサイラーを実行していることを確認します。

   $ oc -n openshift-multus logs whereabouts-reconciler-2p7hw

   Copy to Clipboard Toggle word wrap

   2024-02-02T16:33:54Z [debug] event not relevant: "/cron-schedule/..2024_02_02_16_33_54.1375928161": CREATE
   2024-02-02T16:33:54Z [debug] event not relevant: "/cron-schedule/..2024_02_02_16_33_54.1375928161": CHMOD
   2024-02-02T16:33:54Z [debug] event not relevant: "/cron-schedule/..data_tmp": RENAME
   2024-02-02T16:33:54Z [verbose] using expression: */15 * * * *
   2024-02-02T16:33:54Z [verbose] configuration updated to file "/cron-schedule/..data". New cron expression: */15 * * * *
   2024-02-02T16:33:54Z [verbose] successfully updated CRON configuration id "00c2d1c9-631d-403f-bb86-73ad104a6817" - new cron expression: */15 * * * *
   2024-02-02T16:33:54Z [debug] event not relevant: "/cron-schedule/config": CREATE
   2024-02-02T16:33:54Z [debug] event not relevant: "/cron-schedule/..2024_02_02_16_26_17.3874177937": REMOVE
   2024-02-02T16:45:00Z [verbose] starting reconciler run
   2024-02-02T16:45:00Z [debug] NewReconcileLooper - inferred connection data
   2024-02-02T16:45:00Z [debug] listing IP pools
   2024-02-02T16:45:00Z [debug] no IP addresses to cleanup
   2024-02-02T16:45:00Z [verbose] reconciler success

   Copy to Clipboard Toggle word wrap

1. Whereabouts は、192.168.2.0/24 などの Classless Inter-Domain Routing (CIDR) 表記のアドレス範囲を取得し、その範囲内で 192.168.2.1 から 192.168.2.254 などの IP アドレスを割り当てます。
2. Whereabouts は、CIDR 範囲内の最小値のアドレスである IP アドレスを Pod に割り当て、その Pod の有効期間中、データストア内の IP アドレスを追跡します。
3. Pod が削除されると、Whereabouts がアドレスを Pod から解放するため、アドレスは割り当て可能になります。

手順

1. 次のコマンドを入力して、Whereabouts Controller が実行されていることを確認します。

   $ oc get pods -n openshift-multus | grep controller

   Copy to Clipboard Toggle word wrap

   multus-admission-controller-d89bc96f-gbf7s   2/2     Running   0              6h3m
   ...

   Copy to Clipboard Toggle word wrap
   重要

   Whereabouts Controller が実行されていない場合、Fast IPAM は機能しません。

2. クラスターの NAD ファイルを作成し、以下の設定例のように、Fast IPAM の詳細をファイルに追加します。

   apiVersion: "k8s.cni.cncf.io/v1"
   kind: NetworkAttachmentDefinition
   metadata:
     name: wb-ipam
     namespace: openshift-multus
   spec:
     config: {
   	"cniVersion": "0.3.0",
   	"name": "wb-ipam-cni-name",
   	"type": "bridge",
   	"bridge": "cni0",
   	"ipam": {
     	"type": "whereabouts",
     	"range": "10.5.0.0/20",
     	"node_slice_size": "/24"
       }
     }
   # ...

   Copy to Clipboard Toggle word wrap

   ここでは、以下のようになります。

   namespace

   CNO が NAD をデプロイする namespace。

   name

   Whereabouts IPAM CNI プラグインの名前。

   type

   whereabouts など、IPAM CNI プラグインのタイプ。

   range

   Whereabouts IPAM CNI プラグインが Pod に IP アドレスを割り当てるために使用する IP プールの IP アドレス範囲。

   node_slice_size

   各ノードで使用できる IP アドレスのスライスサイズを設定します。

3. Whereabouts IPAM CNI プラグインのアノテーションの詳細を Pod の YAML ファイルに追加します。

   apiVersion: v1
   kind: Pod
   metadata:
     name: <pod_name>
     annotations:
     k8s.v1.cni.cncf.io/networks: openshift-multus/wb-ipam
   spec:
     containers:
     - name: samplepod
     command: ["/bin/ash", "-c", "trap : TERM INT; sleep infinity & wait"] 

   1

   
     image: alpine
   # ...

   Copy to Clipboard Toggle word wrap

   ここでは、以下のようになります。

   name

   Pod の名前。

   k8s.v1.cni.cncf.io/networks

   openshift-multus namespace に存在する Whereabouts IPAM CNI プラグイン名を参照するアノテーションの詳細。

   - name

   Pod のコンテナーの名前。

   command

   コンテナーのエントリーポイントを定義し、Whereabouts IPAM CNI プラグインでコンテナーの動作を制御します。

4. クラスター内で実行されているノード上に存在する Pod に NAD ファイル設定を適用します。

   $ oc create -f <NAD_file_name>.yaml

   Copy to Clipboard Toggle word wrap

検証

1. 次のコマンドを入力して、Pod の IP アドレスの詳細を表示します。

   $ oc describe pod <pod_name>

   Copy to Clipboard Toggle word wrap

   ...
   IP:     192.168.2.0
   IPs:
     IP:   192.168.2.0
   Containers:
     samplepod:
       Container ID:   docker://<image_name>
       Image:          <app_name>:v1
       Image ID:
   ...

   Copy to Clipboard Toggle word wrap

2. 次のコマンドを入力して、Pod にアクセスし、そのインターフェイスを確認します。

   $ oc exec <pod_name> -- ip a

   Copy to Clipboard Toggle word wrap

   ...
   3: net1@if23: <BROADCAST,MULTICAST,UP,LOWER_UP,M-DOWN> mtu 1500 qdisc noqueue
       link/ether 82:01:98:e5:0c:b7 brd ff:ff:ff:ff:ff:ff
       inet 192.168.2.0/24 brd 10.10.0.255 scope global net1
          valid_lft forever preferred_lft forever
       inet6 fe80::8001:98ff:fee5:cb7/64 scope link
          valid_lft forever preferred_lft forever
   ...

   Copy to Clipboard Toggle word wrap

   ここでは、以下のようになります。

   inet: Pod は予想通りに net 1 インターフェイスの 192.168.2. 1 IP アドレスに割り当てられます。

3. 次のコマンドを入力して、openshift-multus namespace にノードセレクタープールが存在することを確認します。予想される出力には、node slicepool などのノードセレクタープールの名前や、作成期間が 32m などの分単位で表示されます。

   $ oc get nodeslicepool -n openshift-multus

   Copy to Clipboard Toggle word wrap

手順

1. type を whereabouts に設定します。

2. 以下の例のように、ipRanges を使用して IP アドレスを割り当てます。

   cniVersion: operator.openshift.io/v1
   kind: Network
   metadata:
     name: cluster
   spec:
     additionalNetworks:
     - name: whereabouts-shim
       namespace: default
       type: Raw
       rawCNIConfig: |-
         {
          "name": "whereabouts-dual-stack",
          "cniVersion": "0.3.1,
          "type": "bridge",
          "ipam": {
            "type": "whereabouts",
            "ipRanges": [
                     {"range": "192.168.10.0/24"},
                     {"range": "2001:db8::/64"}
                 ]
          }
         }

   Copy to Clipboard Toggle word wrap
3. セカンダリーネットワークを Pod にアタッチします。詳細は、「セカンダリーネットワークへの Pod の追加」を参照してください。