On this page:

You are viewing documentation for CNI version: v0.7

CNI v0.7 documentation is no longer actively maintained. The version you are currently viewing is a static snapshot. For up-to-date documentation, see the latest release, v1.1, or the current documentation.

host-device

plugins/main/host-device/README.md

Move an already-existing device in to a container.

This simple plugin will move the requested device from the host’s network namespace to the container’s. Nothing else will be done - no IPAM, no addresses.

The device can be specified with any one of three properties:

  • device: The device name, e.g. eth0, can0
  • hwaddr: A MAC address
  • kernelpath: The kernel device kobj, e.g. /sys/devices/pci0000:00/0000:00:1f.6

For this plugin, CNI_IFNAME will be ignored. Upon DEL, the device will be moved back.

A sample configuration might look like:

{
	"cniVersion": "0.3.1",
	"device": "enp0s1"
}