7.8. SR-IOV の追加ネットワークの設定

手順

1. 以下の SriovNetworkNodePolicy CR を作成してから、YAML を <name>-sriov-node-network.yaml ファイルに保存します。<name> をこの設定の名前に置き換えます。

   apiVersion: sriovnetwork.openshift.io/v1
   kind: SriovNetworkNodePolicy
   metadata:
     name: <name> 1
     namespace: sriov-network-operator 2
   spec:
     resourceName: <sriov_resource_name> 3
     nodeSelector:
       feature.node.kubernetes.io/network-sriov.capable: "true" 4
     priority: <priority> 5
     mtu: <mtu> 6
     numVfs: <num> 7
     nicSelector: 8
       vendor: "<vendor_code>" 9
       deviceID: "<device_id>" 10
       pfNames: ["<pf_name>", ...] 11
       rootDevices: ["<pci_bus_id>", "..."] 12
     deviceType: <device_type> 13
     isRdma: false 14

   1

   CR の名前を指定します。

   2

   SR-IOV Operator がインストールされている namespace を指定します。

   3

   SR-IOV デバイスプラグインのリソース名を指定します。プレフィックス openshift.io/ は Pod 仕様で参照される場合に追加されます。1 つのリソース名に複数の SriovNetworkNodePolicy CR を作成できます。

   4

   設定するノードを選択するノードセレクターを指定します。ユーザーは、手動で、または Kubernetes Node Feature Discovery などのツールを使ってノードにラベルを付けることを選択できます。選択したノード上の SR-IOV ネットワークデバイスのみが設定されます。SR-IOV CNI プラグインおよびデバイスプラグインは、選択されたノードにのみデプロイされます。

   5

   0 から 99 までの整数値を指定します。数値が大きいほど優先度が低くなるため、99 の優先度は 10よりも低くなります。

   6

   Virtual Function の最大転送単位 (MTU) の値を指定します。MTU の値は 1 から 9000 の範囲である必要があります。MTU を指定しない場合は、'' の値を指定します。

   7

   SR-IOV 物理ネットワークデバイス用に作成する VF (仮想機能) の数を指定します。Intel Network Interface Card (NIC) の場合、VF の数はデバイスがサポートする VF の合計よりも大きくすることはできません。Mellanox NIC の場合、VF の数は 128 よりも大きくすることはできません。

   8

   nicSelector マッピングは、Operator が設定するイーサネットデバイスを選択します。すべてのパラメーターの値を指定する必要はありません。意図せずにイーサネットデバイスを選択する可能性を最低限に抑えるために、イーサネットアダプターを正確に特定できるようにすることが推奨されます。rootDevices を指定する場合、vendor、 deviceID、または pfName の値も指定する必要があります。pfName と rootDevices の両方を同時に指定する場合、それらが同一のデバイスをポイントすることを確認します。

   9

   SR-IOV ネットワークデバイスのベンダー 16 進コードを指定します。許可される値は 8086 または 15b3 のいずれかのみになります。

   10

   SR-IOV ネットワークデバイスのデバイス 16 進コードを指定します。許可される値は 158b、1015、 1017 のみになります。

   11

   このパラメーターは、1 つ以上のイーサネットデバイスの物理機能 (PF) 名の配列を受け入れます。

   12

   このパラメーターは、イーサネットデバイスの物理機能についての 1 つ以上の PCI バスアドレスの配列を受け入れます。以下の形式でアドレスを指定します: 0000:02:00.1

   13

   仮想機能のドライバータイプを指定します。以下の値のいずれかを指定できます: netdevice または vfio-pciデフォルト値は netdevice です。

   14

   RDMA モードを有効にするかどうかを指定します。デフォルト値は false です。Mellanox Ethernet アダプターでは、RoCE (RDMA over Converged Ethernet) モードのみがサポートされます。

   注記

   RDMA フラグが true に設定される場合、引き続き RDMA 対応の VF を通常のネットワークデバイスとして使用できます。デバイスはどちらのモードでも使用できます。

2. 以下のコマンドを実行して CR を作成します。

   $ oc create -f <filename> 1

   1

   <filename> を、先の手順で作成したファイルの名前に置き換えます。

手順

1. 以下の SriovNetwork CR を作成してから、YAML を <name>-sriov-network.yaml ファイルに保存します。<name> を、この追加ネットワークの名前に置き換えます。

   apiVersion: sriovnetwork.openshift.io/v1
   kind: SriovNetwork
   metadata:
     name: <name> 1
     namespace: sriov-network-operator 2
   spec:
     networkNamespace: <target_namespace> 3
     ipam: |- 4
       ...
     vlan: <vlan> 5
     resourceName: <sriov_resource_name> 6

   1

   <name> を CR の名前に置き換えます。Operator は同じ名前を持つ NetworkAttachmentDefinition CR を作成します。

   2

   SR-IOV Operator がインストールされている namespace を指定します。

   3

   <target_namespace> を NetworkAttachmentDefinition CR が作成される namespace に置き換えます。

   4

   IPAM CNI プラグインの設定オブジェクトを YAML ブロックスケーラーとして指定します。プラグインは、割り当て定義についての IP アドレスの割り当てを管理します。

   5

   <vlan> を、追加ネットワークの仮想 LAN (VLAN) ID に置き換えます。整数値は 0 から 4095である必要があります。デフォルト値は 0 です。

   6

   <sriov_resource_name> を、この追加ネットワークの SR-IOV ハードウェアを定義する SriovNetworkNodePolicy CR の .spec.resourceName パラメーターの値に置き換えます。

2. 以下のコマンドを実行して CR を作成します。

   $ oc create -f <filename> 1

   1

   <filename> を、先の手順で作成したファイルの名前に置き換えます。

3. オプション: 以下のコマンドを実行して、直前の手順で作成した SriovNetwork CR に関連付けられた NetworkAttachmentDefinition CR が存在することを確認します。<namespace> を、SriovNetwork CR で指定した namespace に置き換えます。

   oc get net-attach-def -n <namespace>

1. Pod リソース定義を作成し、k8s.v1.cni.cncf.io/networks パラメーターを Pod の metadata マッピングに追加します。k8s.v1.cni.cncf.io/networks は、1 つ以上の NetworkAttachmentDefinition カスタムリソース (CR) 名のカンマ区切りの一覧を受け入れます。

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

   1

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

   以下の例では、2 つの追加のネットワークが Pod に割り当てられます。

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

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

   $ oc create -f pod.yaml

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/networks-status: |- 1
         [{
             "name": "openshift-sdn",
             "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:
     ...

   1

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