docker/ucp-etcd Docker Image

Docker UCP 镜像文档

镜像概述

Docker Universal Control Plane (UCP) 是Docker企业级容器管理平台的核心组件，提供对Docker Swarm集群的集中化管理能力。本镜像用于快速部署UCP服务，帮助用户通过图形化界面或API实现容器集群的编排、监控、身份验证及资源分配，适用于企业级生产环境的容器化管理需求。

主要用途

• 部署和管理Docker Swarm集群
• 提供可视化集群管理界面
• 实现多租户环境下的资源隔离与权限控制
• 集成容器监控与日志收集功能
• 支持企业级身份验证（如LDAP/Active Directory）

核心功能和特性

集群管理

• 支持Docker Swarm模式集群的创建、扩展与维护
• 图形化界面展示集群节点状态、容器分布及资源使用率
• 一键部署和升级集群服务

身份验证与授权

• 集成LDAP/Active Directory、SAML等企业级身份认证系统
• 基于角色的访问控制（RBAC），支持细粒度权限配置
• 多租户隔离，支持团队与项目级别的资源划分

监控与运维

• 实时监控集群资源使用率（CPU、内存、网络）
• 容器日志集中收集与检索
• 集群健康检查与告警机制

容器编排

• 支持Docker Compose与Stack部署
• 服务自动扩缩容与负载均衡
• 容器生命周期管理（启动、停止、重启、迁移）

使用场景和适用范围

适用场景

• 企业级容器化应用生产环境
• 需要集中管理多节点Docker Swarm集群的场景
• 多团队协作的容器平台（如开发、测试、生产环境隔离）
• 对容器集群有严格安全与合规要求的场景

适用规模

• 中小型容器集群（10-100节点）
• 大型分布式应用部署与管理

使用方法和配置说明

前置条件

• Docker Engine版本需满足UCP兼容要求（具体版本参考Docker官方文档）
• 主机需分配至少4GB内存及2CPU核心
• 集群节点间需开放必要端口（如2376、443、2377等）
• 建议配置持久化存储（如NFS、块存储）用于UCP数据持久化

部署步骤

1. 拉取镜像

bash
docker pull docker.xuanyuan.run/docker/ucp:latest

2. 初始化UCP集群（管理节点）

bash
docker run --rm -it \
  -v /var/run/docker.sock:/var/run/docker.sock \
  docker.xuanyuan.run/docker/ucp:latest install \
  --host-address <MANAGER_NODE_IP> \
  --admin-username <ADMIN_USER> \
  --admin-password <ADMIN_PASSWORD>

3. 添加工作节点至集群

在工作节点执行UCP管理界面提供的加入命令（格式示例）：

bash
docker swarm join \
  --token <WORKER_JOIN_TOKEN> \
  <MANAGER_NODE_IP>:2377

配置参数说明

环境变量

部署示例

单节点测试环境部署

bash
# 拉取最新版UCP镜像
docker pull docker.xuanyuan.run/docker/ucp:latest

# 部署UCP单节点（管理节点）
docker run --rm -it \
  -v /var/run/docker.sock:/var/run/docker.sock \
  docker.xuanyuan.run/docker/ucp:latest install \
  --host-address 192.168.1.100 \
  --admin-username admin \
  --admin-password SecurePass123!

部署完成后，通过浏览器访问 https://192.168.1.100:443 即可打开UCP管理界面。

高可用集群部署（3个管理节点）

bash
# 在第一个管理节点初始化集群
docker run --rm -it \
  -v /var/run/docker.sock:/var/run/docker.sock \
  docker.xuanyuan.run/docker/ucp:latest install \
  --host-address 192.168.1.100 \
  --admin-username admin \
  --admin-password SecurePass123! \
  --controller-replicas 3

# 在第二个管理节点加入集群（从UCP界面获取加入命令）
docker run --rm -it \
  -v /var/run/docker.sock:/var/run/docker.sock \
  docker.xuanyuan.run/docker/ucp:latest join \
  --token <MANAGER_JOIN_TOKEN> \
  --host-address 192.168.1.101

# 第三个管理节点操作同上，替换IP为192.168.1.102

注意事项

• UCP数据默认存储在 /var/lib/docker/volumes/ucp_data/_data，建议通过外部存储卷持久化
• 升级UCP前需备份集群数据，避免版本兼容性问题导致数据丢失
• 生产环境需配置负载均衡器（如NGINX、HAProxy）实现UCP入口流量分发
• 确保集群节点间网络通畅，开放必要端口（443、2376、2377、7946、4789等）