docker/ucp-proxy Docker Image

Docker UCP 镜像文档

镜像概述

docker/ucp 镜像为 Docker Universal Control Plane（UCP）的官方镜像，是 Docker 企业级容器平台的核心组件之一。该镜像用于部署 UCP 服务，实现对 Docker 集群的集中化管理，简化容器生命周期管理、资源调度及安全控制流程。

核心功能和特性

• 集群管理：支持多节点 Docker 集群的统一管理，包括节点添加/移除、资源分配与监控
• 容器编排：集成 Docker Swarm 模式，提供容器编排、服务发现及负载均衡能力
• 监控与日志：实时监控集群状态、容器运行指标，支持日志集中收集与分析
• 安全控制：提供角色访问控制（RBAC）、镜像安全扫描、网络隔离及密钥管理功能
• 多租户支持：支持团队级资源隔离，满足多项目并行管理需求

使用场景和适用范围

• 企业级 Docker 集群部署与管理
• 多节点容器应用的集中化监控与运维
• 需要严格权限控制的生产环境容器管理
• 跨团队协作的容器资源分配与隔离

使用方法和配置说明

前提条件

• Docker Engine 版本需满足 UCP 兼容要求（通常为 1.13+）
• 管理节点需满足最低硬件配置（2 CPU/4GB RAM/100GB 磁盘）
• 节点间网络通畅，开放必要端口（443、2376、2377 等）

基础部署命令

bash
docker run --rm -it --name ucp \
  -v /var/run/docker.sock:/var/run/docker.sock \
  docker.xuanyuan.run/docker/ucp:latest install \
  --host-address <MANAGER_NODE_IP> \
  --interactive

关键配置参数

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

bash
# 在第一个管理节点初始化
docker run --rm -it --name ucp \
  -v /var/run/docker.sock:/var/run/docker.sock \
  docker.xuanyuan.run/docker/ucp:latest install \
  --host-address <MANAGER1_IP> \
  --swarm-init

# 加入第二个管理节点
docker run --rm -it --name ucp \
  -v /var/run/docker.sock:/var/run/docker.sock \
  docker.xuanyuan.run/docker/ucp:latest join \
  --host-address <MANAGER2_IP> \
  --token <JOIN_TOKEN> \
  <MANAGER1_IP>

控制台访问

部署完成后，通过浏览器访问 https://<MANAGER_NODE_IP>:443，使用管理员账号（默认 admin）及配置密码登录 UCP 控制台，进行集群管理操作。

升级方法

bash
docker run --rm -it --name ucp \
  -v /var/run/docker.sock:/var/run/docker.sock \
  docker.xuanyuan.run/docker/ucp:latest upgrade \
  --interactive

注意事项

• 生产环境建议配置外部负载均衡器实现高可用
• 定期备份 UCP 数据（通过 docker/ucp backup 命令）
• 升级前需确认当前版本与目标版本的兼容性
• 敏感配置建议通过环境变量或密钥文件注入，避免明文暴露