Allow multiple binding drivers
In before, only one binding driver is allowed. This patch introduces a new config to support multiple binding drivers. The first use case is to allow SR-IOV binding to be co-existed with other binding. * Rename the config 'driver' to 'default_driver' in 'binding' group. This is for making it clear that it is allowed to have more than one type of bindings. * Introduce a new config called 'enabled_drivers'. * Allow client to pass a driver name to port_bind and port_unbind. If this parameter is None, kuryr will load the default driver. Partial-Implements: blueprint sriov-binding Change-Id: I14b23379de9f2459ba97d5d82dfdb51553370cb1
|1 year ago|
|contrib/busybox||2 years ago|
|doc||1 year ago|
|etc||2 years ago|
|kuryr||1 year ago|
|releasenotes||1 year ago|
|tools||2 years ago|
|usr/libexec/kuryr||2 years ago|
|.coveragerc||2 years ago|
|.gitignore||2 years ago|
|.gitreview||3 years ago|
|.testr.conf||3 years ago|
|CONTRIBUTING.rst||3 years ago|
|HACKING.rst||1 year ago|
|LICENSE||3 years ago|
|README.rst||1 year ago|
|__init__.py||2 years ago|
|babel.cfg||3 years ago|
|requirements.txt||1 year ago|
|setup.cfg||1 year ago|
|setup.py||2 years ago|
|test-requirements.txt||1 year ago|
|tox.ini||2 years ago|
Docker for OpenStack Neutron
Kuryr is a Docker network plugin that uses Neutron to provide networking services to Docker containers. It provides containerised images for the common Neutron plugins.
$ git clone https://git.openstack.org/openstack/kuryr.git $ cd kuryr
$ sudo pip install -r requirements.txt
For kuryr-libnetwork driver installation refer:
Generate sample config, etc/kuryr.conf.sample, running the following
$ tox -e genconfig
Rename and copy config file at required path
$ cp etc/kuryr.conf.sample /etc/kuryr/kuryr.conf
Edit keystone section in /etc/kuryr/kuryr.conf, replace ADMIN_PASSWORD:
auth_uri = http://127.0.0.1:35357/v2.0 admin_user = admin admin_tenant_name = service admin_password = ADMIN_PASSWORD
In the same file uncomment the bindir parameter with the path for the Kuryr vif binding executables:
bindir = /usr/local/libexec/kuryr
By default, Kuryr will use veth pairs for performing the binding. However, the Kuryr library ships with two other drivers that you can configure in the binding section:
[binding] #driver = kuryr.lib.binding.drivers.ipvlan #driver = kuryr.lib.binding.drivers.macvlan
Drivers may make use of other binding options. Both Kuryr library drivers in the previous snippet can be further configured setting the interface that will act as link interface for the virtual devices:
link_iface = enp4s0
Currently, Kuryr utilizes a bash script to start the service. Make sure that you have installed tox before the execution of the below command.
$ sudo ./scripts/run_kuryr.sh
After the booting, please restart your Docker service, e.g.,
$ sudo service docker restart
The bash script creates the following file if it is missing.
/usr/lib/docker/plugins/kuryr/kuryr.json: Json spec file for libnetwork.
Note the root privilege is required for creating and deleting the veth pairs with pyroute2 to run.
For a quick check that Kuryr is working create a network:
$ docker network create --driver kuryr test_net 785f8c1b5ae480c4ebcb54c1c48ab875754e4680d915b270279e4f6a1aa52283 $ docker network ls NETWORK ID NAME DRIVER 785f8c1b5ae4 test_net kuryr
To test it with tox:
You can also run specific test cases using the
-e flag, e.g., to only run the fullstack test case.
$ tox -e fullstack
We use Sphinx to maintain the documentation. You can install Sphinx using pip.
$ pip install -U Sphinx
In addition to Sphinx you will also need the following requirements (not covered by requirements.txt):
$ pip install openstackdocstheme reno 'reno[sphinx]'
The source code of the documentation are under doc, you can generate the html files using the following command. If the generation succeeds,a build/html dir will be created under doc.
$ cd doc $ make html
Now you can serve the documentation at http://localhost:8080 as a simple website.
$ cd build/html $ python -m SimpleHTTPServer 8080