18.10. ハードウェアオフロードの設定

手順

1. すべての SR-IOV Operator コンポーネントをデプロイするには、SriovOperatorConfig カスタムリソース (CR) を作成します。

   1. 次の YAML を含む sriovOperatorConfig.yaml という名前のファイルを作成します。

      apiVersion: sriovnetwork.openshift.io/v1
      kind: SriovOperatorConfig
      metadata:
        name: default 

      1

      
        namespace: openshift-sriov-network-operator
      spec:
        enableInjector: true
        enableOperatorWebhook: true
        configurationMode: "systemd" 

      2

      
        logLevel: 2

      Copy to Clipboard Toggle word wrap

      1

      SriovOperatorConfig リソースの有効な名前は default のみであり、Operator がデプロイされている namespace 内にある必要があります。

      2

      SR-IOV Network Operator の systemd モードへの設定は、Open vSwitch ハードウェアオフロードのみが対象です。

   2. 次のコマンドを実行して、リソースを作成します。

      $ oc apply -f sriovOperatorConfig.yaml

      Copy to Clipboard Toggle word wrap

前提条件

1. SR-IOV Network Operator がインストールされ、systemd モードに設定されている。

手順

1. ハードウェアオフロードを使用するマシンのマシン設定プールを作成します。

   1. 次の例のようなコンテンツを含む mcp-offloading.yaml などのファイルを作成します。

      apiVersion: machineconfiguration.openshift.io/v1
      kind: MachineConfigPool
      metadata:
        name: mcp-offloading 

      1

      
      spec:
        machineConfigSelector:
          matchExpressions:
            - {key: machineconfiguration.openshift.io/role, operator: In, values: [worker,mcp-offloading]} 

      2

      
        nodeSelector:
          matchLabels:
            node-role.kubernetes.io/mcp-offloading: "" 

      3

      Copy to Clipboard Toggle word wrap

      1 2

      ハードウェアオフロード用のマシン設定プールの名前。

      3

      このノードロールラベルは、マシン設定プールにノードを追加するために使用されます。

   2. マシン設定プールの設定を適用します。

      $ oc create -f mcp-offloading.yaml

      Copy to Clipboard Toggle word wrap

2. マシン設定プールにノードを追加します。プールのノードロールラベルで各ノードにラベルを付けます。

   $ oc label node worker-2 node-role.kubernetes.io/mcp-offloading=""

   Copy to Clipboard Toggle word wrap

3. オプション: 新しいプールが作成されたことを確認するには、次のコマンドを実行します。

   $ oc get nodes

   Copy to Clipboard Toggle word wrap

   出力例

   NAME       STATUS   ROLES                   AGE   VERSION
   master-0   Ready    master                  2d    v1.29.4
   master-1   Ready    master                  2d    v1.29.4
   master-2   Ready    master                  2d    v1.29.4
   worker-0   Ready    worker                  2d    v1.29.4
   worker-1   Ready    worker                  2d    v1.29.4
   worker-2   Ready    mcp-offloading,worker   47h   v1.29.4
   worker-3   Ready    mcp-offloading,worker   47h   v1.29.4

   Copy to Clipboard Toggle word wrap

4. このマシン設定プールを SriovNetworkPoolConfig カスタムリソースに追加します。

   1. 次の例のようなコンテンツを含むファイル (sriov-pool-config.yaml など) を作成します。

      apiVersion: sriovnetwork.openshift.io/v1
      kind: SriovNetworkPoolConfig
      metadata:
        name: sriovnetworkpoolconfig-offload
        namespace: openshift-sriov-network-operator
      spec:
        ovsHardwareOffloadConfig:
          name: mcp-offloading 

      1

      Copy to Clipboard Toggle word wrap

      1

      ハードウェアオフロード用のマシン設定プールの名前。

   2. 設定を適用します。

      $ oc create -f <SriovNetworkPoolConfig_name>.yaml

      Copy to Clipboard Toggle word wrap
      注記

      SriovNetworkPoolConfig オブジェクトで指定された設定を適用すると、SR-IOV Operator は、マシン設定プール内のノードをドレインして再起動します。

      設定の変更が適用されるまでに数分かかる場合があります。

手順

1. 次の例のようなコンテンツを含むファイル (sriov-node-policy.yaml など) を作成します。

   apiVersion: sriovnetwork.openshift.io/v1
   kind: SriovNetworkNodePolicy
   metadata:
     name: sriov-node-policy 

   1

   
     namespace: openshift-sriov-network-operator
   spec:
     deviceType: netdevice 

   2

   
     eSwitchMode: "switchdev" 

   3

   
     nicSelector:
       deviceID: "1019"
       rootDevices:
       - 0000:d8:00.0
       vendor: "15b3"
       pfNames:
       - ens8f0
     nodeSelector:
       feature.node.kubernetes.io/network-sriov.capable: "true"
     numVfs: 6
     priority: 5
     resourceName: mlxnics

   Copy to Clipboard Toggle word wrap

   1

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

   2

   必須。ハードウェアのオフロードは、vfio-pci ではサポートされていません。

   3

   必須。

