openstack/kuryr
Code Issues Proposed changes
Bridge between container framework networking and storage models to OpenStack networking and storage abstractions.
312 Commits 10 Branches 17 Tags 10 MiB
Python 91.5%
Shell 8.5%
811de8e9ab
Go to file
Mohammad Banikazemi 811de8e9ab Make use of one instance of IPDB 
Creating an instance of IPDB for each use of binding, has a
significant impact on the scalability of Kuryr. As the number of
containers on a host increases, the cost of attaching a container to a
network increases rapidly. This patch, fixes the problem.

Change-Id: Id7dff9348acd36481146e4edfba8f92cff040ced
Closes-Bug: #1539252
2016-02-15 12:27:46 -05:00
contrib/vagrant Fix invalid url 2016-01-29 21:35:15 +08:00
devstack devstack: Workaround shebang insanities 2016-02-09 11:26:56 -06:00
doc Fix term inside the spec 2016-01-25 10:58:56 +08:00
etc Correct location of auto-generated config file 2015-12-03 11:46:08 -05:00
kuryr Make use of one instance of IPDB 2016-02-15 12:27:46 -05:00
rally-jobs Add rally integration point 2015-12-10 07:33:55 +00:00
releasenotes/notes Use reno for release notes 2015-12-14 09:41:51 -06:00
scripts Completing the basic configuration for Kuryr 2015-12-07 09:35:26 -05:00
tools Make sure correct branch of Neutron is pulled on testing 2015-12-12 20:12:34 +02:00
usr/libexec/kuryr Fix the unbind_port method in libexec of ovs. 2015-12-21 05:12:57 -08:00
__init__.py Add entrypoint of Kuryr 2015-07-27 19:40:49 +09:00
.coveragerc Exclude tests from coverage 2015-10-08 21:37:54 +09:00
.gitignore Allow for user specified local.conf changes with Vagrant 2015-12-28 15:34:18 -06:00
.gitreview Added .gitreview 2015-07-14 18:00:33 +00:00
.testr.conf Separate unit tests from fullstack tests 2015-12-08 09:08:04 +02:00
babel.cfg Initial template commit 2015-07-15 10:00:44 +03:00
CONTRIBUTING.rst Initial template commit 2015-07-15 10:00:44 +03:00
HACKING.rst Initial template commit 2015-07-15 10:00:44 +03:00
LICENSE Initial template commit 2015-07-15 10:00:44 +03:00
MANIFEST.in Remove 'MANIFEST.in' 2016-01-25 14:46:06 +08:00
README.rst Merge "Fixed typo in README.rst" 2016-02-09 04:04:29 +00:00
requirements.txt requirements: neutronclient subnetpool support 2016-01-30 21:50:48 +01:00
setup.cfg Use uppercase 'S' in word "OpenStack" 2016-02-04 19:56:34 +05:30
setup.py Initial template commit 2015-07-15 10:00:44 +03:00
test-requirements.txt Add debug testenv in tox 2016-01-18 14:29:16 +08:00
tox.ini Merge "Support py34 in Kuryr" 2016-02-10 06:58:40 +00:00

README.rst

kuryr

Kuryr

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.

Features

  • TODO

Prerequisites

$ sudo pip install -r requirements.txt

Running Kuryr

Please run the following script, it creates /usr/lib/docker/plugins/kuryr and the JSON spec file, /usr/lib/docker/plugins/kuryr/kuryr.json, if they don't exist. Kuryr requires the root privilege for creating and deleting the veth pairs with pyroute2 to run.

$ sudo ./scripts/run_kuryr.sh

Testing Kuryr

$ tox

You can also run specific test cases using the -e flag, e.g., to only run the fullstack test case.

$ tox -e fullstack

Generate Documentation

We use Sphinx to maintain the documentation. You can install Sphinx using pip.

$ pip install -U 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