Docker UCP 镜像文档

1. 镜像概述和主要用途

Docker UCP（Universal Control Plane）镜像是 Docker 官方提供的企业级容器集群管理平台镜像，用于部署和运行 Docker Universal Control Plane。该镜像提供集中式控制平面，支持对 Docker Swarm 或 Kubernetes 集群进行统一管理、监控和运维，是企业级容器化部署的核心组件。

2. 核心功能和特性

2.1 集群管理能力

• 统一管理多节点 Docker 集群，支持 Swarm 模式和 Kubernetes 编排
• 可视化集群拓扑视图，实时监控节点、容器、服务状态
• 集中式资源分配与调度，优化集群资源利用率

2.2 安全与合规

• 内置 TLS 加密通信，自动管理节点间证书颁发与轮换
• 基于角色的访问控制（RBAC），支持多租户权限隔离
• 集成 Docker Content Trust，实现镜像签名与验证
• 审计日志记录所有集群操作，满足合规性要求

2.3 多环境支持

• 兼容 Linux 和 Windows Server 节点混合部署
• 支持外部负载均衡器集成，实现高可用架构
• 与 Docker Trusted Registry（DTR）无缝对接，构建完整 DevOps 链路

3. 使用场景和适用范围

3.1 企业级容器集群管理

适用于需要统一管理数百台服务器规模的容器集群，提供跨节点服务编排、故障自愈能力。

3.2 多团队协作场景

通过租户隔离和权限控制，支持多团队共享集群资源，同时确保数据安全与操作隔离。

3.3 生产环境运维

提供监控告警、日志聚合、滚动更新等运维工具，简化容器化应用生命周期管理。

3.4 混合云部署

支持跨数据中心、公有云/私有云环境的分布式集群管理，统一控制平面降低跨环境复杂度。

4. 使用方法和配置说明

4.1 前置条件

• 节点要求：至少 1 台管理节点（推荐 3 台实现高可用），4GB+ 内存，10GB+ 磁盘空间
• 软件依赖：Docker Engine 19.03+（需启用 Swarm 模式或 Kubernetes 支持）
• 网络要求：开放端口 443（Web UI/API）、2376（Docker 守护进程）、2377（Swarm 管理）、7946（节点通信）、4789（overlay 网络）

4.2 基础部署（单节点）

4.2.1 安装命令

docker run --rm -it \
  --name ucp \
  -v /var/run/docker.sock:/var/run/docker.sock \
  docker/ucp:latest install \
  --host-address <管理节点IP> \
  --admin-username <管理员用户名> \
  --admin-password <管理员密码>

4.2.2 参数说明

• --host-address：指定管理节点的公网/内网 IP 地址（必填）
• --admin-username：设置 UCP 管理员账号（默认：admin）
• --admin-password：设置管理员密码（需满足复杂度要求：8 位以上，含大小写字母、数字及特殊符号）

4.3 高可用部署（多管理节点）

4.3.1 初始化第一个管理节点

docker run --rm -it \
  -v /var/run/docker.sock:/var/run/docker.sock \
  docker/ucp:latest install \
  --host-address <节点1 IP> \
  --admin-username admin \
  --admin-password <密码> \
  --ha

4.3.2 加入其他管理节点

在第一个节点部署完成后，执行以下命令获取加入令牌：

docker swarm join-token manager

在其他管理节点执行：

docker run --rm -it \
  -v /var/run/docker.sock:/var/run/docker.sock \
  docker/ucp:latest join \
  --token <管理节点令牌> \
  --host-address <当前节点IP> \
  <第一个管理节点IP>:2377

4.4 配置参数详解

4.4.1 环境变量配置

4.4.2 命令行参数

4.5 访问与管理

4.5.1 Web 控制台访问

部署完成后，通过 https://<管理节点IP>:443 访问 UCP 控制台，使用初始化时设置的管理员账号密码登录。

4.5.2 CLI 客户端配置

通过控制台 "Admin" > "My Profile" 下载 ucp-bundle-<用户名>.zip，解压后执行：

eval "$(<env.sh)"  # Linux/macOS
.\env.ps1          # Windows PowerShell

配置完成后可通过 docker info 验证集群连接状态。

4.6 升级与卸载

4.6.1 升级 UCP

docker run --rm -it \
  -v /var/run/docker.sock:/var/run/docker.sock \
  docker/ucp:latest upgrade \
  --interactive  # 交互式确认升级步骤

4.6.2 卸载 UCP

docker run --rm -it \
  -v /var/run/docker.sock:/var/run/docker.sock \
  docker/ucp:latest uninstall \
  --interactive  # 交互式确认卸载（会清除所有UCP数据）

4.7 典型部署示例（docker-compose 配置）

注：UCP 推荐使用 docker run 命令部署，以下为简化版 compose 配置示例（仅用于测试环境）

version: '3.8'
services:
  ucp:
    image: docker/ucp:latest
    privileged: true
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
    environment:
      - UCP_ADMIN_USER=admin
      - UCP_ADMIN_PASSWORD=Docker@UCP2024!
      - UCP_NODE_ADDRESS=192.168.1.100
    ports:
      - "443:443"
      - "2376:2376"
      - "2377:2377"
    command: install --host-address 192.168.1.100