From 76294fb7fd565eddc8ca4cf92d74bad19a1c6bdf Mon Sep 17 00:00:00 2001 From: Trapier Marshall Date: Wed, 1 Nov 2017 17:05:57 -0400 Subject: [PATCH] ucp: indicate how to validate client bundle communication (#5178) * ucp: indicate how to validate client bundle loaded Recommends using `docker version` to confirm UCP client certificate bundle has been sourced and the client is successfully able to reach UCP. Signed-off-by: Trapier Marshall * Add raw/endraw Liquid tags --- .../ucp/2.0/guides/access-ucp/cli-based-access.md | 11 +++++++++++ .../2.1/guides/user/access-ucp/cli-based-access.md | 11 +++++++++++ .../2.2/guides/user/access-ucp/cli-based-access.md | 11 +++++++++++ 3 files changed, 33 insertions(+) diff --git a/datacenter/ucp/2.0/guides/access-ucp/cli-based-access.md b/datacenter/ucp/2.0/guides/access-ucp/cli-based-access.md index 88ebe048f1..328184347f 100644 --- a/datacenter/ucp/2.0/guides/access-ucp/cli-based-access.md +++ b/datacenter/ucp/2.0/guides/access-ucp/cli-based-access.md @@ -52,6 +52,17 @@ local Docker CLI communicate with UCP. It also updates the `DOCKER_CERT_PATH` environment variables to use the client certificates that are included in the client bundle you downloaded. +To verify a client certificate bundle has been loaded and the client is +successfully communicating with UCP, look for `ucp` in the `Server Version` +returned by `docker version`. + +```bash +{% raw %} +$ docker version --format '{{.Server.Version}}' +{% endraw %} +ucp/2.0.0 +``` + From now on, when you use the Docker CLI client, it includes your client certificates as part of the request to the Docker Engine. You can now use the Docker CLI to create services, networks, volumes and other diff --git a/datacenter/ucp/2.1/guides/user/access-ucp/cli-based-access.md b/datacenter/ucp/2.1/guides/user/access-ucp/cli-based-access.md index 5d649e5627..16721bc5f0 100644 --- a/datacenter/ucp/2.1/guides/user/access-ucp/cli-based-access.md +++ b/datacenter/ucp/2.1/guides/user/access-ucp/cli-based-access.md @@ -52,6 +52,17 @@ local Docker CLI communicate with UCP. It also updates the `DOCKER_CERT_PATH` environment variable to use the client certificates that are included in the client bundle you downloaded. +To verify a client certificate bundle has been loaded and the client is +successfully communicating with UCP, look for `ucp` in the `Server Version` +returned by `docker version`. + +```bash +{% raw %} +$ docker version --format '{{.Server.Version}}' +{% endraw %} +ucp/2.1.0 +``` + From now on, when you use the Docker CLI client, it includes your client certificates as part of the request to the Docker Engine. You can now use the Docker CLI to create services, networks, volumes, and other diff --git a/datacenter/ucp/2.2/guides/user/access-ucp/cli-based-access.md b/datacenter/ucp/2.2/guides/user/access-ucp/cli-based-access.md index 2eea250753..f9b06d0c63 100644 --- a/datacenter/ucp/2.2/guides/user/access-ucp/cli-based-access.md +++ b/datacenter/ucp/2.2/guides/user/access-ucp/cli-based-access.md @@ -56,6 +56,17 @@ client bundle you downloaded. > Windows environment, run `env.cmd` in an elevated command prompt, or run > `env.ps1` in an elevated PowerShell prompt. +To verify a client certificate bundle has been loaded and the client is +successfully communicating with UCP, look for `ucp` in the `Server Version` +returned by `docker version`. + +```bash +{% raw %} +$ docker version --format '{{.Server.Version}}' +{% endraw %} +{{ page.ucp_repo }}/{{ page.ucp_version }} +``` + From now on, when you use the Docker CLI client, it includes your client certificates as part of the request to the Docker Engine. You can now use the Docker CLI to create services, networks, volumes, and other resources on a swarm