From 29475196585e8952a9e0469cfc33f1dbc7ddb266 Mon Sep 17 00:00:00 2001 From: Sayantani Goswami Date: Mon, 30 Jan 2017 17:26:15 +0000 Subject: [PATCH] Fix pushing images to local registry documentation Adding -e REGISTRY_PROXY_REMOTEURL=https://registry-1.docker.io to the docker run command in the start-registry script configures the local registry as a pull through cache. However, pushing of images to the local registry fails. Pushing to a registry configured as a pull-through cache is unsupported. For more information, reference the proxy section in Docker Documentation (https://docs.docker.com/registry/configuration/) The start_registry script has been updated in the patch set https://review.openstack.org/#/c/426338/ Change-Id: If62b40d8316af7c3593523493cad8a904d35dceb --- doc/multinode.rst | 20 ++++++++++++++++---- 1 file changed, 16 insertions(+), 4 deletions(-) diff --git a/doc/multinode.rst b/doc/multinode.rst index 6b4d82524b..6a9fca80b3 100644 --- a/doc/multinode.rst +++ b/doc/multinode.rst @@ -27,6 +27,22 @@ with version 2.3 or later, do the following: tools/start-registry +The Docker registry can be configured as a pull through cache to proxy the +official Kolla images hosted in Docker Hub. In order to configure the local +registry as a pull through cache, in the host machine set the environment +variable ``REGISTRY_PROXY_REMOTEURL`` to the URL for the repository on +Docker Hub. + +:: + + export REGISTRY_PROXY_REMOTEURL=https://registry-1.docker.io + +.. note:: + + Pushing to a registry configured as a pull-through cache is unsupported. + For more information, Reference the `Docker Documentation + `__. + .. _configure_docker_all_nodes: Configure Docker on all nodes @@ -35,10 +51,6 @@ 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. -The ``start-registry`` script configures a docker registry that proxies Kolla -images from Docker Hub, and can also be used with custom built images (see -`Building Container Images`_). - After starting the registry, it is necessary to instruct Docker that it will be communicating with an insecure registry. To enable insecure registry communication on CentOS, modify the ``/etc/sysconfig/docker`` file to contain