dockercloud/client

Docker Cloud Federation

镜像概述

dockercloud/client是Docker Cloud Federation体系中的客户端镜像，用于通过Docker ID凭证与远程Docker集群进行交互，支持连接已注册到Docker Cloud的swarm集群，并配合相关代理镜像实现本地与远程集群的安全通信。

核心功能

1. 提供交互式shell，引导用户输入Docker ID凭证及目标远程swarm集群信息；
2. 配合client-proxy镜像，将本地Docker API请求转发至远程swarm集群，并自动注入Docker ID授权信息；
3. 支持连接通过dockercloud/registration镜像注册到Docker Cloud的swarm集群；
4. 提供镜像更新指引，确保客户端与远程集群代理的版本兼容性。

使用场景

1. 本地环境管理远程Docker swarm集群资源；
2. 通过Docker ID安全访问已注册到Docker Cloud的远程集群；
3. 更新远程集群的server-proxy或本地client镜像以获取最新功能。

配置说明

远程swarm侧操作

注册自有集群

bash
docker run -ti --rm -v /var/run/docker.sock:/var/run/docker.sock dockercloud/registration

启动带Docker Cloud注册的Docker For AWS（nightly构建）

![Docker for AWS]([***]

启动带Docker Cloud注册的Docker For Azure

![Docker for Azure]([***]

客户端侧操作

启动客户端容器

bash
docker run --rm -ti -v /var/run/docker.sock:/var/run/docker.sock -e DOCKER_HOST dockercloud/client

该命令会交互式要求输入Docker ID凭证及目标远程swarm集群信息。登录成功后会显示export命令，设置DOCKER_HOST环境变量以直接访问远程集群：

bash
# 现在可通过执行以下命令使用swarm namespace/swarmname：
export DOCKER_HOST=tcp://0.0.0.0:32781

更新指引

远程swarm侧更新server-proxy

bash
docker service update --image dockercloud/server-proxy:latest dockercloud-server-proxy

客户端侧更新

1. 删除旧的client proxy容器：docker rm -f client_proxy_<namespace>_<swarmname>；
2. 拉取最新client镜像：docker pull dockercloud/client；
3. 创建新的client proxy：docker run --rm -ti -v /var/run/docker.sock:/var/run/docker.sock -e DOCKER_HOST dockercloud/client <namespace>/<swarmname>。

已知问题

• 若使用docker machine，请执行unset DOCKER_TLS_VERIFY清除环境变量中的DOCKER_TLS_VERIFY=1，否则会出现TLS错误：

bash
$ docker ps
An error occurred trying to connect: Get [***] tls: oversized record received with length 20527