8.5. SR-IOV 네트워크에 가상 머신 연결

절차

1. SriovNetworkNodePolicy 오브젝트를 생성한 후 YAML을 <name>-sriov-node-network.yaml 파일에 저장합니다. <name>을 이 구성의 이름으로 바꿉니다.

   apiVersion: sriovnetwork.openshift.io/v1
   kind: SriovNetworkNodePolicy
   metadata:
     name: <name> 

   1

   
     namespace: openshift-sriov-network-operator 

   2

   
   spec:
     resourceName: <sriov_resource_name> 

   3

   
     nodeSelector:
       feature.node.kubernetes.io/network-sriov.capable: "true" 

   4

   
     priority: <priority> 

   5

   
     mtu: <mtu> 

   6

   
     numVfs: <num> 

   7

   
     nicSelector: 

   8

   
       vendor: "<vendor_code>" 

   9

   
       deviceID: "<device_id>" 

   10

   
       pfNames: ["<pf_name>", ...] 

   11

   
       rootDevices: ["<pci_bus_id>", "..."] 

   12

   
     deviceType: vfio-pci 

   13

   
     isRdma: false 

   14

   Copy to Clipboard Toggle word wrap

   1

   CR 오브젝트의 이름을 지정합니다.

   2

   SR-IOV Operator가 설치된 네임스페이스를 지정합니다.

   3

   SR-IOV 장치 플러그인의 리소스 이름을 지정합니다. 리소스 이름에 대해 여러 SriovNetworkNodePolicy 오브젝트를 생성할 수 있습니다.

   4

   구성할 노드를 선택하려면 노드 선택기를 지정합니다. 선택한 노드의 SR-IOV 네트워크 장치만 구성됩니다. SR-IOV CNI(Container Network Interface) 플러그인 및 장치 플러그인은 선택한 노드에만 배포됩니다.

   5

   선택 사항: 0에서 99 사이의 정수 값을 지정합니다. 숫자가 작을수록 우선 순위가 높아지므로 우선 순위 10은 우선 순위 99보다 높습니다. 기본값은 99입니다.

   6

   선택 사항: 가상 기능의 최대 전송 단위(MTU) 값을 지정합니다. 최대 MTU 값은 NIC 모델마다 다를 수 있습니다.

   7

   SR-IOV 물리적 네트워크 장치에 생성할 가상 기능(VF) 수를 지정합니다. Intel NIC(Network Interface Controller)의 경우 VF 수는 장치에서 지원하는 총 VF보다 클 수 없습니다. Mellanox NIC의 경우 VF 수는 128보다 클 수 없습니다.

   8

   nicSelector 매핑은 Operator가 구성할 이더넷 장치를 선택합니다. 모든 매개변수에 값을 지정할 필요는 없습니다. 의도하지 않게 이더넷 장치를 선택할 가능성을 최소화하기 위해 이더넷 어댑터를 충분히 정밀하게 식별하는 것이 좋습니다. rootDevices를 지정하면 vendor, deviceID 또는 pfNames의 값도 지정해야 합니다. pfNames와 rootDevices를 동시에 지정하는 경우 동일한 장치를 가리키는지 확인하십시오.

   9

   선택 사항: SR-IOV 네트워크 장치의 공급업체 16진 코드를 지정합니다. 허용되는 유일한 값은 8086 또는 15b3입니다.

   10

   선택 사항: SR-IOV 네트워크 장치의 장치 16진수 코드를 지정합니다. 허용되는 값은 158b, 1015, 1017입니다.

   11

   선택 사항:이 매개변수는 이더넷 장치에 대한 하나 이상의 PF(물리적 기능) 이름 배열을 허용합니다.

   12

   이 매개변수는 이더넷 장치의 물리적 기능을 위해 하나 이상의 PCI 버스 주소 배열을 허용합니다. 주소를 0000:02: 00.1 형식으로 입력합니다.

   13

   vfio-pci 드라이버 유형은 OpenShift Virtualization의 가상 기능에 필요합니다.

   14

   선택 사항: 원격 직접 메모리 액세스(RDMA) 모드 사용 여부를 지정합니다. Mellanox 카드의 경우 isRdma를 false로 설정합니다. 기본값은 false입니다.

   참고

   isRDMA 플래그가 true로 설정된 경우 RDMA 가능 VF를 일반 네트워크 장치로 계속 사용할 수 있습니다. 어느 모드에서나 장치를 사용할 수 있습니다.

2. 선택 사항: SriovNetworkNodePolicy.Spec.NodeSelector 를 사용하여 SR-IOV 가능 클러스터 노드에 레이블을 지정하지 않은 경우 레이블을 지정합니다. 노드 레이블 지정에 대한 자세한 내용은 "노드에서 라벨을 업데이트하는 방법 이해"를 참조하십시오.

3. SriovNetworkNodePolicy 오브젝트를 생성합니다.

   $ oc create -f <name>-sriov-node-network.yaml

   Copy to Clipboard Toggle word wrap

   <name>은 이 구성의 이름을 지정합니다.

   구성 업데이트를 적용하면 sriov-network-operator 네임스페이스의 모든 Pod가 Running 상태로 전환됩니다.

4. SR-IOV 네트워크 장치가 구성되어 있는지 확인하려면 다음 명령을 입력합니다. <node_name>을 방금 구성한 SR-IOV 네트워크 장치가 있는 노드 이름으로 바꿉니다.

   $ oc get sriovnetworknodestates -n openshift-sriov-network-operator <node_name> -o jsonpath='{.status.syncStatus}'

   Copy to Clipboard Toggle word wrap

절차

1. 다음 SriovNetwork 오브젝트를 생성한 후 YAML을 <name>-sriov-network.yaml 파일에 저장합니다. <name>을 이 추가 네트워크의 이름으로 변경합니다.

2. 오브젝트를 생성하려면 다음 명령을 입력합니다. <name>을 이 추가 네트워크의 이름으로 변경합니다.

   $ oc create -f <name>-sriov-network.yaml

   Copy to Clipboard Toggle word wrap

3. 선택 사항: 이전 단계에서 생성한 SriovNetwork 오브젝트에 연결된 NetworkAttachmentDefinition 오브젝트가 존재하는지 확인하려면 다음 명령을 입력합니다. <namespace>를 SriovNetwork 오브젝트에 지정한 네임스페이스로 바꿉니다.

   $ oc get net-attach-def -n <namespace>

   Copy to Clipboard Toggle word wrap

프로세스

1. 다음 예와 같이 VM 구성의 spec.domain.devices.interfaces 및 spec.networks 스탠자에 SR-IOV 네트워크 세부 정보를 추가합니다.

   apiVersion: kubevirt.io/v1
   kind: VirtualMachine
   metadata:
     name: example-vm
   spec:
     domain:
       devices:
         interfaces:
         - name: default
           masquerade: {}
         - name: nic1 

   1

   
           sriov: {}
     networks:
     - name: default
       pod: {}
     - name: nic1 

   2

   
       multus:
           networkName: sriov-network 

   3

   
   # ...

   Copy to Clipboard Toggle word wrap

   1

   SR-IOV 인터페이스의 고유 이름을 지정합니다.

   2

   SR-IOV 인터페이스의 이름을 지정합니다. 이전에 정의한 interfaces.name과 동일해야 합니다.

   3

   SR-IOV 네트워크 연결 정의의 이름을 지정합니다.

2. 가상 머신 구성을 적용합니다.

   $ oc apply -f <vm_sriov>.yaml 

   1

   Copy to Clipboard Toggle word wrap

   1

   가상 머신 YAML 파일의 이름입니다.