Connecting a virtual machine to an SR-IOV network

Create an SriovNetworkNodePolicy object, and then save the YAML in the <name>-sriov-node-network.yaml file. Replace <name> with the name for this configuration.

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)

Optional: Label the SR-IOV capable cluster nodes with SriovNetworkNodePolicy.Spec.NodeSelector if they are not already labeled. For more information about labeling nodes, see "Understanding how to update labels on nodes".

Create the SriovNetworkNodePolicy object:

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

To verify that the SR-IOV network device is configured, enter the following command. Replace <node_name> with the name of a node with the SR-IOV network device that you just configured.

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

Create the following SriovNetwork object, and then save the YAML in the <name>-sriov-network.yaml file. Replace <name> with a name for this additional network.

To create the object, enter the following command. Replace <name> with a name for this additional network.

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

Optional: To confirm that the NetworkAttachmentDefinition object associated with the SriovNetwork object that you created in the previous step exists, enter the following command. Replace <namespace> with the namespace you specified in the SriovNetwork object.

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

Add the SR-IOV network details to the spec.domain.devices.interfaces and spec.networks stanzas of the VM configuration as in the following example:

apiVersion: kubevirt.io/v1
kind: VirtualMachine
metadata:
  name: example-vm
spec:
  domain:
    devices:
      interfaces:
      - name: nic1 (1)
        sriov: {}
  networks:
  - name: nic1 (2)
    multus:
        networkName: sriov-network (3)
# ...

Apply the virtual machine configuration:

$ oc apply -f <vm_sriov>.yaml (1)

Navigate to Virtualization → VirtualMachines.

Click a VM to view the VirtualMachine details page.

On the Configuration tab, click the Network interfaces tab.

Click Add network interface.

Enter the interface name.

Select an SR-IOV network attachment definition from the Network list.

Select SR-IOV from the Type list.

Optional: Add a network Model or Mac address.

Click Save.

Restart or live-migrate the VM to apply the changes.