diff options
Diffstat (limited to 'doc/multinode.rst')
| -rw-r--r-- | doc/multinode.rst | 21 |
1 files changed, 7 insertions, 14 deletions
diff --git a/doc/multinode.rst b/doc/multinode.rst index 6383da9d6..2a003b4bd 100644 --- a/doc/multinode.rst +++ b/doc/multinode.rst @@ -4,28 +4,21 @@ Multinode Deployment of Kolla ============================= +.. _deploy_a_registry: + Deploy a registry (required for multinode) ========================================== A Docker registry is a locally hosted registry that replaces the need to pull -from the Docker Hub to get images. Kolla can function with or without a local -registry, however for a multinode deployment a registry is required. - -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>`__. - +from the Docker Hub to get images. A local registry is required for a multinode +Kolla deployment. The Kolla community recommends using registry 2.3 or later. To deploy registry with version greater than 2.3, do the following: :: - docker run -d -p 4000:5000 --restart=always --name registry registry:2 - -.. note:: Kolla looks for the Docker registry to use port 4000. (Docker default is - port 5000) + tools/start-registry After starting the registry, it is necessary to instruct Docker that it will be communicating with an insecure registry. To enable insecure registry @@ -36,7 +29,7 @@ registry is currently running: :: # CentOS - INSECURE_REGISTRY="--insecure-registry 192.168.1.100:4000" + INSECURE_REGISTRY="--insecure-registry 192.168.1.100:5000" For Ubuntu, check whether its using upstart or systemd. @@ -50,7 +43,7 @@ Edit ``/etc/default/docker`` and add: :: # Ubuntu - DOCKER_OPTS="--insecure-registry 192.168.1.100:4000" + DOCKER_OPTS="--insecure-registry 192.168.1.100:5000" If Ubuntu is using systemd, additional settings needs to be configured. Copy docker's systemd unit file to ``/etc/systemd/system/`` directory: |