集群管理
目录
一、功能概述
当业务系统需要保证高可用性，或者需要将工作负载分布到多个节点，需要使用集群管理。集群分为网关集群和ESB集群。 一个集群下可以创建多个运行时。API或者集成流程部署时，会选择一个集群进行部署，该API或者集成流程会部署到对应集群下的所有运行时中。 运行时是实际部署运行的环境，一个API或者集成流程可以部署在多个运行时上，一个运行时也可以部署多个集成流。 为了在多台服务器、计算资源或网络链路上分配工作负载，本系统也提供了配置负载均衡的功能，从而提高了系统的性能、可靠性和可扩展性等功能。
二、使用指南
（一）集群管理
登录管理中心，在左侧导航菜单选择 "集群管理"，选择"集群管理"TAB页。
-
创建集群：根据需要自定义集群。
-
搜索：根据字段或者内容，搜索集群。
-
重置：重置搜索内容。
-
删除：选定一个或者多个集群后，可以删除。
列表内容说明：
| 参数 | 参数说明 |
|---|---|
| 集群名称 | 自定义的集群名称 |
| 部署资源数量 | 该集群上已部署的API,流程集成和数据服务等数量之和 |
| 更新时间 | 该集群最后一个更新的时间 |
| 创建人 | 该集群的创建人员 |
| 操作 | 对单个集群进行配置，编辑或者删除操作 |
（二）查看集群信息
登录管理中心，在左侧导航菜单选择 "集群管理"，选择"集群管理"TAB页， 单击需要查看的集群名称，弹出查看集群页面。
列表内容说明：
| 参数 | 参数说明 |
|---|---|
| ID | 集群唯一的标识 |
| 名称 | 集群名称 |
| 描述 | 描述集群的作用，功能等 |
| 负载均衡器 | 选择一个负载均衡器 |
| GW HTTP服务端口号 | 负载均衡器上，GW HTTP协议对应的端口号 |
| GW HTTPS服务端口号 | 负载均衡器上，GW HTTPS协议对应的端口号 |
| ESB HTTP服务端口号 | 负载均衡器上，ESB HTTP协议对应的端口号 |
| ESB HTTPS服务端口号 | 负载均衡器上，ESB HTTPS协议对应的端口号 |
| ESB WS服务端口号 | 负载均衡器上，ESB WS协议对应的端口号 |
| ESB WSS服务端口号 | 负载均衡器上，ESB WSS协议对应的端口号 |
（三）创建集群
登录管理中心，在左侧导航菜单选择 "集群管理"，选择"集群管理"TAB页， 单击“创建集群”，弹出创建集群页面。
列表内容说明：
| 参数 | 参数说明 | 必填 |
|---|---|---|
| 名称 | 集群名称，需要唯一 | 是 |
| 描述 | 描述集群的作用，功能等 | 否 |
（四）配置集群
1. 安全配置
已注册并部署到API网关的接口，通过合理设置认证策略，可有效防止未授权访问，保障API使用的安全。
系统支持OAuth2认证和JWT认证。管理员可根据不同API的安全需求灵活配置：
-
OAuth2认证：支持第三方应用授权访问，实现精细化权限控制，适合开放平台场景；
-
JWT认证：基于令牌的无状态认证方式，适合微服务架构，减轻后端认证压力。
配置完成后，API网关将根据设置对所有API接口调用请求进行验证，未通过认证的请求将被拒绝，有效提升系统安全性。
系统支持配置全局WAF防护功能，为系统提供了集中式的Web应用防火墙保护机制。
| 配置项 | 说明 |
|---|---|
| 是否需要认证 | 默认为“是”，标识API网关运行时开启认证模式。 若选择“否”，标识API网关的运行时不开启API认证模式。 |
| 认证方式 | 当配置需要认证时，可选API认证方式如OAuth2认证或JWT认证。 |
| 开启全局WAF防护 | 默认为“否”，表示不对所有 HTTP 类型的 API 请求开启 WAF 防护。 若选择“是”，所有HTTP类型的API请求将经过WAF安全检测，有效抵御常见的Web攻击，如SQL注入、XSS跨站脚本、命令注入等威胁。此功能特别适用于面向公网的API服务，或包含敏感数据操作的接口。 |
2. 日志配置
日志配置可以控制决定API网关运行时和ESB运行时是否记录请求和响应的完整报文内容（body部分）。
| 配置项 | 说明 |
|---|---|
| 缺省是否记录报文日志 | 默认为“否”：忽略请求响应 body，来提高响应速度。 若选择“是”：记录完整报文内容，便于全面问题排查和请求内容分析，但会增加系统开销。 |
3. 服务发现配置
API网关提供与主流服务注册中心的无缝集成能力，支持Nacos，支持API服务地址的动态发现与路由。
| 配置项 | 说明 |
|---|---|
| nacos地址 | 若使用nacos注册中心，请填写nacos的地址。 |
| 命名空间id | 若使用nacos注册中心，请填写nacos的命名空间id。 |
| nacos用户名 | 若使用nacos注册中心，请填写nacos的用户名。 |
| nacos密码 | 若使用nacos注册中心，请填写nacos的用户名密码。 |
（五）编辑集群
登录管理中心，在左侧导航菜单选择 "集群管理"，选择"集群管理"TAB页，单击“编辑”，弹出编辑集群页面。
列表内容说明：
| 参数 | 参数说明 | 必填 |
|---|---|---|
| ID | 集群唯一的标识 | 是 |
| 名称 | 集群名称 | 是 |
| 描述 | 描述集群的作用，功能等 | 否 |
| 负载均衡器 | 选择一个负载均衡器 | 否 |
| GW HTTP服务端口号 | 负载均衡器上，GW HTTP协议对应的端口号。用于反向代理，请填未被占用的端口号。程序也会用 Linux 的 netstat 命令查看某个端口是否被占用。若您的 Linux 没有这个命令，请安装这个命令。此外，由于权限问题，netstat 命令无法查看其他用户的进程，可以授予普通用户使用 netstat 查看其他用户进程的权限，命令如下所示。sudo chmod +s /bin/netstat | 否 |
| GW HTTPS服务端口号 | 负载均衡器上，GW HTTPS协议对应的端口号。用于反向代理GW HTTPS 请求的端口号，请填未被占用的端口号。 非必填。若填写，需要补充完成负载均衡器上的GW HTTPS相关配置。 | 否 |
| ESB HTTP服务端口号 | 负载均衡器上，ESB HTTP协议对应的端口号。用于反向代理，请填未被占用的端口号。程序也会用 Linux 的 netstat 命令查看某个端口是否被占用。若您的 Linux 没有这个命令，请安装这个命令。此外，由于权限问题，netstat 命令无法查看其他用户的进程，可以授予普通用户使用 netstat 查看其他用户进程的权限，命令如下所示。sudo chmod +s /bin/netstat | 否 |
| ESB HTTPS服务端口号 | 负载均衡器上，ESB HTTPS协议对应的端口号。用于反向代理ESB HTTPS 请求的端口号，请填未被占用的端口号。 非必填。若填写，需要补充完成负载均衡器上的ESB HTTPS相关配置。 | 否 |
| ESB WS服务端口号 | 负载均衡器上，ESB WS协议对应的端口号。用于反向代理 SOAP 请求的端口号，请填未被占用的端口号。程序会用 Linux 的 netstat 命令查看某个端口是否被占用。若您的 Linux 没有这个命令，请安装这个命令。此外，由于权限问题，netstat 命令无法查看其他用户的进程，可以授予普通用户使用 netstat 查看其他用户进程的权限，命令如下所示。sudo chmod +s /bin/netstat | 否 |
| ESB WSS服务端口号 | 负载均衡器上，ESB WSS协议对应的端口号。用于反向代理 WSS 请求的端口号，请填未被占用的端口号。 非必填。若填写，需补充完成负载均衡器上的ESB HTTPS相关配置。 | 否 |
（六）删除集群
如果需要删除多个集群：登录管理中心，在左侧导航菜单选择 "集群管理"，选择"集群管理"TAB页， 选择多个集群，单击"删除"，弹出确认窗口后，点击确认，即可删除。
如果需要删除单个集群：登录管理中心，在左侧导航菜单选择 "集群管理"，选择"集群管理"TAB页，选择需要删除的行，单机该行后面的“删除”，弹出确认窗口后，点击确认，即可删除。
注意：集群下面存在运行时状态为“启动”，该集群无法删除，需要先停止启动中的运行时。
三、负载均衡使用指南
（一）负载均衡管理
登录管理中心，在左侧导航菜单选择 "集群管理"，选择"负载均衡"TAB页。
-
搜索：根据字段或者内容，搜索集群。
-
重置：重置搜索内容。
-
创建负载均衡：创建一个新的负载均衡器，支持Nginx
-
删除：选定一个或者多个负载环境，可以删除。
列表内容说明：
| 参数 | 参数说明 |
|---|---|
| 序号 | 从1开始的顺序编号 |
| 名称 | 负载均衡器名称 |
| 类型 | 负载均衡器类型，支持Nginx |
| 状态 | 负载均衡器状态，包括启动，停止 |
| 集群数 | 一个负载均衡器，可以带多个集群。这里表示带的集群的数量 |
| IP地址 | 安装负载均衡器的机器的地址 |
| 更新时间 | 最后一次更新该负载均衡器的时间 |
| 创建人 | 该负载均衡器的创建人员 |
| 操作 | 支持对该均衡负载器进行操作，包括编辑，启动，停止，删除等 |
（二） 创建负载均衡
登录管理中心，在左侧导航菜单选择 "集群管理"，选择"负载均衡"TAB页，点击"创建负载均衡"。
列表内容说明：
| 参数 | 参数说明 | 必填 |
|---|---|---|
| 类型 | 负载均衡器的类型，可选 Nginx。 | 是 |
| 名称 | 负载均衡器名称，最多20位，支持数字、字母、下划线、中文。 负载均衡器名称 | 是 |
| 操作系统 | 负载均衡器所在主机的操作系统，可选 Linux、Windows。 负载均衡器类型，支持Nginx | 是 |
| IP地址 | 负载均衡器所在主机的 IP 地址。 | 是 |
| SSH端口号 | 负载均衡器所在主机的 SSH 端口号，通常为“22”。 | 是 |
| 安装目录 | 安装负载均衡器的主目录。对于 Nginx 来说，通常是 sbin 的上一层目录。 | 是 |
| 用户名 | 用户建立 SSH 连接的用户名。 | 是 |
| 密码 | 用户建立 SSH 连接的密码。 | 是 |
| 连接超时时间 | 用户建立 SSH 连接超时时间。 | 是 |
| 认证超时时间 | 建立 SSH 认证的超时时间。 | 是 |
（三）编辑负载均衡
登录管理中心，在左侧导航菜单选择 "集群管理"，选择"负载均衡"TAB页，选择需要编辑的行，点击"编辑"。
列表内容说明：
| 参数 | 参数说明 | 必填 |
|---|---|---|
| 类型 | 负载均衡器的类型，可选 Nginx。 | 是 |
| 名称 | 负载均衡器名称，最多20位，支持数字、字母、下划线、中文。 负载均衡器名称 | 是 |
| 操作系统 | 负载均衡器所在主机的操作系统，可选 Linux、Windows。 负载均衡器类型，支持Nginx | 是 |
| IP地址 | 负载均衡器所在主机的 IP 地址。 | 是 |
| SSH端口号 | 负载均衡器所在主机的 SSH 端口号，通常为“22”。 | 是 |
| 安装目录 | 安装负载均衡器的主目录。对于 Nginx 来说，通常是 sbin 的上一层目录。 | 是 |
| 用户名 | 用户建立 SSH 连接的用户名。 | 是 |
| 密码 | 用户建立 SSH 连接的密码。 | 是 |
| 连接超时时间 | 用户建立 SSH 连接超时时间。 | 是 |
| 认证超时时间 | 建立 SSH 认证的超时时间。 | 是 |
（四）停止负载均衡
登录管理中心，在左侧导航菜单选择 "集群管理"，选择"负载均衡"TAB页，选择需要停止的行，点击"停止"，弹出停止负载均衡确认对话框。
（五）启动负载均衡
登录管理中心，在左侧导航菜单选择 "集群管理"，选择"负载均衡"TAB页，选择需要启动的行，点击"启动"，弹出启动负载均衡确认对话框。
四、常见问题
（一） 集群支持哪些配置？
集群支持安全配置，日志配置，服务发现配置。
（二） 集群安全配置支持哪些认证方式？
集群安全支持OAuth2认证和JWT认证两种认证方式，OAuth2认证支持第三方应用授权访问，实现精细化权限控制，适合开放平台场景， JWT认证基于令牌的无状态认证方式，适合微服务架构，减轻后端认证压力。
（三） 负载均衡支持哪些类型？
负载均衡目前仅支持Nginx类型。