How to configure SR-IOV ports

How to configure SR-IOV ports

Current approach of SR-IOV relies on sriov-device-plugin [2]. While creating pods with SR-IOV, sriov-device-plugin should be turned on on all nodes. To use a SR-IOV port on a baremetal installation the 3 following steps should be done:

1. Create OpenStack network and subnet for SR-IOV. Following steps should be done with admin rights.

neutron net-create vlan-sriov-net --shared --provider:physical_network physnet10_4 --provider:network_type vlan --provider:segmentation_id 3501
neutron subnet-create vlan-sriov-net --name vlan-sriov-subnet --gateway

Subnet id <UUID of vlan-sriov-net> will be used later in NetworkAttachmentDefinition.

  1. Add sriov section into kuryr.conf.
physical_device_mappings = physnet1:ens4f0
default_physnet_subnets = physnet1:<UUID of vlan-sriov-net>

This mapping is required for ability to find appropriate PF/VF functions at binding phase. physnet1 is just an identifier for subnet <UUID of vlan-sriov-net>. Such kind of transition is necessary to support many-to-many relation.

3. Prepare NetworkAttachmentDefinition object. Apply NetworkAttachmentDefinition with “sriov” driverType inside, as described in [1].

apiVersion: ""
kind: NetworkAttachmentDefinition
    name: "sriov-net1"
    annotations: '{
        "subnetId": "UUID of vlan-sriov-net",
        "driverType": "sriov"

Then add and request/limits for SR-IOV into the pod’s yaml.

kind: Pod
  name: my-pod
  namespace: my-namespace
  annotations: sriov-net1,sriov-net2
  - name: containerName
    image: containerImage
    imagePullPolicy: IfNotPresent
    command: ["tail", "-f", "/dev/null"]
      requests: '2'
      limits: '2'

In the above example two SR-IOV devices will be attached to pod. First one is described in sriov-net1 NetworkAttachmentDefinition, second one in sriov-net2. They may have different subnetId.

Creative Commons Attribution 3.0 License

Except where otherwise noted, this document is licensed under Creative Commons Attribution 3.0 License. See all OpenStack Legal Documents.