Sign inSign up

ovnworks/docker-ovn-driver

By ovnworks

Updated almost 8 years ago

Docker Plugin v2 Network Driver for Open Virtual Network (OVN).

Plugin
0

1.7K

ovnworks/docker-ovn-driver repository overview

GitHub Repository: https://github.com/ovnworks/docker-ovn-driver

docker-ovn-driver

Docker Plugin v2 Network Driver for Open Virtual Network (OVN).

Getting Started

Install the driver from Docker Hub

First, install the driver:

docker plugin install ovnworks/docker-ovn-driver --disable --grant-all-permissions
latest: Pulling from ovnworks/docker-ovn-driver
cf67279099ab: Download complete
Digest: sha256:0fafc210877961449d790b63e0ba61ffa2cda7c999acb102790903d642199455
Status: Downloaded newer image for ovnworks/docker-ovn-driver:latest
Installed plugin ovnworks/docker-ovn-driver

Validate that the driver is installed but disables:

docker plugin ls
ID                  NAME                                DESCRIPTION                                     ENABLED
759fb140951d        ovnworks/docker-ovn-driver:latest   Docker network driver for Open Virtual Net...   false

Next, if necessary, enable debugging:

docker plugin set ovnworks/docker-ovn-driver DEBUG=1

Finally, enable the driver:

docker plugin enable ovnworks/docker-ovn-driver

Validate that the driver is installed and enabled:

docker plugin ls
ID                  NAME                                DESCRIPTION                                     ENABLED
759fb140951d        ovnworks/docker-ovn-driver:latest   Docker network driver for Open Virtual Net...   true
Install the driver from source

The following command builds, installs, and enabled the driver locally, i.e. without a registry:

sudo make plugin

Create a network

Create a network with the networking maintained by ovnworks/docker-ovn-driver network driver:

docker network create -d ovnworks/docker-ovn-driver:latest --subnet=10.10.10.0/23 --gateway=10.10.10.1 --ip-range 10.10.10.32/27 public

Uninstall the driver

The following commands disable and remove the driver:

docker plugin disable ovnworks/docker-ovn-driver
docker plugin rm ovnworks/docker-ovn-driver

Alternatively, when having access to the source, run the following command:

sudo make clean

Troubleshooting

The driver requires that the following command succeeds prior to enabling the driver:

ovs-vsctl --timeout=5 -vconsole:off get Open_vSwitch . external_ids:ovn-nb

The following curl queries the state of the network driver:

curl http://0.0.0.0:9105/NetworkDriver.Database

The following command allows read/write access to Docker interface by greenpau user:

sudo setfacl -m user:greenpau:rw /var/run/docker.sock

Reference:

Also, note that the plugin includes the following openvswitch packages:

  • openvswitch-<VERSION>.el7.x86_64.rpm
  • openvswitch-ovn-common-<VERSION>.el7.x86_64.rpm
  • python-openvswitch-<VERSION>.el7.noarch.rpm

Tag summary

Content type

Plugin

Digest

Size

121.5 MB

Last updated

almost 8 years ago

docker plugin install ovnworks/docker-ovn-driver