openstack/kolla
Code Issues Proposed changes

Fix docs to require docker config on all nodes

Browse Source 
Change-Id: I31d8007ed01dbb621b1379c164d075a6d70674f1
This commit is contained in:
Steven Dake 2016-10-02 11:11:02 -07:00
parent b18653d98f
commit 65f85682aa
1 changed files with 22 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

29
doc/multinode.rst
View File

@ -6,20 +6,35 @@ Multinode Deployment of Kolla
.. _deploy_a_registry: .. _deploy_a_registry:
Deploy a registry (required for multinode) Deploy a registry
========================================== =================
A Docker registry is a locally hosted registry that replaces the need to pull A Docker registry is a locally hosted registry that replaces the need to pull
from the Docker Hub to get images. A local registry is required for a multinode from the Docker Hub to get images. Kolla can function with or without a local
Kolla deployment. registry, however for a multinode deployment some type of registry is mandatory.
Only one registry must be deployed, although HA features exist for registry
services.
The Docker registry prior to version 2.3 has extremely bad performance because
all container data is pushed for every image rather than taking advantage of
Docker layering to optimize push operations. For more information reference
`pokey registry <https://github.com/docker/docker/issues/14018>`__.
The Kolla community recommends using registry 2.3 or later. To deploy registry The Kolla community recommends using registry 2.3 or later. To deploy registry
with version greater than 2.3, do the following: with version 2.3 or later, do the following:
:: ::
tools/start-registry tools/start-registry
.. _configure_docker_all_nodes:
Configure Docker on all nodes
=============================
.. note:: As the subtitle for this section implies, these steps should be
applied to all nodes, not just the deployment node.
After starting the registry, it is necessary to instruct Docker that it will After starting the registry, it is necessary to instruct Docker that it will
be communicating with an insecure registry. To enable insecure registry be communicating with an insecure registry. To enable insecure registry
communication on CentOS, modify the ``/etc/sysconfig/docker`` file to contain communication on CentOS, modify the ``/etc/sysconfig/docker`` file to contain
@ -88,8 +103,8 @@ Edit the Inventory File
The ansible inventory file contains all the information needed to determine The ansible inventory file contains all the information needed to determine
what services will land on which hosts. Edit the inventory file in the kolla what services will land on which hosts. Edit the inventory file in the kolla
directory ``ansible/inventory/multinode`` or if kolla was installed with pip, directory ``ansible/inventory/multinode``. If kolla was installed with pip,
it can be found in ``/usr/share/kolla``. the inventory file can be found in ``/usr/share/kolla``.
Add the ip addresses or hostnames to a group and the services associated with Add the ip addresses or hostnames to a group and the services associated with
that group will land on that host: that group will land on that host: