1
0
mirror of https://github.com/openshift/openshift-docs.git synced 2026-02-05 12:46:18 +01:00
Files
openshift-docs/modules/nw-sriov-device-discovery.adoc
2025-10-30 06:31:40 +00:00

84 lines
2.3 KiB
Plaintext

// Module included in the following assemblies:
//
// * networking/hardware_networks/about-sriov.adoc
// * virt/vm_networking/virt-connecting-vm-to-sriov.adoc
:_mod-docs-content-type: REFERENCE
[id="discover-sr-iov-devices_{context}"]
= Automated discovery of SR-IOV network devices
The SR-IOV Network Operator searches your cluster for SR-IOV capable network devices on worker nodes.
The Operator creates and updates a SriovNetworkNodeState custom resource (CR) for each worker node that provides a compatible SR-IOV network device.
The CR is assigned the same name as the worker node.
The `status.interfaces` list provides information about the network devices on a node.
[IMPORTANT]
====
Do not modify a `SriovNetworkNodeState` object.
The Operator creates and manages these resources automatically.
====
[id="example-sriovnetworknodestate_{context}"]
== Example SriovNetworkNodeState object
The following YAML is an example of a `SriovNetworkNodeState` object created by the SR-IOV Network Operator:
.An SriovNetworkNodeState object
[source,yaml]
----
apiVersion: sriovnetwork.openshift.io/v1
kind: SriovNetworkNodeState
metadata:
name: node-25 <1>
namespace: openshift-sriov-network-operator
ownerReferences:
- apiVersion: sriovnetwork.openshift.io/v1
blockOwnerDeletion: true
controller: true
kind: SriovNetworkNodePolicy
name: default
spec:
dpConfigVersion: "39824"
status:
interfaces: <2>
- deviceID: "1017"
driver: mlx5_core
mtu: 1500
name: ens785f0
pciAddress: "0000:18:00.0"
totalvfs: 8
vendor: 15b3
- deviceID: "1017"
driver: mlx5_core
mtu: 1500
name: ens785f1
pciAddress: "0000:18:00.1"
totalvfs: 8
vendor: 15b3
- deviceID: 158b
driver: i40e
mtu: 1500
name: ens817f0
pciAddress: 0000:81:00.0
totalvfs: 64
vendor: "8086"
- deviceID: 158b
driver: i40e
mtu: 1500
name: ens817f1
pciAddress: 0000:81:00.1
totalvfs: 64
vendor: "8086"
- deviceID: 158b
driver: i40e
mtu: 1500
name: ens803f0
pciAddress: 0000:86:00.0
totalvfs: 64
vendor: "8086"
syncStatus: Succeeded
----
<1> The value of the `name` field is the same as the name of the worker node.
<2> The `interfaces` stanza includes a list of all of the SR-IOV devices discovered by the Operator on the worker node.