这份文档是CLup 6.x 版本 中针对StarRocks 存算一体集群 的完整操作手册，核心分为导入已有集群、新建集群、集群运维管理三大模块，详细定义了 Web 端操作入口、表单参数、配置规则、运维功能及风险提示，以下是逐模块完整解读：
一、导入已有 StarRocks 存算一体集群
该功能用于将线下已部署完成的 StarRocks 存算一体集群，接入 CLup 平台实现统一管控。
1. 操作入口
CLup Web 管理端 → PaaS平台 → 导入集群 → 导入StarRocks存算一体集群。
2. 表单参数及填写规则
弹出配置弹窗后，需填写以下参数（带*为必填项）：
表格
| 参数名称 | 填写说明 | 格式 / 约束 |
|---|---|---|
| 集群名称 | 集群标识，同时作为 CLup 内集群名称 | 自定义 |
| vip 池 | 关联平台网络资源 | 选择「网络管理→VIP 池管理」中已存在的 VIP 池 ID |
| 集群 VIP | 集群对外虚拟 IP | 点击「选择 VIP」，选取 VIP 池内未被占用的 VIP |
| FE 节点 ip 列表 | 集群所有 FE 节点物理 IP | 多 IP 用英文逗号分隔 |
| FE 节点复制 ip 列表 | FE 节点同步复制专用 IP | 多 IP 英文逗号分隔，IP 数量必须与 FE 节点 IP 列表完全一致 |
| fe 节点对外端口 | FE 服务对外访问端口 | 填写实际部署端口 |
| BE 节点 ip 列表 | 集群所有 BE 节点物理 IP | 多 IP 英文逗号分隔 |
| BE 节点复制 ip 列表 | BE 节点同步复制专用 IP | 多 IP 英文逗号分隔，IP 数量必须与 BE 节点 IP 列表完全一致 |
| be 节点端口 | BE 服务访问端口 | 填写实际部署端口 |
| DB 中的用户 | 数据库管理账号 | 需具备超级用户权限（HA 管理使用） |
| DB 中的密码 | 上述超级账号密码 | 对应账号密码 |
| 数据库软件 | StarRocks 程序安装路径 | 示例：/opt/apache-doris-3.1.3 |
| 备注 | 集群补充描述 | 选填，可留空 |
填写完成后点击「提交」即可完成集群导入。
二、创建全新 StarRocks 存算一体集群
该功能用于在 CLup 中从零搭建 StarRocks 存算一体集群，支持两种部署模式 ，操作入口统一为：CLup Web 端 → PaaS平台 → 创建集群 → 创建StarRocks存算一体集群。
模式 1：在已有主机中创建（推荐存量服务器）
适用场景：服务器已预装clup-agent代理程序，直接基于现有主机部署集群。
前置约束
- 主机必须运行
clup-agent； - FE、BE 部署阶段均至少选择 2 台主机 ，列表中第一个主机默认为主库。
完整流程（分 3 步配置）
步骤 1：FE 节点部署
填写主机及节点基础配置，核心参数说明：
- 主机 / 复制 ip：二者一一对应，多节点按行填写；
- 操作系统用户 / UID：填写服务器系统用户，存在则自动识别 UID；
- 数据库软件目录：选择 StarRocks 安装目录，选中后自动识别版本；可在
系统管理→CLUP参数设置配置软件检索路径； - 数据目录：数据库元数据存储目录，目录必须为空，不存在时平台自动创建；
- JAVA_HOME：选择匹配当前 StarRocks 版本的 JDK 路径；
- FE 节点类型：二选一，
FOLLOWER（跟随节点）、OBSERVER（观察者节点）； - 优先级：节点权重，自定义数值；
- 复制配置：一键将主节点配置同步至当前从节点。
配置完成点击「下一步」。
步骤 2：BE 节点部署
配置逻辑与 FE 节点基本一致，无节点类型选项，核心要求不变：
- 至少选择 2 台主机，首台为主库；
- 数据目录为 BE 数据存储目录，要求空目录；
- 支持「复制配置」同步主节点参数。
配置完成点击「下一步」。
步骤 3：集群基础信息配置（最终提交页）
表格
| 参数 | 说明 | 默认值 |
|---|---|---|
| 集群名称 | CLup 内集群唯一名称 | 自定义（必填） |
| vip 池 / 集群 vip | 关联网络 VIP 资源 | 必选未占用 VIP |
| fe 节点对外端口 | FE 服务端口 | 9030 |
| be 节点端口 | BE 服务端口 | 9060 |
| DB 中的用户 | 数据库超级管理员账号 | root（必填） |
| DB 中的密码 | 超级账号密码 | 自定义（必填） |
| 备注 | 集群描述 | 选填 |
补充说明
- 集群创建为异步后台任务，不会即时完成；
- 进度、报错日志查看路径：
PaaS平台→日志管理。
模式 2：创建新虚拟机承载集群（全新虚拟化环境）
适用场景：无现成服务器，需先创建虚拟机，再在虚拟机内部署集群。
前置约束
- 需提前配置PaaS 模板 ，且模板的
PaaS类型必须设置为Yashan； - FE、BE 节点部署仍要求至少 2 台虚拟机。
完整流程（分 4 步配置）
步骤 1：虚拟机部署配置
先批量创建虚拟机，支持表格右上角+/-增减虚拟机行数，核心参数：
- 模板：选择提前配置的 Yashan 类型 PaaS 模板；
- 所在宿主机：虚拟机挂靠的物理宿主机；
- IP：虚拟机 IP（多网卡场景下，第一个 IP 为主 IP，用于安装 clup-agent）；
- 内存 / CPU：分配虚拟机资源，单位分别为 MB、核；
- 数据库软件 bin 目录 / 版本：选择 StarRocks 安装目录与对应版本；
- JAVA_HOME：匹配 StarRocks 的 JDK 路径；
- 复制配置：同步主虚拟机配置。
步骤 2：FE 节点部署
以新建虚拟机作为集群主机，配置项与「已有主机模式」的 FE 部署一致：复制 IP、系统用户、UID、元数据目录、FE 节点类型、优先级、复制配置等，首台虚拟机默认为主库。
步骤 3：BE 节点部署
配置项与「已有主机模式」的 BE 部署一致，重点保证数据目录为空。
步骤 4：集群基础信息配置
表单、默认端口、账号规则、异步任务规则完全等同于已有主机模式，填写完成点击「提交」即可。
三、StarRocks 存算一体集群运维管理
集群创建 / 导入完成后，可在集群列表进入详情页 开展日常管控，入口：集群管理 → 对应 YashanDB 集群行 → 详情。详情页分为6 个标签页，各页面功能及操作如下：
1. 集群信息标签页
- 核心功能：展示集群全局基础信息，支持修改数据库账号、密码（修改后同步至集群所有数据库实例）；
- ⚠️ 高危警告：修改
VIP、数据库目录等底层关键配置仅会更新 CLup 平台配置，不会同步修改集群真实服务配置，极易引发故障，非必要禁止操作； - 操作：修改后点击「保存修改」生效。
2. 主备数据库标签页（核心运维页）
- 列表展示字段：数据库 ID、主备从属关系、HA 状态、节点角色（FE Master/FE Follower/BE）、所在机器 / 机房、复制 IP、数据目录、运行状态；
- 节点单例操作：对单个节点执行
停止、移除； - 集群扩容 / 纳新（顶部专属功能）：
- 已有节点纳入集群：将线下闲置节点加入当前集群；
- FE 节点扩容：新增 FE 节点，提升集群元数据能力与高可用；
- BE 节点扩容：新增 BE 节点，扩展存储与计算能力。
3. 机房配置标签页
- 展示内容：机房 ID、机房名称、绑定 VIP、只读 VIP、资源使用状态、均衡器列表；
- 可执行操作：对已有机房配置进行
修改、移除。
4. 节点状态标签页（实时监控）
分为两大独立列表，实时监控节点运行状态：
（1）FE 节点列表
展示：主机 IP、端口、角色（LEADER 主节点 / FOLLOWER 跟随节点）、日志回放 ID、是否主节点、运行状态（UP代表正常运行）。
（2）BE 节点列表
展示：主机 IP、端口、数据使用容量、运行任务数、数据表数量、运行状态（UP代表正常运行）。
5. 数据库拓扑图标签页
以图形化形式直观展示集群内所有数据库节点的级联、主备架构关系，便于梳理集群架构。
四、全局通用约束与关键总结
- IP 格式规则 ：FE/BE 节点 IP、复制 IP 均使用英文逗号分隔，且「节点 IP 列表」与「复制 IP 列表」数量必须一一对应；
- 目录硬性要求 ：所有数据 / 元数据目录必须为空，目录不存在时平台自动创建；
- 权限要求 ：数据库管理账号必须拥有超级用户权限 ，默认管理员账号为
root； - 节点数量下限 ：无论导入还是创建集群，FE、BE 部署均至少 2 个节点，首个节点默认作为主库；
- 默认端口：FE 对外端口默认 9030，BE 端口默认 9060；
- 任务日志 ：集群创建、扩容等后台异步任务，日志统一在
PaaS平台 → 日志管理查看； - 虚拟机模板要求 ：新建虚拟机集群时，PaaS 模板的类型必须为
Yashan，否则无法部署； - 高危操作红线：严禁随意修改集群 VIP、数据目录等底层配置，该操作仅改动 CLup 配置，不同步集群真实环境。
https://www.csudata.com/clup/manual