3.3. Pod をセカンダリーネットワークにアタッチする

手順

1. Pod リソース定義を編集します。既存の Pod リソースを編集する場合は、以下のコマンドを実行してデフォルトエディターでその定義を編集します。<name> を、編集する Pod リソースの名前に置き換えます。

   $ oc edit pod <name>

2. Pod リソース定義で、k8s.v1.cni.cncf.io/networks パラメーターを Pod の metadata マッピングに追加します。k8s.v1.cni.cncf.io/networks は、追加のプロパティーを指定するだけでなく、NetworkAttachmentDefinition カスタムリソース (CR) 名を参照するオブジェクトリストの JSON 文字列を受け入れます。

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

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

   <network>

   次の例に示すように、JSON オブジェクトに置き換えます。一重引用符が必要です。

   次の例では、アノテーション内で default-route パラメーターを使用して、デフォルトルートを持つネットワークアタッチメントを指定しています。

   apiVersion: v1
   kind: Pod
   metadata:
     name: example-pod
     annotations:
       k8s.v1.cni.cncf.io/networks: '[
       {
         "name": "net1"
       },
       {
         "name": "net2",
         "default-route": ["192.0.2.1"]
       }]'
   spec:
     containers:
     - name: example-pod
       command: ["/bin/bash", "-c", "sleep 2000000000000"]
       image: centos/tools

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

   name

   Pod に関連付けるセカンダリーネットワークの名前を指定します。

   default-route

   ルーティングテーブルに他のルーティングテーブルがない場合に、ルーティングされるトラフィックのゲートウェイ値を指定します。複数の default-route キーを指定すると、Pod がアクティブでなくなります。

   デフォルトのルートにより、他のルートに指定されていないトラフィックがゲートウェイにルーティングされます。

   重要

   OpenShift Container Platform のデフォルトのネットワークインターフェイス以外のインターフェイスへのデフォルトのルートを設定すると、Pod 間のトラフィックに予想されるトラフィックが別のインターフェイスでルーティングされる可能性があります。

   Pod のルーティングプロパティーを確認する場合、oc コマンドを Pod 内で ip コマンドを実行するために使用できます。

   $ oc exec -it <pod_name> -- ip route

   注記

   また、Pod の k8s.v1.cni.cncf.io/network-status を参照して、JSON 形式のオブジェクトリスト内の default-route キーの存在によって、どのセカンダリーネットワークにデフォルトルートが割り当てられているかを確認することもできます。

   Pod に静的 IP アドレスまたは MAC アドレスを設定するには、JSON 形式のアノテーションを使用できます。これには、この機能をとくに許可するネットワークを作成する必要があります。これは、CNO の rawCNIConfig で指定できます。

3. 以下のコマンドを実行して CNO CR を編集します。

   $ oc edit networks.operator.openshift.io cluster

   以下の YAML は、CNO の設定パラメーターを説明しています。

   Cluster Network Operator YAML の設定

   name: <name>
   namespace: <namespace>
   rawCNIConfig: '{
     ...
   }'
   type: Raw

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

   name

   作成するセカンダリーネットワーク割り当ての名前を指定します。名前は指定された namespace 内で一意である必要があります。

   namespace

   ネットワークの割り当てを作成する namespace を指定します。値を指定しない場合、default の namespace が使用されます。

   rawCNIConfig

   以下のテンプレートに基づく CNI プラグイン設定を JSON 形式で指定します。

   以下のオブジェクトは、macvlan CNI プラグインを使用して静的 MAC アドレスと IP アドレスを使用するための設定パラメーターを説明しています。

   静的 IP および MAC アドレスを使用した macvlan CNI プラグイン JSON 設定オブジェクト

   {
     "cniVersion": "0.3.1",
     "name": "<name>",
     "plugins": [{
         "type": "macvlan",
         "capabilities": { "ips": true },
         "master": "eth0",
         "mode": "bridge",
         "ipam": {
           "type": "static"
         }
       }, {
         "capabilities": { "mac": true },
         "type": "tuning"
       }]
   }

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

   name

   作成するセカンダリーネットワークアタッチメントの名前を指定します。名前は指定された namespace 内で一意である必要があります。

   plugins

   CNI プラグイン設定の配列を指定します。1 つ目のオブジェクトは、macvlan プラグイン設定を指定し、2 つ目のオブジェクトはチューニングプラグイン設定を指定します。

   ips

   CNI プラグインのランタイム設定機能の静的 IP 機能を有効にするために要求が実行されるように指定します。

   master

   macvlan プラグインが使用するインターフェイスを指定します。

   mac

   CNI プラグインの静的 MAC アドレス機能を有効にするために要求が実行されるように指定します。

   上記のネットワークアタッチメントは、特定の Pod に割り当てる静的 IP と MAC アドレスを指定するためのキーとともに、JSON 形式のアノテーション内で参照できます。

4. 以下のコマンドを入力して Pod を編集します。

   $ oc edit pod <name>

   静的 IP および MAC アドレスを使用した macvlan CNI プラグイン JSON 設定オブジェクト

   apiVersion: v1
   kind: Pod
   metadata:
     name: example-pod
     annotations:
       k8s.v1.cni.cncf.io/networks: '[
         {
           "name": "<name>",
           "ips": [ "192.0.2.205/24" ],
           "mac": "CA:FE:C0:FF:EE:00"
         }
       ]'

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

   name

   作成するセカンダリーネットワークアタッチメントの名前を指定します。名前は指定された namespace 内で一意である必要があります。

   ips

   サブネットマスクを含む IP アドレスを指定します。

   mac

   MAC アドレスを指定します。

   注記

   静的 IP アドレスおよび MAC アドレスを同時に使用することはできません。これらは個別に、または一緒に使用することもできます。