1 系统要求

1.1 硬件和软件要求

• Linux内核版本3.10或更高
• Docker EE Engine版本17.06.2-ee-8; 的值n在-ee-*后缀必须是8或更高
• 静态IP地址

1.2 最低配置

• 管理节点 8GB RAM
• 工作节点 4GB RAM
• 3GB 可用磁盘空间

1.3 推荐配置

• 管理节点 16GB RAM
• 管理节点 4个vCPU
• 25-100GB 可用磁盘空间

1.4 操作系统支持

• CentOS 7.4 （本文中默认使用的操作系统）
• Red Hat Enterprise Linux 7.0, 7.1, 7.2, or 7.3
• Ubuntu 14.04 LTS or 16.04 LTS
• SUSE Linux Enterprise 12

1.5 其它

• 同步时区和时间
• 一致的主机名策略
• 内部的DNS

1.6 版本适配

• docker 17.06.2.ee.8+
• UCP 3.0.2 : DTR 2.5.3
  
• UCP 3.0.0 : DTR 2.5.0

1.7 网络要求

安装过程中UCP节点需要能下载docker官网的资源，如果不能访问，可通过其它机器下载软件包，然后执行离线安装。
如何离线安装UCP，请参考这里。

1.8 使用的端口

在主机上安装UCP时，需要打开一系列端口以传入流量。这些端口都将接收来自一组主机的流量，根据主机来源的不同，端口可分为三个Scope：

• External：流量通过终端用户交互从集群外部到达。
• Internal：流量从同一集群中的其他主机到达。
• Self：流量只从同一主机上的进程到达。

a, 如果没有firewalld，先要安装firewalld

$ yum install firewalld

b, 开启防火墙

$ systemctl start firewalld.service

c, 查看端口是否开放

$ firewall-cmd --zone=public --query-port=443/tcp

d, 开放端口

$ firewall-cmd --zone=public --add-port=443/tcp --permanent firewall-cmd --reload

e, 重载策略

$ firewall-cmd --reload

2 安装UCP

2.1 验证系统要求

安装UCP的第一步是确保具备UCP安装运行的所有要求。

2.2 安装Docker EE

确保在所有节点上安装相同的Docker EE版本。
如果是创建已安装Docker EE的虚拟机模板，请确保/etc/docker/key.json文件未包含在虚拟机映像中。配置虚拟机时，重新启动Docker守护程序以生成新/etc/docker/key.json文件。

CentOS7 安装 Docker EE，请参考这里。

2.3 安装UCP

a, SSH到要安装UCP的主机。

b, 运行如下命令：

# Pull the latest version of UCP
$ docker image pull docker/ucp:3.0.2

# Install UCP
$ docker container run --rm -it --name ucp \
  -v /var/run/docker.sock:/var/run/docker.sock \
  docker/ucp:3.0.2 install \
  --host-address <node-ip-address> \  # 安装UCP的主机IP
  --interactive

安装命令会以交互模式运行，安装过程中会提示输入必要的配置值，主要是管理员登录名和密码等。

安装完成后，访问UCP首页https://<node-ip-address>：

使用管理员登录名和密码登录，登录成功后会进入默认主页仪表盘：

注意：

• host-address 最好用IP；
• 安装过程中可能需要登录store.docker.com, 用自己的注册账号登录；
• 安装过程中的输入值也可以在命令中以参数方式提供，具体请参考官方文档。

2.4 授权

a, 转到Docker Store并购买Docker EE订阅，购买或免费试用许可。

b, 在UCP Web UI中，导航到管理员设置页面，在左侧菜单中，单击许可证。

c, 单击上传许可证，弹出窗口中选择已经下载好的（.lic）文件，UCP会使用新文件进行更新。

2.5 其它UCP命令

a, 更新UCP

$ docker image pull docker/ucp:3.0.2
    
$ docker container run --rm -it --name ucp -v /var/run/docker.sock:/var/run/docker.sock docker/ucp:3.0.2 upgrade --interactive

b, 重启UCP

$ docker container run -it --rm --name ucp -v /var/run/docker.sock:/var/run/docker.sock docker/ucp:3.0.2 restart

c, 卸载UCP

$ docker container run --rm -it -v /var/run/docker.sock:/var/run/docker.sock --name ucp docker/ucp:3.0.2 uninstall-ucp --interactive

3 配置UCP

3.1 加入新节点

a, 在UCP Web UI中，导航到共享的资源下的节点页面，然后单击添加节点按钮添加新节点。

b, 在“ 添加节点页面中，选择节点类型为LINUX。其它都默认。

c, 单击复制图标

复制docker swarm join节点用于加入群集的命令。

d, 对于要加入群集的每个节点，使用ssh登录并运行复制的join命令。join命令完成后，该节点将显示在UCP Web UI中的节点页面上。

3.2 配置TLS证书和密钥

所有UCP服务都使用HTTPS，以确保客户端和UCP之间的所有通信是加密的。默认情况下，这是使用不受客户端工具（如Web浏览器）信任的自签名TLS证书完成的。
因此，当访问UCP时，浏览器会警告不信任UCP或UCP具有无效证书。

可以将UCP配置为使用自己的TLS证书，以便浏览器和客户端工具自动信任它。

a, 在UCP Web UI中，导航到管理员设置页面。

b, 在左侧菜单中，单击证书。

c, 上传证书和密钥

• ca.pem：CA证书。
• server-cert.pem：服务器证书。
• server-key.pem：私钥。

如何为UCP生成证书和密钥，请参考这里。

d, 最后，单击保存使更改生效。

系列文章

DDC系列 - UCP安装指南
DDC系列 - DTR安装指南
DDC系列 - 离线安装UCP和DTR
DDC系列 - 设置CA证书