From c60e7107fa97cf826781068ad8b8f36e3ad9c7e7 Mon Sep 17 00:00:00 2001
From: Jim Galasyn <jim.galasyn@docker.com>
Date: Thu, 22 Jun 2017 13:08:43 -0700
Subject: [PATCH] Add use case for China registry mirror (#3682)

---
 docs/recipes/mirror.md | 30 ++++++++++++++++++++++++++++++
 1 file changed, 30 insertions(+)

diff --git a/docs/recipes/mirror.md b/docs/recipes/mirror.md
index 021b7d0bd..78e4f34d4 100644
--- a/docs/recipes/mirror.md
+++ b/docs/recipes/mirror.md
@@ -100,3 +100,33 @@ to make the change persistent.
 ```
 
 Save the file and restart Docker for the change to take effect.
+
+## Use case: the China registry mirror
+
+The URL of the registry mirror for China is `registry.docker-cn.com`. You can
+pull images from this mirror just like you do for other registries by
+specifying the full path, including the registry, in your `docker pull`
+command, for example:
+
+```bash
+$ docker pull registry.docker-cn.com/library/ubuntu
+```
+
+You can configure the Docker daemon with the `--registry-mirror` startup
+parameter:
+
+```bash
+$ docker --registry-mirror=https://registry.docker-cn.com -d
+```
+
+Or you can add "https://registry.docker-cn.com" to the `registry-mirrors`
+array in `/etc/docker/daemon.json` to pull from the China registry mirror
+by default.  
+
+```json
+{
+  "registry-mirrors": ["https://registry.docker-cn.com"]
+}
+```
+
+Save the file and restart Docker for the change to take effect.
\ No newline at end of file