diff options
| author | Kuo-tung Kao <coding1314@gmail.com> | 2015-10-06 16:34:20 +0800 |
|---|---|---|
| committer | Kuo-tung Kao <jelly.k@inwinstack.com> | 2015-10-07 11:48:43 +0800 |
| commit | 32d0e4ef2d654a45c1998360627f6532d8d87f1d (patch) | |
| tree | b708190e70fbedaebca1944b8dfddf9af02ba7b3 /doc | |
| parent | f9d9abd408d0009f63ecae82491defeebf5b36d4 (diff) | |
| download | kolla-32d0e4ef2d654a45c1998360627f6532d8d87f1d.tar.gz kolla-32d0e4ef2d654a45c1998360627f6532d8d87f1d.zip | |
update doc about how to set up local registry
Update document about how to set up local registry.
Change-Id: I52895e2416a219e1dfaf2e493eac857598f9c819
Closes-Bug: #1459355
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/image-building.rst | 46 |
1 files changed, 46 insertions, 0 deletions
diff --git a/doc/image-building.rst b/doc/image-building.rst index e7008db59..4da8c0f84 100644 --- a/doc/image-building.rst +++ b/doc/image-building.rst @@ -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 |