Bridge between container framework networking and storage models to OpenStack networking and storage abstractions.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
Fawad Khaliq 894d2b7313 Add PLUMgrid/IOvisor binding for Kuryr 7 years ago
contrib/vagrant Virtualbox now uses 'ubuntu/trusty64' instead of 'trusty' 7 years ago
devstack Renaming service from docker-engine to docker to fix 'vagrant up' 7 years ago
doc Merge "Adjust underline length and change default scope to local" 7 years ago
etc Correct location of auto-generated config file 7 years ago
init Add upstart config file 7 years ago
kuryr Expose additional vif params to bind/unbind scripts 7 years ago
rally-jobs Add the kuryr plugin for rally 7 years ago
releasenotes/notes Use reno for release notes 7 years ago
scripts Completing the basic configuration for Kuryr 7 years ago
tools Make sure correct branch of Neutron is pulled on testing 7 years ago
usr/libexec/kuryr Add PLUMgrid/IOvisor binding for Kuryr 7 years ago
.coveragerc Exclude tests from coverage 7 years ago
.gitignore Allow for user specified local.conf changes with Vagrant 7 years ago
.gitreview Added .gitreview 8 years ago
.testr.conf Separate unit tests from fullstack tests 7 years ago
CONTRIBUTING.rst Initial template commit 8 years ago
HACKING.rst Initial template commit 8 years ago
LICENSE Initial template commit 8 years ago
MANIFEST.in Remove 'MANIFEST.in' 7 years ago
README.rst Merge "Fixed typo in README.rst" 7 years ago
__init__.py Add entrypoint of Kuryr 7 years ago
babel.cfg Initial template commit 8 years ago
requirements.txt Updated from global requirements 7 years ago
setup.cfg Remove support for Python 3.3 7 years ago
setup.py Updated from global requirements 7 years ago
test-requirements.txt Updated from global requirements 7 years ago
tox.ini Merge "Support py34 in Kuryr" 7 years ago

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