From 85d151718411d72391f00804c8346a676f4f5a44 Mon Sep 17 00:00:00 2001 From: Aaron Lehmann Date: Mon, 28 Mar 2016 17:10:11 -0700 Subject: [PATCH] Mention "docker login" in push/pull documentation It was suggested to me that documentation for "docker pull" and "docker push" should reference "docker login", to make clearer how to specify credentials for a push or pull operation. Add a note to the manual pages and reference documentation explaining how registry credentials are managed. Signed-off-by: Aaron Lehmann (cherry picked from commit fb5ea0c0efec238aeeff7c5c3742a0e4eccff2c7) --- docs/reference/commandline/pull.md | 2 ++ docs/reference/commandline/push.md | 2 ++ man/docker-pull.1.md | 2 ++ man/docker-push.1.md | 2 ++ 4 files changed, 8 insertions(+) diff --git a/docs/reference/commandline/pull.md b/docs/reference/commandline/pull.md index 8e7d777356..01ec88e8a6 100644 --- a/docs/reference/commandline/pull.md +++ b/docs/reference/commandline/pull.md @@ -165,6 +165,8 @@ listening on port 5000 (`myregistry.local:5000`): $ docker pull myregistry.local:5000/testing/test-image ``` +Registry credentials are managed by [docker login](login.md). + Docker uses the `https://` protocol to communicate with a registry, unless the registry is allowed to be accessed over an insecure connection. Refer to the [insecure registries](daemon.md#insecure-registries) section for more information. diff --git a/docs/reference/commandline/push.md b/docs/reference/commandline/push.md index 315d3ce376..81091b1430 100644 --- a/docs/reference/commandline/push.md +++ b/docs/reference/commandline/push.md @@ -22,3 +22,5 @@ registry or to a self-hosted one. Killing the `docker push` process, for example by pressing `CTRL-c` while it is running in a terminal, will terminate the push operation. + +Registry credentials are managed by [docker login](login.md). diff --git a/man/docker-pull.1.md b/man/docker-pull.1.md index e4a7550d5b..c61d005308 100644 --- a/man/docker-pull.1.md +++ b/man/docker-pull.1.md @@ -151,6 +151,8 @@ listening on port 5000 (`myregistry.local:5000`): $ docker pull myregistry.local:5000/testing/test-image +Registry credentials are managed by **docker-login(1)**. + Docker uses the `https://` protocol to communicate with a registry, unless the registry is allowed to be accessed over an insecure connection. Refer to the [insecure registries](https://docs.docker.com/engine/reference/commandline/daemon/#insecure-registries) diff --git a/man/docker-push.1.md b/man/docker-push.1.md index cf4bc255f1..1b487a0d55 100644 --- a/man/docker-push.1.md +++ b/man/docker-push.1.md @@ -44,6 +44,8 @@ Check that this worked by running: You should see both `rhel-httpd` and `registry-host:5000/myadmin/rhel-httpd` listed. +Registry credentials are managed by **docker-login(1)**. + # HISTORY April 2014, Originally compiled by William Henry (whenry at redhat dot com) based on docker.com source material and internal work.