23.13. 配置硬件卸载 (offloading)

流程

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.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

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 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

   1

   自定义资源对象的名称。

   2

   必需。vfio-pci 不支持硬件卸载。

   3

   必需。

2. 应用策略的配置：

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

   注意

   当您应用由 SriovNetworkPoolConfig 对象中指定的配置时，SR-IOV Operator 会排空并重启机器配置池中的节点。

   它可能需要几分钟时间来应用配置更改。

流程

1. 运行以下命令，将 network.operator.openshift.io/smart-nic 标签添加到带有 SmartNIC 的每个 worker 节点：

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

   使用 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

   1

   根据您的用例，将此设备替换为适当的网络设备。pfNames 值的 #0-0 部分保留了 OVN-Kubernetes 使用的一个虚拟功能。

   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

   1

   根据您的用例，将此设备替换为适当的网络设备。

   2

   此处提供的值是一个示例。使用 sriov-node-mgmt-vf-policy.yaml 文件中指定的值替换这个值。如需更多信息，请参阅附加资源部分中的 SR-IOV 网络配置对象。

   注意

   sriov-node-mgmt-vf-policy.yaml 文件具有与 sriov-node-policy.yaml 文件不同的 pfNames 和 resourceName 键的值。

4. 为这两个策略应用配置：

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

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

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

   2. 应用 ConfigMap 的配置：

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

流程

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":{}}'

   1

   网络附加定义的名称。

   2

   网络附加定义的命名空间。

   3

   这是您在 SriovNetworkNodePolicy 对象中指定的 spec.resourceName 字段的值。

2. 应用网络附加定义的配置：

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