27711777d6
Explicitly set type for integer environment variables: * VAGRANT_KURYR_VM_MEMORY * VAGRANT_KURYR_VM_CPUS Despite there is a fix in the Vagrant git repo for that issue, still exist systems where the issue is not fixed. On those systems trying to limit the VM memory one will get «no implicit conversion of String into Integer». Thus convert the environment variables to int explicitly. Change-Id: I80a39e0b072159b601dd8cadf839e596ea64e644 Bug-Url: https://github.com/vagrant-libvirt/vagrant-libvirt/issues/525 Bug-Url: https://github.com/vagrant-libvirt/vagrant-libvirt/pull/526 |
||
|---|---|---|
| contrib | ||
| devstack | ||
| doc | ||
| etc | ||
| init | ||
| kuryr | ||
| rally-jobs | ||
| releasenotes/notes | ||
| scripts | ||
| tools | ||
| usr/libexec/kuryr | ||
| __init__.py | ||
| .coveragerc | ||
| .gitignore | ||
| .gitreview | ||
| .testr.conf | ||
| babel.cfg | ||
| CONTRIBUTING.rst | ||
| HACKING.rst | ||
| LICENSE | ||
| MANIFEST.in | ||
| README.rst | ||
| requirements.txt | ||
| setup.cfg | ||
| setup.py | ||
| test-requirements.txt | ||
| tox.ini | ||
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.
- Free software: Apache license
- Documentation: http://docs.openstack.org/developer/kuryr
- Source: http://git.openstack.org/cgit/openstack/kuryr
- Bugs: http://bugs.launchpad.net/kuryr
Features
- TODO
Prerequisites
$ sudo pip install -r requirements.txtInstalling Kuryr's libnetwork driver
Running the following will grab the requirements and install kuryr
$ sudo pip install .Configuring Kuryr
Generate sample config, etc/kuryr.conf.sample, running the following
$ tox -e genconfigRename and copy config file at required path
$ cp etc/kuryr.conf.sample /etc/kuryr/kuryr.confEdit 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_PASSWORDIn the same file uncomment the bindir parameter with the path for the Kuryr vif binding executables:
bindir = /usr/local/libexec/kuryrRunning Kuryr
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.shAfter the booting, please restart your Docker service, e.g.,
$ sudo service docker restartThe 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.
Testing Kuryr
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 kuryrTo test it with tox:
$ toxYou can also run specific test cases using the -e flag,
e.g., to only run the fullstack test case.
$ tox -e fullstackGenerating Documentation
We use Sphinx to maintain the documentation. You can install Sphinx using pip.
$ pip install -U SphinxIn addition to Sphinx you will also need the following requirements (not covered by requirements.txt):
$ pip install oslosphinx 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 htmlNow you can serve the documentation at http://localhost:8080 as a simple website.
$ cd build/html
$ python -m SimpleHTTPServer 8080