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

절차

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

   <.> 네트워크 연결 정의의 이름입니다. <.> 네트워크 연결 정의의 네임스페이스입니다. <.> SriovNetworkNodePolicy 오브젝트에 지정한 spec.resourceName 필드의 값입니다.

2. 네트워크 연결 정의에 대한 구성을 적용합니다.

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