diff options
| author | Kuo-tung Kao <ya790206@gmail.com> | 2015-10-07 20:27:49 +0800 |
|---|---|---|
| committer | Kuo-tung Kao <jelly.k@inwinstack.com> | 2015-10-08 13:51:40 +0800 |
| commit | 08b93d1d85f341edf5f3d383ec689d5f3f63f553 (patch) | |
| tree | 38de7b0533df86f0a0de98df698f7df07fecdbaa /doc | |
| parent | 05764198a2045e5d8516117ada833630ae5d892c (diff) | |
| download | kolla-08b93d1d85f341edf5f3d383ec689d5f3f63f553.tar.gz kolla-08b93d1d85f341edf5f3d383ec689d5f3f63f553.zip | |
update doc about local registry in image-building
Reformat local registry section. And document that the Docker config need to
be modified when building images if using local registry.
Change-Id: I51c4df499d84c8ce2a2afc3787b2d609cc0f7d7e
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/image-building.rst | 30 |
1 files changed, 27 insertions, 3 deletions
diff --git a/doc/image-building.rst b/doc/image-building.rst index 4da8c0f84..98758ddb7 100644 --- a/doc/image-building.rst +++ b/doc/image-building.rst @@ -56,6 +56,19 @@ want to push images to your dockerhub, change the namespace like: $ tools/build.py -n yourusername --push +To push images to local registry, change the namespace, too. If the ip +of the machine running local registry is ``172.22.2.81`` and the port +which local registry listens to is ``4000``, use the following command +to push images to local registry. + +:: + + tools/build.py --namespace 172.22.2.81:4000 --push + +To trigger buid.py to pull images from local registry, +the Docker configuration needs to be modified. See +`Docker Insecure Registry Config`_. + The build script reads its configuration from ``/etc/kolla/kolla-build.conf`` or ``etc/kolla/kolla-build.conf``. This is where to change the default settings. @@ -122,8 +135,8 @@ Known issues Get more information about the issue from DockerBug_. -Setting up Docker local registry --------------------------------- +Docker Local Registry +--------------------- It is recommended to set up local registry for Kolla developers or deploying multinode. The reason using a local registry is @@ -133,6 +146,9 @@ 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. +Setting up Docker Local Registry +++++++++++++++++++++++++++++++++ + Running Docker registry is easy. Just use the following command: :: @@ -145,6 +161,9 @@ To avoid conflict, use 4000 port as Docker registry port. Now the Docker registry service is running. +Docker Insecure Registry Config ++++++++++++++++++++++++++++++++ + 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. @@ -163,9 +182,14 @@ To build and push images to local registry, use the following command: tools/build.py --namespace 172.22.2.81:4000 --push +Kolla-ansible with Local Registry ++++++++++++++++++++++++++++++++++ + To make kolla-ansible pull images from local registry, set ``"docker_registry"`` to ``"172.22.2.81:4000"`` in -``"/etc/kolla/globals.yml"``. +``"/etc/kolla/globals.yml"``. Make sure Docker is allowed to pull +images from insecure registry. See +`Docker Insecure Registry Config`_. .. _DockerBug: https://github.com/docker/docker/issues/6980 |