4.4. セカンダリーネットワークに Pod を追加する

手順

1. アノテーションを Pod オブジェクトに追加します。以下のアノテーション形式のいずれかのみを使用できます。

   1. カスタマイズせずにセカンダリーネットワークをアタッチするには、次の形式でアノテーションを追加します。

      metadata:
        annotations:
          k8s.v1.cni.cncf.io/networks: <network>[,<network>,...]

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

      k8s.v1.cni.cncf.io/networks

      Pod に関連付けるセカンダリーネットワークの名前を指定します。複数のセカンダリーネットワークを指定するには、各ネットワークをコンマで区切ります。コンマの間にはスペースを入れないでください。同じセカンダリーネットワークを複数回指定した場合、Pod は複数のネットワークインターフェイスをそのネットワークにアタッチします。

   2. カスタマイズしてセカンダリーネットワークをアタッチするには、次の形式でアノテーションを追加します。

      metadata:
        annotations:
          k8s.v1.cni.cncf.io/networks: |-
            [
              {
                "name": "<network>",
                "namespace": "<namespace>",
                "default-route": ["<default_route>"]
              }
            ]

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

      <network>

      NetworkAttachmentDefinition オブジェクトによって定義されたセカンダリーネットワークの名前を指定します。

      <namespace>

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

      < デフォルトルート >

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

2. 以下のコマンドを入力して Pod を作成します。

   $ oc create -f <name>.yaml

   <name> を Pod の名前に置き換えます。

3. オプション: 以下のコマンドを入力して、アノテーションが pod CR に存在することを確認します。<name> を Pod の名前に置き換えます。

   $ oc get pod <name> -o yaml

   次の例では、example-pod Pod が net1 セカンダリーネットワークにアタッチされています。

   $ oc get pod example-pod -o yaml
   apiVersion: v1
   kind: Pod
   metadata:
     annotations:
       k8s.v1.cni.cncf.io/networks: macvlan-bridge
       k8s.v1.cni.cncf.io/network-status: |-
         [{
             "name": "ovn-kubernetes",
             "interface": "eth0",
             "ips": [
                 "10.128.2.14"
             ],
             "default": true,
             "dns": {}
         },{
             "name": "macvlan-bridge",
             "interface": "net1",
             "ips": [
                 "20.2.2.100"
             ],
             "mac": "22:2f:60:a5:f8:00",
             "dns": {}
         }]
     name: example-pod
     namespace: default
   spec:
     ...
   status:
     ...

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

   k8s.v1.cni.cncf.io/network-status

   オブジェクトの JSON 配列を指定します。各オブジェクトは、Pod にアタッチされているセカンダリーネットワークのステータスを表します。アノテーションの値はプレーンテキストの値として保存されます。