iCloudManager for Docker 通用负载均衡操作指南

SuperMap iCloudManager 提供了负载均衡功能，使多个通用平台 组成一个负载均衡组，将外部发送来的请求根据负载均衡策略（相关 详情请参见 SuperMap iCloudManager 的联机帮助）分配到组中的某 一个通用平台上，而接到请求的服务器独立地响应客户的请求，籍此 解决高并发访问服务问题。

图 1 负载均衡
本操作指南共涉及三部分：配置负载均衡器、添加负载均衡组以及使用负载均衡功能。

1. 配置负载均衡器

负载均衡器由 Nginx 软件为支撑，为负载均衡功能提供保障。由 于 Docker 容器对外都是通过暴露端口的形式提供服务，所以 iCloudManager for Docker 不支持在 Docker 中 创建 Nginx，您需要导入 Docker 容器外的 Nginx 来作为负载均衡器使用。 负载均衡器由管理员添加，添加后所有用户均可使用。

1.1 安装 Nginx

推荐将 Nginx 安装在 Docker 所在机器（您也可以将 Nginx 安装在 任意其它机器，只要确保 iCloudManager 能访问到 Nginx 服务即可）。 本操作指南中是将 Nginx 安装在 Docker 所在机器。 以 Ubuntu 系统为例，通过以下命令进行安装：sudo apt-get install nginx，默认安装路径为/etc/nginx。

1.2 导入 负载均衡器

在 iCloudManager 的负载均衡器页面，点击“添加负载均衡器”，您即可导入 Docker 容器外的负载均衡器。

图 2 添加负载均衡器
 负载均衡器名称（必选）：为导入的负载均衡器命名。
 添加方式（必选）： Docker 平台只有一种方式，默认已经为您选择为“导入外部已有负载均衡器”。
 服务器 IP （必选）：Nginx 所在机器的 IP 地址。本例中是将Nginx 安装在 Docker 所在机器，因此，此处填入它的 IP（192.168.21.101）即可。
 密码（必选）：该密码为导入的负载均衡器所在主机/虚拟机的root 账户的登录密码，若没有密码则不填；若有密码，则必须正确填写。
 执行文件目录（必选）：若 Nginx 是默认安装，则执行文件目录为/usr/sbin，否则请根据实际安装路径来填写。
 配置文件目录（必选)：若 Nginx 是默认安装，则配置文件目录为/etc/nginx/conf.d，若您修改了配置文件目录，请填写为修改后的配置文件目录。
 描述信息（可选）：填写导入的负载均衡器的相关描述信息。填写好以上信息后，点击“确定”，iCloudManager 将把外部的负载均衡器导入。在填写时，请确保 Nginx 服务器的 IP、密码、执
行文件目录以及配置文件目录正确。
注意：负载均衡组的配置信息会保存在 Nginx 配置文件目录里，因此 Nginx 主配置文件需包含配置文件目录，以默认安装的 Nginx 为例，在主配置文件/etc/nginx/nginx.conf 的 http 配置中请确保有如下配置：
http{
******
include /etc/nginx/conf.d/*.conf;
******
}

2. 添加负载均衡组

在 iCloudManager 的负载均衡页面，点击“添加负载均衡组”，会弹出添加负载均衡组对话框，如下图所示：

图 3 添加负载均衡组步骤 1
您需要根据实际情况填写相关参数：
 负载均衡组名称（必选）：请为该负载均衡组设定名称。
 负载均衡器（必选）：请为该负载均衡组选择负载均衡器，默认会自动填充 1.2 节导入的负载均衡器。
 域名及端口（必选）：负载均衡器的地址及预期开放的端口，填写格式为 “example.com:port”，若您填写的域名没有在您的DNS 服务器里，则需要让 DNS 管理员把该域名添加到 DNS 服务器。若无 DNS 服务器，则直接用负载均衡器的 IP 即可，如本例的“192.168.21.101:8080”。
 服务访问协议（必选）：http。
 负载均衡策略（必选）：任选一种，示例为加权值为 1:1 的轮询。
填写好以上信息后，点击“下一步”，配置以下信息：

图 4 添加负载均衡组步骤 2
 ContextPath： 此处需要先选择 ContextPath 的值，如本例选择为“/geoserver”,选择后，会在下面的列表中列出所有的且与 ContextPath 值相同的 GIS 服务器和通用平台环境（这里以GeoServer 为例）。
 动态伸缩：选择是否开启动态伸缩，默认是关闭。配置好后点击“完成”，将生成此负载均衡组。
到此，Docker 平台的通用负载均衡配置完成，您可以开始使用其功能。

3. 使用负载均衡功能

点击您刚刚添加的负载均衡组，进入详细信息页面，可以查看负载均衡组信息、子节点信息和历史负载等。

图 5 负载均衡组详细信息
点击负载均衡组名称右边的访问地址即可。此时，请求会被分配到负载均衡组子节点 1（192.168.21.150:14248），接着是负载均衡组子节点 2（192.168.21.150:2567），然后重新开始循环，以此实现负载均衡的功能。
不同的负载均衡策略，负载均衡的具体实现也就不同（相关详情请参见 SuperMap iCloudManager 的联机帮助）。