5.2. 複数のネットワークの設定と使用

手順

1. オプション: 次のコマンドを実行して、MicroShift クラスターが Multus CNI で実行されていることを確認します。

   $ oc get pods -n openshift-multus

   出力例

   NAME                READY   STATUS    RESTARTS   AGE
   dhcp-daemon-dfbzw   1/1     Running   0          5h
   multus-rz8xc        1/1     Running   0          5h

2. 次のコマンドを実行し、次のサンプルファイルを参照して NetworkAttachmentDefinition 設定ファイルを作成します。

   $ oc apply -f network-attachment-definition.yaml

   NetworkAttachmentDefinition のファイルの例

   apiVersion: "k8s.cni.cncf.io/v1"
   kind: NetworkAttachmentDefinition
   metadata:
     name: bridge-conf
   spec:
     config: '{
         "cniVersion": "0.4.0",
         "type": "bridge", 1
         "bridge": "br-test", 2
         "mode": "bridge",
         "ipam": {
           "type": "host-local", 3
           "ranges": [
             [
               {
                 "subnet": "10.10.0.0/24",
                 "rangeStart": "10.10.0.20",
                 "rangeEnd": "10.10.0.50",
                 "gateway": "10.10.0.254"
                }
             ],
             [
               {
                 "subnet": "fd00:IJKL:MNOP:10::0/64", 4
                 "rangeStart": "fd00:IJKL:MNOP:10::1",
                 "rangeEnd": "fd00:IJKL:MNOP:10::9"
           "dataDir": "/var/lib/cni/br-test"
         }
       }'

   1

   type 値は CNI プラグインの名前を指定します。この例では bridge タイプを使用します。

   2

   bridge 値は、使用されている MicroShift ホスト上のブリッジの名前です。Pod の追加インターフェイスはそのブリッジに接続されます。ホスト上にインターフェイスが存在しない場合は、Bridge CNI によって作成されます。インターフェイスがすでに存在する場合は再利用されます。以下の例では、インターフェイスの名前は br-test です。

   3

   IPAM タイプ。

   4

   IPv6 アドレスをセカンダリーインターフェイスに追加できます。

   注記

   ブリッジの名前の使用は、プラグインの bridge タイプに固有です。他のプラグインは NetworkAttachmentDefinitions で異なるフィールドを使用します。たとえば、macvlan および ipvlan 設定は master を使用して、割り当てるホストインターフェイスを指定します。

手順

1. Pod YAML ファイルにアノテーションを追加します。以下のアノテーション形式のいずれかのみを使用できます。

   1. カスタマイズせずに追加ネットワークを割り当てるには、以下の形式でアノテーションを追加します。<network> を、Pod に関連付ける追加ネットワークの名前に置き換えます。

      apiVersion: v1
      kind: Pod
      metadata:
        annotations:
          k8s.v1.cni.cncf.io/networks: <network>[,<network>,...] 1
      # ...

      1

      <network> を、Pod に関連付ける追加ネットワークの名前に置き換えます。複数の追加ネットワークを指定するには、各ネットワークをコンマで区切ります。コンマの間にはスペースを入れないでください。同じ追加ネットワークを複数回指定した場合、Pod は複数のネットワークインターフェイスをそのネットワークに割り当てます。

      ブリッジタイプの追加ネットワークのアノテーションの例

      apiVersion: v1
      kind: Pod
      metadata:
        annotations:
          k8s.v1.cni.cncf.io/networks: bridge-conf
      # ...

   2. カスタマイズして追加のネットワークを割り当てるには、以下の形式でアノテーションを追加します。

      apiVersion: v1
      kind: Pod
      metadata:
        annotations:
          k8s.v1.cni.cncf.io/networks: |-
            [
              {
                "name": "<network>", 1
                "namespace": "<namespace>", 2
                "default-route": ["<default-route>"] 3
              }
            ]
      # ...

      1

      NetworkAttachmentDefinition オブジェクトによって定義される追加のネットワークの名前を指定します。

      2

      NetworkAttachmentDefinition オブジェクトが定義される namespace を指定します。

      3

      オプション: 192.168.17.1 などのデフォルトルートのオーバーライドを指定します。

2. Pod YAML ファイルを作成し、追加のネットワークの NetworkAttachmentDefinition アノテーションを追加するには、次のコマンドを実行し、サンプル YAML を使用します。

   $ oc apply -f ./<test_bridge>.yaml 1

   1

   <test-bridge> を、使用する Pod 名に置き換えます。

   出力例

   pod/test_bridge created

   test-bridge Pod YAML の例

   apiVersion: v1
   kind: Pod
   metadata:
     name: test_bridge
     annotations:
       k8s.v1.cni.cncf.io/networks: bridge-conf
     labels:
       app: test_bridge
   spec:
     terminationGracePeriodSeconds: 0
     containers:
     - name: hello-microshift
       image: quay.io/microshift/busybox:1.36
       command: ["/bin/sh"]
       args: ["-c", "while true; do echo -ne \"HTTP/1.0 200 OK\r\nContent-Length: 16\r\n\r\nHello MicroShift\" | nc -l -p 8080 ; done"]
       ports:
       - containerPort: 8080
         protocol: TCP
       securityContext:
         allowPrivilegeEscalation: false
         capabilities:
           drop:
           - ALL
         runAsNonRoot: true
         runAsUser: 1001
         runAsGroup: 1001
         seccompProfile:
           type: RuntimeDefault

3. NetworkAttachmentDefinition アノテーションが正しいことを確認します。

   NetworkAttachmentDefinition アノテーションの例

   apiVersion: v1
   kind: Pod
   metadata:
     annotations:
       k8s.v1.cni.cncf.io/networks: bridge-conf
   # ...

4. オプション: NetworkAttachmentDefinition アノテーションが Pod YAML に存在することを確認するには、<name> を Pod の名前に置き換えて次のコマンドを実行します。

   $ oc get pod <name> -o yaml 1

   1

   <name> を、使用する Pod 名に置き換えます。以下の例では、test-bridge が使用されます。

   次の例では、test-bridge が net1 の追加ネットワークに接続されています。

   $ oc get pod <test_bridge> -o yaml

   出力例

   apiVersion: v1
   kind: Pod
   metadata:
     annotations:
       k8s.v1.cni.cncf.io/networks: bridge-conf
       k8s.v1.cni.cncf.io/network-status: |- 1
         [{
             "name": "ovn-kubernetes",
             "interface": "eth0",
             "ips": [
                 "10.42.0.18"
             ],
             "default": true,
             "dns": {}
         },{
             "name": "bridge-conf",
             "interface": "net1",
             "ips": [
                 "20.2.2.100"
             ],
             "mac": "22:2f:60:a5:f8:00",
             "dns": {}
         }]
     name: pod
     namespace: default
   spec:
   # ...
   status:
   # ...

   1

   k8s.v1.cni.cncf.io/network-status パラメーターは、オブジェクトの JSON 配列です。各オブジェクトは、Pod に割り当てられる追加のネットワークのステータスを説明します。アノテーションの値はプレーンテキストの値として保存されます。

5. 以下のコマンドを使用して、Pod が実行されていることを確認します。

   $ oc get pod

   出力例

   NAME          READY   STATUS    RESTARTS   AGE
   test_bridge   1/1     Running   0          81s

前提条件

1. NetworkAttachmentDefinition オブジェクト設定を作成して適用しました。

手順

1. 以下のコマンドを実行して、ブリッジがホストに作成されていることを確認します。

   $ ip a show br-test

   出力例

   22: br-test: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc noqueue state UP group default qlen 1000
       link/ether 96:bf:ca:be:1d:15 brd ff:ff:ff:ff:ff:ff
       inet6 fe80::34e2:bbff:fed2:31f2/64 scope link
          valid_lft forever preferred_lft forever

2. 次のコマンドを実行して、ブリッジの IP アドレスを設定します。

   $ sudo ip addr add 10.10.0.10/24 dev br-test

3. 次のコマンドを実行して、IP アドレス設定がブリッジに追加されたことを確認します。

   $ ip a show br-test

   出力例

   22: br-test: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc noqueue state UP group default qlen 1000
       link/ether 96:bf:ca:be:1d:15 brd ff:ff:ff:ff:ff:ff
       inet 10.10.0.10/24 scope global br-test 1
          valid_lft forever preferred_lft forever
       inet6 fe80::34e2:bbff:fed2:31f2/64 scope link
          valid_lft forever preferred_lft forever

   1

   IP アドレスは想定どおりに設定されています。

4. 次のコマンドを実行して、Pod の IP アドレスを確認します。

   $ oc get pod test-bridge --output=jsonpath='{.metadata.annotations.k8s\.v1\.cni\.cncf\.io/network-status}'

   出力例

   [{
       "name": "ovn-kubernetes",
       "interface": "eth0",
       "ips": [
           "10.42.0.17"
       ],
       "mac": "0a:58:0a:2a:00:11",
       "default": true,
       "dns": {}
   },{
       "name": "default/bridge-conf", 1
       "interface": "net1",
       "ips": [
           "10.10.0.20"
       ],
       "mac": "82:01:98:e5:0c:b7",
       "dns": {}

   1

   ブリッジの追加ネットワークは想定どおりに接続されます。

5. オプション: oc exec を使用して Pod にアクセスし、ip コマンドを使用してそのインターフェイスを確認できます。

   $ oc exec -ti test-bridge -- ip a

   出力例

   1: lo: <LOOPBACK,UP,LOWER_UP> mtu 65536 qdisc noqueue qlen 1000
       link/loopback 00:00:00:00:00:00 brd 00:00:00:00:00:00
       inet 127.0.0.1/8 scope host lo
          valid_lft forever preferred_lft forever
       inet6 ::1/128 scope host
          valid_lft forever preferred_lft forever
   2: eth0@if21: <BROADCAST,MULTICAST,UP,LOWER_UP,M-DOWN> mtu 1500 qdisc noqueue
       link/ether 0a:58:0a:2a:00:11 brd ff:ff:ff:ff:ff:ff
       inet 10.42.0.17/24 brd 10.42.0.255 scope global eth0
          valid_lft forever preferred_lft forever
       inet6 fe80::858:aff:fe2a:11/64 scope link
          valid_lft forever preferred_lft forever
   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 10.10.0.20/24 brd 10.10.0.255 scope global net1 1
          valid_lft forever preferred_lft forever
       inet6 fe80::8001:98ff:fee5:cb7/64 scope link
          valid_lft forever preferred_lft forever

   1

   予想どおり、Pod は net1 インターフェイス 上の 10.10.0.20 IP アドレスに接続されます。

6. MicroShift ホストから Pod 内の HTTP サーバーにアクセスして、接続が期待どおりに機能していることを確認します。以下のコマンドを使用します。

   $ curl 10.10.0.20:8080

   出力例

   Hello MicroShift