openstack/kolla-ansible
Code Issues Proposed changes
077995916a
kolla-ansible/doc/source/reference/kuryr-guide.rst
chenxing c2d54b9737 Upgrade the rst convention of the Reference Guide [2] 
We upgrade the rst convention by following Documentation Contributor
Guide[1].

[1] https://docs.openstack.org/doc-contrib-guide

Change-Id: I825deadefcf996732a03e61c8fd19cfd6a498e77
Partially-Implements: blueprint optimize-the-documentation-format
2018-03-17 09:44:25 +00:00

1.7 KiB
Raw Blame History

Kuryr in Kolla

"Kuryr is a Docker network plugin that uses Neutron to provide networking services to Docker containers. It provides containerized images for the common Neutron plugins. Kuryr requires at least Keystone and neutron. Kolla makes kuryr deployment faster and accessible.

Requirements

  • A minimum of 3 hosts for a vanilla deploy

Preparation and Deployment

To allow Docker daemon connect to the etcd, add the following in the docker.service file.

ExecStart= -H tcp://172.16.1.13:2375 -H unix:///var/run/docker.sock --cluster-store=etcd://172.16.1.13:2379 --cluster-advertise=172.16.1.13:2375

The IP address is host running the etcd service. `2375 is port that allows Docker daemon to be accessed remotely. 2379` is the etcd listening port.

By default etcd and kuryr are disabled in the group_vars/all.yml. In order to enable them, you need to edit the file globals.yml and set the following variables

enable_etcd: "yes"
enable_kuryr: "yes"

Deploy the OpenStack cloud and kuryr network plugin

kolla-ansible deploy

Create a Virtual Network

docker network create -d kuryr --ipam-driver=kuryr --subnet=10.1.0.0/24 --gateway=10.1.0.1 docker-net1

To list the created network:

docker network ls

The created network is also available from OpenStack CLI:

openstack network list

For more information about how kuryr works, see kuryr (OpenStack Containers Networking).