Skip to main content

​
Configuring Network Device Using Device Selector

deviceSelector is an alternative method of configuring a network device:
Selector has the following traits:
  • qualifiers match a device by reading the hardware information in /sys/class/net/...
  • qualifiers are applied using logical AND
  • machine.network.interfaces.deviceConfig option is mutually exclusive with machine.network.interfaces.interface
  • if the selector matches multiple devices, the controller will apply config to all of them
The available hardware information used in the selector can be observed in the LinkStatus resource (works in maintenance mode):
The following qualifiers are available:
  • driver - matches a device by its driver name
  • hardwareAddr - matches a device by its hardware address
  • permanentAddr - matches a device by its permanent hardware address
  • busPath - matches a device by its PCI bus path
  • pciID - matches a device by its PCI vendor and device ID
  • physical - matches only physical devices (vs. virtual devices, e.g. bonds and VLANs)
All qualifiers except for physical support wildcard matching using * character.

​
Using Device Selector for Bonding

Device selectors can be used to configure bonded interfaces:
In this example, the bond0 interface will be created and bonded using two devices with the specified hardware addresses. For bonding, use permanentAddr instead of hardwareAddr to match the permanent hardware address of the device, as hardwareAddr might change as the link becomes part of the bond.