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

手順

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

      1

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

      2

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

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

      $ oc apply -f sriovOperatorConfig.yaml

前提条件

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

      1 2

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

      3

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

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

      $ oc create -f mcp-offloading.yaml

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

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

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

   $ oc get nodes

   出力例

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

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

      1

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

   2. 設定を適用します。

      $ oc create -f <SriovNetworkPoolConfig_name>.yaml

      注記

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

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

手順

1. 次の例のようなコンテンツを含むファイル (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
     nodeSelector:
       feature.node.kubernetes.io/network-sriov.capable: "true"
     numVfs: 6
     priority: 5
     resourceName: mlxnics

   <.> カスタムリソースオブジェクトの名前。<.> 必須。ハードウェアのオフロードは vfio-pci ではサポートされていません。<.> 必須。

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

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

   注記

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

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

手順

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

   apiVersion: "k8s.cni.cncf.io/v1"
   kind: NetworkAttachmentDefinition
   metadata:
     name: net-attach-def <.>
     namespace: net-attach-def <.>
     annotations:
       k8s.v1.cni.cncf.io/resourceName: openshift.io/mlxnics <.>
   spec:
     config: '{"cniVersion":"0.3.1","name":"ovn-kubernetes","type":"ovn-k8s-cni-overlay","ipam":{},"dns":{}}'

   <.> ネットワーク接続定義の名前。<.> ネットワーク接続定義の namespace。<.> これは、SriovNetworkNodePolicy オブジェクトで指定した spec.resourceName フィールドの値です。

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

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