6.2. 1 つの sysctl フラグの設定

手順

1. SriovNetworkNodePolicy カスタムリソース (CR) を作成します。たとえば、次の YAML をファイル policyoneflag-sriov-node-network.yaml として保存します。

   apiVersion: sriovnetwork.openshift.io/v1
   kind: SriovNetworkNodePolicy
   metadata:
     name: policyoneflag 

   1

   
     namespace: openshift-sriov-network-operator 

   2

   
   spec:
     resourceName: policyoneflag 

   3

   
     nodeSelector: 

   4

   
       feature.node.kubernetes.io/network-sriov.capable="true"
     priority: 10 

   5

   
     numVfs: 5 

   6

   
     nicSelector: 

   7

   
       pfNames: ["ens5"] 

   8

   
     deviceType: "netdevice" 

   9

   
     isRdma: false 

   10

   Copy to Clipboard Toggle word wrap

   1

   カスタムリソースオブジェクトの名前。

   2

   SR-IOV Network Operator がインストールされている namespace。

   3

   SR-IOV ネットワークデバイスプラグインのリソース名。1 つのリソース名に複数の SR-IOV ネットワークポリシーを作成できます。

   4

   ノードセレクターは設定するノードを指定します。選択したノード上の SR-IOV ネットワークデバイスのみが設定されます。SR-IOV Container Network Interface (CNI) プラグインおよびデバイスプラグインは、選択したノードにのみデプロイされます。

   5

   オプション: 優先度は 0 から 99 までの整数値で指定されます。値が小さいほど優先度が高くなります。たとえば、10 の優先度は 99 よりも高くなります。デフォルト値は 99 です。

   6

   SR-IOV 物理ネットワークデバイス用に作成する Virtual Function (VF) の数。Intel ネットワークインターフェイスコントローラー (NIC) の場合、VF の数はデバイスがサポートする VF の合計よりも大きくすることはできません。Mellanox NIC の場合、VF の数は 127 よりも大きくすることはできません。

   7

   NIC セレクターは、Operator が設定するデバイスを特定します。すべてのパラメーターの値を指定する必要はありません。意図せずにデバイスを選択しないように、ネットワークデバイスを極めて正確に特定することが推奨されます。rootDevices を指定する場合、vendor、deviceID、または pfNames の値も指定する必要があります。pfNames および rootDevices の両方を同時に指定する場合、それらが同一のデバイスを参照していることを確認します。netFilter の値を指定する場合、ネットワーク ID は一意の ID であるためにその他のパラメーターを指定する必要はありません。

   8

   オプション: 1 つ以上のデバイスの物理機能 (PF) 名の配列。

   9

   オプション: Virtual Function のドライバータイプ。許可される唯一の値は netdevice です。ベアメタルノードで Mellanox NIC を DPDK モードで動作させるには、isRdma を true に設定します。

   10

   オプション: Remote Direct Memory Access (RDMA) モードを有効にするかどうかを設定します。デフォルト値は false です。isRdma パラメーターが true に設定される場合、引き続き RDMA 対応の VF を通常のネットワークデバイスとして使用できます。デバイスはどちらのモードでも使用できます。isRdma を true に設定し、追加の needVhostNet を true に設定して、Fast Datapath DPDK アプリケーションで使用する Mellanox NIC を設定します。

   注記

   vfio-pci ドライバータイプはサポートされていません。

2. SriovNetworkNodePolicy オブジェクトを作成します。

   $ oc create -f policyoneflag-sriov-node-network.yaml

   Copy to Clipboard Toggle word wrap

   設定の更新が適用された後に、sriov-network-operator namespace 変更のすべての Pod が Running ステータスに移行します。

3. SR-IOV ネットワークデバイスが設定されていることを確認するには、以下のコマンドを実行します。<node_name> を、設定したばかりの SR-IOV ネットワークデバイスを持つノードの名前に置き換えます。予想される出力には Succeeded が表示されます。

   $ oc get sriovnetworknodestates -n openshift-sriov-network-operator <node_name> -o jsonpath='{.status.syncStatus}'

   Copy to Clipboard Toggle word wrap

手順

