openstack
/
kuryr-libnetwork
Code Issues Proposed changes
Docker remote driver for OpenStack Neutron
314 Commits 9 Branches 47 Tags 7.8 MiB
Python 96.8%
Shell 3%
Dockerfile 0.2%
Go to file
Andreas Jaeger d94b797355 Remove tox from requirements 
tox is not part of global requirements and thus the sync with
requirements repository fails. Remove tox, it's wrong to mention it, we
expect tox to be installed.

Change-Id: I562456af72fb5336789b9ca5837574712e788ab9
 		2016-02-17 09:14:33 +01: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
init Add upstart config file 2016-02-15 20:54:38 +01: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
.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
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
__init__.py Add entrypoint of Kuryr 2015-07-27 19:40:49 +09:00
babel.cfg Initial template commit 2015-07-15 10:00:44 +03:00
requirements.txt Remove tox from requirements 2016-02-17 09:14:33 +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