openstack/kolla-ansible
Code Issues Proposed changes

update doc about how to set up local registry

Browse Source 
Update document about how to set up local registry.

Change-Id: I52895e2416a219e1dfaf2e493eac857598f9c819
Closes-Bug: #1459355
This commit is contained in:
Kuo-tung Kao 2015-10-06 16:34:20 +08:00 committed by Kuo-tung Kao
parent f9d9abd408
commit 32d0e4ef2d
1 changed files with 46 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

46
doc/image-building.rst
View File

@ -122,4 +122,50 @@ Known issues
Get more information about the issue from DockerBug_.
Setting up Docker local registry
--------------------------------
It is recommended to set up local registry for Kolla developers
or deploying multinode. The reason using a local registry is
deployment performance will operate at local network speeds,
typically gigabit networking. Beyond performance considerations,
the Operator would have full control over images that are deployed.
If there is no local registry, nodes pull images from Docker Hub
when images are not found in local caches.
Running Docker registry is easy. Just use the following command:
::
docker run -d -p 4000:5000 --restart=always --name registry registry
The default port of Docker registry is 5000.
But the 5000 port is also the port of keystone-api.
To avoid conflict, use 4000 port as Docker registry port.
Now the Docker registry service is running.
For docker to pull images, it is necessary to
modify the Docker configuration. The guide assumes that
the IP of the machine running Docker registry is 172.22.2.81.
In Ubuntu, add ``--insecure-registry 172.22.2.81:4000``
to ``DOCKER_OPTS`` in ``/etc/default/docker``.
In CentOS, uncomment ``INSECURE_REGISTRY`` and set ``INSECURE_REGISTRY``
to ``--insecure-registry 172.22.2.81:4000`` in ``/etc/sysconfig/docker``.
And restart the docker service.
To build and push images to local registry, use the following command:
::
tools/build.py --namespace 172.22.2.81:4000 --push
To make kolla-ansible pull images from local registry, set
``"docker_registry"`` to ``"172.22.2.81:4000"`` in
``"/etc/kolla/globals.yml"``.
.. _DockerBug: https://github.com/docker/docker/issues/6980