dockercloud/registration

Docker Cloud Federation - registration镜像

镜像概述

dockercloud/registration是Docker Cloud Federation体系的核心组件之一，主要功能是将本地Swarm集群注册到Docker Cloud平台，并自动启动server-proxy服务，为集群提供身份验证和API请求转发能力，支持通过Docker ID实现远程集群的安全访问。

核心功能

1. 完成Swarm集群与Docker Cloud的关联注册
2. 自动部署server-proxy，对集群API请求进行身份验证与授权
3. 配合client-proxy实现本地Docker CLI与远程集群的安全通信

使用场景

• 企业或开发者需要远程管理分布在AWS、Azure等云环境的Swarm集群
• 通过统一Docker ID系统管理多集群的访问权限
• 安全转发Docker API请求，确保集群操作的合法性与可追溯性

配置说明与部署示例

远程Swarm集群端部署

自有集群注册

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

AWS环境一键部署（Nightly Build）

点击下方按钮通过CloudFormation快速部署：
https://s3.amazonaws.com/cloudformation-examples/cloudformation-launch-stack.png](https://console.aws.amazon.com/cloudformation/home?#/stacks/new?stackName=D4A-Nightly&templateURL=https://docker-for-aws.s3.amazonaws.com/aws/cloud-nightly/latest.json)

Azure环境一键部署

点击下方按钮通过Azure Template快速部署：

客户端配置

启动客户端容器

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

执行后将交互式提示输入Docker ID凭证及目标集群信息，登录成功后输出export命令设置DOCKER_HOST环境变量，例如：

bash
export DOCKER_HOST=tcp://0.0.0.0:32781

设置后本地Docker CLI即可直接与远程集群通信，client-proxy会自动注入身份凭证。

更新说明

远程集群端更新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. 拉取最新镜像：docker pull docker.xuanyuan.run/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清除环境变量，否则可能出现TLS错误：

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