2. ポリシーの設定を適用します。

   $ oc create -f sriov-node-policy.yaml

   Copy to Clipboard Toggle word wrap
   注記

   SriovNetworkPoolConfig オブジェクトで指定された設定を適用すると、SR-IOV Operator は、マシン設定プール内のノードをドレインして再起動します。

   設定の変更が適用されるまでに数分かかる場合があります。

手順

1. 次のコマンドを実行して、SmartNIC が存在する各ワーカーノードに network.operator.openshift.io/smart-nic ラベルを追加します。

   $ oc label node <node-name> network.operator.openshift.io/smart-nic=

   Copy to Clipboard Toggle word wrap

   oc get nodes コマンドを使用して、使用可能なノードのリストを取得します。

2. 次の例のような内容を含む、管理ポート用の sriov-node-mgmt-vf-policy.yaml という名前のポリシーを作成します。

   apiVersion: sriovnetwork.openshift.io/v1
   kind: SriovNetworkNodePolicy
   metadata:
     name: sriov-node-mgmt-vf-policy
     namespace: openshift-sriov-network-operator
   spec:
     deviceType: netdevice
     eSwitchMode: "switchdev"
     nicSelector:
       deviceID: "1019"
       rootDevices:
       - 0000:d8:00.0
       vendor: "15b3"
       pfNames:
       - ens8f0#0-0 

   1

   
     nodeSelector:
       network.operator.openshift.io/smart-nic: ""
     numVfs: 6 

   2

   
     priority: 5
     resourceName: mgmtvf

   Copy to Clipboard Toggle word wrap

   1

   このデバイスは、ユースケースに適したネットワークデバイスに置き換えます。pfNames 値の #0-0 の部分は、OVN-Kubernetes によって使用される単一の Virtual Function を予約します。

   2

   ここで提供される値は例です。この値は、要件を満たす値に置き換えます。詳細は、関連情報 セクションの SR-IOV ネットワークノード設定オブジェクト を参照してください。

3. 次の例のような内容を含む sriov-node-policy.yaml という名前のポリシーを作成します。

   apiVersion: sriovnetwork.openshift.io/v1
   kind: SriovNetworkNodePolicy
   metadata:
     name: sriov-node-policy
     namespace: openshift-sriov-network-operator
   spec:
     deviceType: netdevice
     eSwitchMode: "switchdev"
     nicSelector:
       deviceID: "1019"
       rootDevices:
       - 0000:d8:00.0
       vendor: "15b3"
       pfNames:
       - ens8f0#1-5 

   1

   
     nodeSelector:
       network.operator.openshift.io/smart-nic: ""
     numVfs: 6 

   2

   
     priority: 5
     resourceName: mlxnics

   Copy to Clipboard Toggle word wrap

   1

   このデバイスは、ユースケースに適したネットワークデバイスに置き換えます。

   2

   ここで提供される値は例です。この値は sriov-node-mgmt-vf-policy.yaml ファイルで指定された値に置き換えます。詳細は、関連情報 セクションの SR-IOV ネットワークノード設定オブジェクト を参照してください。

   注記

   sriov-node-mgmt-vf-policy.yaml ファイルには、pfNames キーと resourceName キーの値が sriov-node-policy.yaml ファイルとは異なります。

4. 両方のポリシーの設定を適用します。

   $ oc create -f sriov-node-policy.yaml

   Copy to Clipboard Toggle word wrap

   $ oc create -f sriov-node-mgmt-vf-policy.yaml

   Copy to Clipboard Toggle word wrap

5. 管理設定用にクラスター内に Cluster Network Operator (CNO) ConfigMap を作成します。

   1. 次の内容を含む hardware-offload-config.yaml という名前の ConfigMap を作成します。

      apiVersion: v1
      kind: ConfigMap
      metadata:
          name: hardware-offload-config
          namespace: openshift-network-operator
      data:
          mgmt-port-resource-name: openshift.io/mgmtvf

      Copy to Clipboard Toggle word wrap

   2. ConfigMap の設定を適用します。

      $ oc create -f hardware-offload-config.yaml

      Copy to Clipboard Toggle word wrap

手順

1. 次の例のようなコンテンツを含むファイル (net-attach-def.yaml など) を作成します。

   apiVersion: "k8s.cni.cncf.io/v1"
   kind: NetworkAttachmentDefinition
   metadata:
     name: net-attach-def 

   1

   
     namespace: net-attach-def 

   2

   
     annotations:
       k8s.v1.cni.cncf.io/resourceName: openshift.io/mlxnics 

   3

   
   spec:
     config: '{"cniVersion":"0.3.1","name":"ovn-kubernetes","type":"ovn-k8s-cni-overlay","ipam":{},"dns":{}}'

   Copy to Clipboard Toggle word wrap

   1

   ネットワーク接続定義の名前。

   2

   ネットワーク接続定義の namespace。

   3

   これは、SriovNetworkNodePolicy オブジェクトで指定した spec.resourceName フィールドの値です。

2. ネットワーク接続定義の設定を適用します。

   $ oc create -f net-attach-def.yaml

   Copy to Clipboard Toggle word wrap