From 6017d11e4886fd881fc97c4fe87383bc4917f266 Mon Sep 17 00:00:00 2001 From: chenxing Date: Mon, 4 Jun 2018 19:38:17 +0800 Subject: [PATCH] Document the China registry mirror Kolla always fails to pull kolla images. This patch is to document how to use the China registry mirror to avoid the failure of pulling kolla images. Change-Id: Ib31b3ee6183c12467df4f28f8dff438ed6e9d41c --- doc/source/user/troubleshooting.rst | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/doc/source/user/troubleshooting.rst b/doc/source/user/troubleshooting.rst index a4f7accf82..81c26a95f4 100644 --- a/doc/source/user/troubleshooting.rst +++ b/doc/source/user/troubleshooting.rst @@ -10,6 +10,24 @@ Failures If Kolla fails, often it is caused by a CTRL-C during the deployment process or a problem in the ``globals.yml`` configuration. +.. note:: + + In some countries like China, Kolla might fail due to unable to pull images + from `Docker Hub `__. There is a workround + to solve this issue: + + .. code-block:: console + + mkdir -p /etc/docker + tee /etc/docker/daemon.json <<-'EOF' + { + "registry-mirrors": ["https://registry.docker-cn.com"] + } + EOF + systemctl restart docker + + .. end + To correct the problem where Operators have a misconfigured environment, the Kolla community has added a precheck feature which ensures the deployment targets are in a state where Kolla may deploy to them. To