dockercloud/server-proxy

Docker Cloud Federation

镜像概述

Docker Cloud Federation 提供一系列镜像集合，用于实现本地与远程Docker集群的连接、认证和管理。这些镜像协同工作，支持通过Docker ID进行身份验证，实现远程Docker集群的安全访问和操作。

镜像仓库

核心功能和特性

• 身份验证与授权：基于Docker ID的身份验证机制，确保集群访问安全
• API转发：实现本地与远程Docker集群间的API请求转发
• 集群注册：简化将现有swarm集群注册到Docker Cloud的流程
• 跨环境管理：支持通过本地CLI工具管理远程Docker集群

使用场景

• 远程Docker swarm集群的管理和操作
• 跨云环境（AWS、Azure）的Docker集群统一管理
• 需要安全认证的多用户Docker集群访问控制

使用方法

远程swarm端

自有集群注册

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

AWS环境部署（包含Docker Cloud注册，夜间构建）

Azure环境部署（包含Docker Cloud注册）

客户端

客户端容器

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

该命令会交互式请求Docker ID凭据和要连接的远程swarm。登录后，将显示如下export命令：

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

新的DOCKER_HOST环境变量指向客户端代理发布的端口，使本地CLI可直接与远程集群通信，客户端代理会自动注入适当的凭据。

更新方法

远程swarm端

执行以下命令更新：

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

客户端

1. 通过以下命令移除客户端代理容器：

   bash
   docker rm -f client_proxy_<namespace>_<swarmname>
   

2. 拉取最新客户端镜像：

   bash
   docker pull docker.xuanyuan.run/dockercloud/client
   

3. 创建新的客户端代理：

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

已知问题

• 如果使用docker machine，请执行unset DOCKER_TLS_VERIFY确保环境变量中没有DOCKER_TLS_VERIFY=1，否则会收到以下TLS错误：

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