23.13. 하드웨어 오프로드 구성

프로세스

1. SriovOperatorConfig CR(사용자 정의 리소스)을 생성하여 모든 SR-IOV Operator 구성 요소를 배포합니다.

   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가 배포된 네임스페이스에 있어야 합니다.

      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.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. 다음 명령을 실행하여 SmartNIC를 사용하여 각 작업자 노드에 network.operator.openshift.io/smart-nic 레이블을 추가합니다.

   $ 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. 관리 구성을 위해 클러스터에 CNO(Cluster Network Operator) 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