1. 追加の SR-IOV ネットワーク割り当て用の SriovNetwork カスタムリソース (CR) を作成し、以下のサンプル CR のように metaPlugins 設定を挿入します。YAML を sriov-network-interface-sysctl.yaml ファイルとして保存します。

   apiVersion: sriovnetwork.openshift.io/v1
   kind: SriovNetwork
   metadata:
     name: onevalidflag 

   1

   
     namespace: openshift-sriov-network-operator 

   2

   
   spec:
     resourceName: policyoneflag 

   3

   
     networkNamespace: sysctl-tuning-test 

   4

   
     ipam: '{ "type": "static" }' 

   5

   
     capabilities: '{ "mac": true, "ips": true }' 

   6

   
     metaPlugins : | 

   7

   
       {
         "type": "tuning",
         "capabilities":{
           "mac":true
         },
         "sysctl":{
            "net.ipv4.conf.IFNAME.accept_redirects": "1"
         }
       }

   Copy to Clipboard Toggle word wrap

   1

   オブジェクトの名前。SR-IOV Network Operator は、同じ名前を持つ NetworkAttachmentDefinition オブジェクトを作成します。

   2

   SR-IOV Network Operator がインストールされている namespace。

   3

   この追加ネットワークの SR-IOV ハードウェアを定義する SriovNetworkNodePolicy オブジェクトの spec.resourceName パラメーターの値。

   4

   SriovNetwork オブジェクトのターゲット namespace。ターゲット namespace の Pod のみを追加ネットワークに割り当てることができます。

   5

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

   6

   オプション: 追加のネットワークの機能を設定します。IP アドレスのサポートを有効にするには、"{ "ips": true }" を指定できます。または、MAC アドレスのサポートを有効にするには "{ "mac": true }" を指定します。

   7

   オプション: metaPlugins パラメーターは、デバイスに機能を追加するために使用されます。このユースケースでは、type フィールドを tuning に設定します。設定したいインターフェイスレベルのネットワーク sysctl を sysctl フィールドに指定します。

2. SriovNetwork リソースを作成します。

   $ oc create -f sriov-network-interface-sysctl.yaml

   Copy to Clipboard Toggle word wrap

1. Pod CR を作成します。次の YAML を examplepod.yaml ファイルとして保存します。

   apiVersion: v1
   kind: Pod
   metadata:
     name: tunepod
     namespace: sysctl-tuning-test
     annotations:
       k8s.v1.cni.cncf.io/networks: |-
         [
           {
             "name": "onevalidflag",  

   1

   
             "mac": "0a:56:0a:83:04:0c", 

   2

   
             "ips": ["10.100.100.200/24"] 

   3

   
          }
         ]
   spec:
     containers:
     - name: podexample
       image: centos
       command: ["/bin/bash", "-c", "sleep INF"]
       securityContext:
         runAsUser: 2000
         runAsGroup: 3000
         allowPrivilegeEscalation: false
         capabilities:
           drop: ["ALL"]
     securityContext:
       runAsNonRoot: true
       seccompProfile:
         type: RuntimeDefault

   Copy to Clipboard Toggle word wrap

   1

   SR-IOV ネットワーク割り当て定義 CR の名前。

   2

   オプション: SR-IOV ネットワーク割り当て定義 CR で定義されるリソースタイプから割り当てられる SR-IOV デバイスの MAC アドレス。この機能を使用するには、SriovNetwork オブジェクトで { "mac": true } も指定する必要があります。

   3

   オプション: SR-IOV ネットワーク割り当て定義 CR で定義されるリソースタイプから割り当てられる SR-IOV デバイスの IP アドレス。IPv4 と IPv6 アドレスの両方がサポートされます。この機能を使用するには、SriovNetwork オブジェクトで { "ips": true } も指定する必要があります。

2. Pod CR を作成します。

   $ oc apply -f examplepod.yaml

   Copy to Clipboard Toggle word wrap

3. 次のコマンドを実行して、Pod が作成されていることを確認します。

   $ oc get pod -n sysctl-tuning-test

   Copy to Clipboard Toggle word wrap

   出力例

   NAME      READY   STATUS    RESTARTS   AGE
   tunepod   1/1     Running   0          47s

   Copy to Clipboard Toggle word wrap

4. 次のコマンドを実行して、Pod にログインします。

   $ oc rsh -n sysctl-tuning-test tunepod

   Copy to Clipboard Toggle word wrap

5. 設定された sysctl フラグの値を確認します。次のコマンドを実行して、net.ipv4.conf.IFNAME.accept_redirects の値を見つけます。

   $ sysctl net.ipv4.conf.net1.accept_redirects

   Copy to Clipboard Toggle word wrap