travelping / cni-installer

A docker image to install CNI plugins

CNI Installer

A docker image to install CNI plugins.

Plugins

The following plugins are available:

• Standard CNI plugins v0.8.3
  • bandwidth
  • bridge
  • dhcp
  • firewall
  • flannel
  • host-device
  • host-local
  • ipvlan
  • loopback
  • macvlan
  • portmap
  • ptp
  • sbr
  • static
  • tuning
  • vlan

Install

The container supports the installation of CNI plugin binaries as well as a creation of CNI configuration files.

You can deploy the intaller in Kubernetes via DaemonSet using the declaration in cni-installer-daemonset.yaml.

Plugins

When the container is started, CNI plugins are installed to the directory specified via the environment variable INSTALL_DIR, which defaults to /opt/cni/bin/. This directory is supposed to be mounted into the container.

To just install a subset of plugins, pass the environment variable PLUGINS to the container with a space-separated list of plugins:

docker run --rm -v /opt/cni/bin:/opt/cni/bin -e PLUGINS="ipvlan multus" travelping/cni-installer

Configuration

Configuration file templates can be passed to the container via a mounted directory ($CONF_TEMPLATE_DIR, default: /config/). For each file in that directory, the installer does a simple environment variable replacement and writes the result to the $CONF_DIR (default: /ent/cni/net.d/).

$ cat cni-templates/05-ipvlan.conf
{
        "name": "mynet",
        "type": "ipvlan",
        "master": "$DEV_MASTER",
        "ipam": {
                "type": "host-local",
                "subnet": "$SUBNET"
        }
}

$ docker run --rm -v /etc/cni/net.d:/etc/cni/net.d -v `pwd`/cni-templates:/config -e PLUGINS="ipvlan multus" -e "DEV_MASTER=eth2" -e "SUBNET=172.19.2.0/24" travelping/cni-installer
Installing ipvlan
Installing multus


###### /etc/cni/net.d/05-ipvlan.conf ######
{
        "name": "mynet",
        "type": "ipvlan",
        "master": "eth2",
        "ipam": {
                "type": "host-local",
                "subnet": "172.19.2.0/24"
        }
}
###############

Options

Infinite sleep

If you pass sleep as argument to the container, it will go to infinite sleep after execution.