1. 概述
1.1 版本
| 运维平台版本 | 功能变更 |
|---|---|
| V2.8.0 | - |
1.2 应用场景
随着工程使用量的增加，单机工程可能无法满足客户用量，需要增加工程节点和相关集群组件，确保工程平稳运行。
本文将讲解，如何将容器化单机项目，扩容为单节点集群。
注：如原单机项目未配置nginx内网关组件，扩容后的工程访问地址会发生变化，默认地址为nginx所在服务器和端口。
2. 使用前提
1）项目类型必须为「单机」，集群项目无法完成本文操作。
2）项目部署方式必须为「运维平台部署」，非运维平台部署的项目无法完成本文操作。
3）项目主应用类型和版本应当为 bi6.0.x / fr11.0.x / fdl4.1.x（不支持bi6.1.x，因为运维平台部署的bi6.1全部是集群）
3. 准备主应用节点集群端口
相比于单机项目，集群项目的工程节点，需要额外占用一些端口，用于集群通信和数据同步等。
1）确认主应用节点服务器IP
管理员登录运维平台，选择目标项目，点击「维护>组件管理」。
查看bi/fr/fdl组件的物理节点，即应用所在服务器的IP地址。
2）查看该服务器，以下端口是否已被使用
如已被使用，请安排好其他空闲端口。
注：端口占用检查请参考：端口占用检查与防火墙配置
| 项目类型 | 默认端口 | 作用 |
|---|---|---|
| bi6.0.x | 7800、7830、7840、7850、7870 | 集群TCP通信端口 |
50050、50051、50100、50101、50200 | 集群数据同步端口 | |
| fr11.0.x | 7800、7830、7840、7850、7870 | 集群TCP通信端口 |
| fdl4.1.x | 7800、7830、7840、7850、7870 | 集群TCP通信端口 |
4. 准备组件节点服务器
项目中需要至少存在一个组件节点，用于部署新增的集群组件。
注1：本文方案，仅支持对接容器化部署的集群组件，不支持自备集群组件进行对接扩容。
如需对接自备集群组件，请在切换集群完毕后，前往「项目管理>维护>集群管理」中配置。详情请参见：集群管理
注2：由于各个项目的情况不一致，因此需要一步步判断是否需要安装组件、是否需要准备服务器，请务必逐步确认。
4.1 判断是否需要准备组件服务器
1）进入架构变更界面
管理员登录运维平台，点击「维护中心>架构变更>单机切换集群架构」，选择目标项目。
2）判断是否需要新增集群组件
点击组件配置的「配置」。查看内容：
如弹出框存在待配置组件，说明需要部署相关集群组件，进行下一步判断。
如弹出框为空，说明在「项目管理>维护>组件管理」中已增加了全部集群组件，无需新增集群组件，无需准备组件服务器，直接跳到第五章节即可。
3）判断是否存在可用组件节点
点击组件节点的下拉按钮，查看组件节点。
如节点全部灰化，无可选节点，说明该项目中没有可用的组件节点，必须准备一台服务器。
如存在可选节点，说明该项目中已经准备了组件服务器，无需额外准备组件服务器，直接跳到第五章节即可。
4.2 组件服务器配置要求
根据 4.1 节判断：
如仅需部署集群组件，无需重新准备组件服务器
| 确认项 | 说明 |
|---|---|
| 确认组件端口 | 请根据组件配置中需要部署的组件，确认各个组件的映射端口是否已被使用 如已被使用，请安排好其他空闲端口 FineBI：确认FineBI项目服务器网络 FineReport：确认FineReport项目服务器网络 FineDataLink：确认FineDataLink项目服务器网络 |
如需部署集群组件且需新增组件节点
| 确认项 | 说明 |
|---|---|
| 准备组件服务器 | 请参考文档，准备符合配置要求的组件服务器和服务器用户 FineBI：确认FineBI项目服务器配置 FineReport：确认FineReport项目服务器配置 FineDataLink：确认FineDataLink项目服务器配置 |
| 准备挂载目录 | 请参考文档，准备合适的组件挂载目录 FineBI：准备FineBI项目挂载目录 FineReport：准备FineReport项目挂载目录 FineDataLink：准备FineDataLink项目挂载目录 |
| 确认组件端口 | 请根据组件配置中需要部署的组件，确认各个组件的映射端口是否已被使用 如已被使用，请安排好其他空闲端口 FineBI：确认FineBI项目服务器网络 FineReport：确认FineReport项目服务器网络 FineDataLink：确认FineDataLink项目服务器网络 |
| 确保9070端口空闲 | 请确保组件服务器的9070端口未被占用 ops_agent组件需要占用该端口，不支持修改 |
5. 单机切换集群架构
5.1 选择目标项目
1）管理员登录运维平台，点击「维护中心>架构变更>单机切换集群架构」。
2）支持选择运维平台对接的、运维平台部署的、单机类型的项目
5.2 选择/新增组件节点
如有可选组件节点，直接选择即可
如4.2节准备了全新组件服务器，请点击「+新增组件节点」，输入以下信息
| 节点设置 | 说明 |
|---|---|
| 主机 | 请输入节点主机IP（内网IP） 注：同一项目中，主机不支持重复添加多次 |
| 端口 | 请输入节点端口号，默认为22 |
| 用户名 | 请输入有sudo权限的服务器用户名 |
| 验证方法 | 支持两种：密码、公钥 |
| 挂载路径 | 请输入节点安装目录的服务器路径，即前置准备环节设置的挂载目录 默认为~/data，~代表所使用的服务器用户的主目录 注：可在终端使用该用户账号访问服务器，输入echo $HOME命令查看该用户的主目录路径 |
| 外网IP | 选填项 如果服务器不支持内网访问，仅支持外网映射，可以填写可联通的外网IP |
5.3 配置集群端口
确认/输入第三章准备的集群端口
这些端口是指fr/bi/fdl主应用所在服务器上的端口
5.4 配置组件配置
确认/输入4.2节准备的各个组件的端口，可对每一个组件的端口、用户名密码进行调整。
注意事项：
1）此处支持添加的组件包括：状态服务Redis、文件服务minio、负载均衡nginx。
2）请务必修改并记住redis、minio组件的密码，这些组件的默认密码随机生成
如忘记相关组件用户名和密码，可通过导出部署信息找回，详情请参见：导出项目部署信息
2）如在「项目管理>维护>组件管理」中已增加了部分集群组件，此处不显示，无需再次添加。
3）此处不支持自备集群组件进行对接。
如需对接自备集群组件，请在切换集群完毕后，前往「项目管理>维护>集群管理」中配置。详情请参见：集群管理
4）这些端口是指所选组件节点服务器上的端口
5.5 开始变更
点击「开始变更」，即会对单机工程切换单节点集群。
1）如检测到上文所填任何配置不符合要求，即中断切换，请根据提示重新检查并优化。
2）如集群组件部署失败，或工程与集群组件对接失败，会自动回退，请根据报错重新检查并优化。
3）切换成功后，项目变更为单节点集群。如需增加工程节点，变更为多节点集群，请参考文档：集群运维项目扩容
