文档信息文档名称CLup 6.x Apache Doris 存算一体集群部署与运维指南适用版本CLup 数据库管理系统 6.0.8beta1 企业版适用人群数据库运维工程师、云平台管理员、大数据集群运维人员文档用途指导外部用户在 CLup 平台完成存量 Doris 存算一体集群导入、全新 Doris 集群创建、集群全生命周期运维等操作明确操作规范、参数释义与高危风险点。关联组件Apache Doris存算一体架构、clup-agent、CLup PaaS 模块、VIP 网络池一、功能概述CLup 6.x 版本新增Apache Doris 存算一体集群专项管理能力依托平台可视化 Web 界面实现 Doris 集群一站式管控核心能力分为三大模块集群导入将线下已部署完成的 Apache Doris 存算一体集群接入 CLup实现多集群统一纳管、集中监控集群创建支持两种部署模式从零搭建 Doris 集群兼容存量物理主机与全新虚拟机环境自动化完成 FE/BE 节点配置、目录初始化、服务部署集群运维提供集群信息管理、主备节点管控、机房配置、节点状态监控、拓扑视图、节点扩容等全流程运维能力同时支持主备复制状态检测。该功能架构逻辑与 CLup 中 StarRocks 存算一体集群管理模块相近针对 Apache Doris 的服务端口、目录规范、节点角色做了专属适配大幅降低 Doris 集群运维复杂度。二、前置环境与资源准备在执行集群导入、创建操作前需提前完成环境校验与资源配置所有前置条件缺一不可。2.1 基础软件与服务CLup 平台正常运行Web 管理端可正常访问若使用存量物理主机部署集群目标主机已安装并启动clup-agent代理服务CLup 与主机通信的核心组件目标主机 / 虚拟机预装对应版本 Apache Doris 安装包、匹配版本的 JDKJAVA_HOME 需提前配置。2.2 网络资源配置提前在 CLup 平台网络管理 → VIP池管理中创建 VIP 池并预留未被占用的 VIP 地址集群对外访问依赖 VIP主机 / 虚拟机防火墙放行默认端口FE 对外端口9030、BE 端口9060若自定义端口需同步放行对应端口。2.3 虚拟机模板准备仅虚拟机部署模式需要若选择 “创建新虚拟机承载集群”需提前在 CLup 中配置 PaaS 模板模板的 PaaS 类型必须设置为 Yashan模板内预设虚拟机操作系统、硬件规格、软件路径等基础配置。2.4 账号与权限Apache Doris 数据库提前创建超级管理员账号默认推荐root该账号需拥有数据库最高权限用于 CLup 后台管理记录管理员账号、密码后续导入 / 创建集群时必填。2.5 通用硬性约束单集群 FE 节点、BE 节点部署数量最少为 2 台平台默认将第一个添加的节点作为主库数据库元数据目录、数据目录要求为空目录目录不存在时 CLup 会自动创建。三、存量 Doris 存算一体集群导入当线下已存在运行中的 Apache Doris 存算一体集群可通过「导入集群」功能将其接入 CLup 统一管理。3.1 操作入口登录 CLup Web 管理端 → 顶部导航栏进入PaaS平台→ 点击导入集群→ 选择导入Doris存算一体集群弹出配置表单。3.2 表单参数详解带 * 为必填项表格参数名称填写规则与说明格式约束* 集群名称自定义集群标识同时作为 CLup 内部集群名称字符无特殊限制建议与线下集群名称保持一致*vip 池选择提前配置好的 VIP 池 ID下拉选择取自「网络管理→VIP 池管理」* 集群 VIP集群对外虚拟 IP点击「选择 VIP」仅可选择 VIP 池内空闲 VIP*fe 节点 ip 列表线下所有 FE 节点物理 IP多 IP 使用英文逗号分隔*fe 节点复制 ip 列表FE 节点数据同步专用 IPIP 数量必须与fe节点ip列表完全一致英文逗号分隔*fe 节点对外端口Doris FE 服务访问端口线下集群实际端口默认 9030*be 节点 ip 列表线下所有 BE 节点物理 IP多 IP 英文逗号分隔*be 节点复制 ip 列表BE 节点数据同步专用 IPIP 数量必须与be节点ip列表完全一致英文逗号分隔*be 节点端口Doris BE 服务访问端口线下集群实际端口默认 9060*DB 中的用户Doris 超级管理账号HA 后台使用必须具备超级权限默认 root*DB 中的密码上述管理员账号密码与数据库实际密码一致* 数据库软件Apache Doris 安装根目录示例/opt/apache-doris-3.1.3备注集群补充描述、环境说明选填可留空3.3 操作步骤按照集群实际信息逐项填写表单重点核对 IP 列表、复制 IP 数量、软件路径、账号密码确认 VIP 为未使用状态、端口与线下集群匹配点击提交完成集群导入导入成功后集群会展示在 CLup 数据库集群列表中。3.4 注意事项FE/BE 节点 IP 与对应复制 IP数量必须一一对应否则导入直接失败数据库软件路径需填写绝对路径保证 CLup 可正常读取 Doris 程序文件导入失败可查看PaaS平台 → 日志管理排查网络、权限、IP 配置问题。四、全新 Doris 存算一体集群创建CLup 支持两种集群创建模式用户可根据自身基础设施现状选择统一入口为PaaS平台 → 创建集群 → 创建Doris存算一体集群。4.1 模式一在已有主机中创建集群适用场景企业已有物理服务器且服务器已部署clup-agent直接基于存量主机部署 Doris 集群部署效率高、资源利用率优。整体流程分为三大阶段FE 节点部署 → BE 节点部署 → 集群基础信息提交。阶段 1FE 节点部署进入创建页面后选择「在已有主机中创建数据库集群」点击下一步进入 FE 配置页主机选择至少选择 2 台运行clup-agent的主机首个主机自动设为 FE 主库逐行填写节点配置核心参数说明复制 ip与主机 IP 一一对应用于节点数据同步操作系统用户 / UIDDoris 运行系统用户示例dorisUID 默认 901用户存在时平台自动识别 UID数据库软件目录选择主机上的 Doris 安装目录选中后自动识别软件版本可在系统管理→CLUP参数设置中通过yashan_bin_path_string批量配置软件检索路径支持英文逗号分隔、通配符*数据目录FE 元数据存储目录必须为空JAVA_HOME选择与当前 Doris 版本匹配的 JDK 路径FE 节点类型二选一FOLLOWER跟随节点、OBSERVER观察者节点优先级节点权重自定义数值复制配置一键将主节点配置同步至当前从节点简化重复配置工作。所有节点配置完成后点击下一步。阶段 2BE 节点部署进入 BE 配置页规则与 FE 节点基本一致至少选择 2 台主机首个主机为 BE 主库核心差异BE 节点无节点类型选项数据目录为 Doris 实际业务数据存储目录要求空目录可使用「复制配置」功能同步主节点参数填写完成后点击下一步。阶段 3集群基础信息提交最终步骤填写集群全局配置均为必填项备注除外表格参数配置说明默认值集群名称CLup 内集群唯一名称自定义vip 池 / 集群 vip选择 VIP 池及空闲 VIP必选fe 节点对外端口FE 服务端口9030be 节点端口BE 服务端口9060DB 中的用户Doris 超级管理员rootDB 中的密码管理员账号密码自定义备注集群说明选填核对所有参数无误后点击提交。补充说明集群创建为后台异步任务不会即时完成实时进度、报错日志查询路径PaaS平台 → 日志管理。4.2 模式二创建新虚拟机承载集群适用场景全新虚拟化环境无存量可用物理主机CLup 可一站式完成「虚拟机创建 Doris 集群部署」。前置要求已配置Yashan 类型的 PaaS 虚拟机模板。整体流程分为四大阶段虚拟机部署 → FE 节点部署 → BE 节点部署 → 集群信息提交。阶段 1虚拟机部署配置选择「创建新虚拟机以容纳此数据库集群」进入虚拟机配置页表格操作点击右上角新增虚拟机行、-删除末尾虚拟机行至少创建 2 台虚拟机虚拟机参数配置模板选择提前配置的 Yashan 类型 PaaS 模板核心约束非 Yashan 模板无法部署所在宿主机虚拟机挂靠的物理宿主机IP虚拟机 IP多网卡场景下第一个 IP 为主 IP用于安装 clup-agent内存大小 (MB)、CPU 核数按需分配虚拟机硬件资源数据库软件 bin 目录 / 版本选择 Doris 安装目录与对应版本JAVA_HOME匹配 Doris 版本的 JDK 路径复制配置同步主虚拟机配置至其他虚拟机。配置完成后点击下一步。阶段 2FE 节点部署以新建虚拟机作为集群主机配置规则、参数项、约束条件与「存量主机模式」的 FE 部署完全一致主机数量≥2、数据目录为空、支持节点类型选择与配置复制。完成后点击下一步。阶段 3BE 节点部署基于新建虚拟机配置 BE 节点规则同存量主机模式重点保证数据目录为空配置完成后点击下一步。阶段 4集群基础信息提交表单内容、默认端口、账号规则、异步任务规则完全等同于存量主机创建模式填写完成提交即可。五、Doris 存算一体集群日常运维管理集群导入 / 创建完成后在 CLup数据库集群列表中点击目标集群右侧详情进入集群运维详情页。详情页包含7 个功能标签页覆盖信息查看、配置修改、节点管控、监控、扩容等全运维场景。5.1 集群信息核心功能展示集群全局基础配置集群 ID、VIP、端口、账号等配置修改支持修改 Doris 数据库管理员账号与密码修改后全局同步至集群所有节点⚠️ 高危警告重点禁止修改 VIP、数据库目录、软件路径等核心底层配置。此类操作仅会更新 CLup 平台本地配置不会同步到真实 Doris 集群会直接导致集群失联、服务异常、数据损坏等严重故障普通配置修改后点击保存修改生效。5.2 主备数据库核心运维页面列表展示数据库 ID、上级主库、HA 状态、节点角色FE Master/FE Follower/BE、所在机器、机房、流复制 IP、数据目录、运行状态等核心信息单节点操作对单个节点执行启动、停止、移除操作集群扩容顶部专属功能支持三大扩容场景满足业务增长需求已有节点纳入集群将线下闲置主机 / 虚拟机加入当前 Doris 集群FE 节点扩容新增 FE 节点提升集群元数据管理能力与高可用能力BE 节点扩容新增 BE 节点扩展集群存储与计算能力。5.3 复制状态专属 Doris 主备集群监控页面用于查看主库与备库之间的数据复制延迟、同步状态快速判断主从链路是否正常、是否存在同步卡顿。5.4 机房配置展示内容机房 ID、机房名称、集群绑定 VIP、只读 VIP、资源使用状态、均衡器列表支持操作对已有机房配置执行修改、移除适用于多机房集群架构调整。5.5 节点状态实时监控分为两大独立列表实时监控节点运行状态是日常巡检核心页面FE 节点列表展示主机 IP、端口、节点角色、已重放日志 ID、是否为主节点、运行状态UP代表节点正常运行BE 节点列表展示主机名、端口、数据容量使用率、运行任务数、存储表数量、运行状态直观查看节点负载与存储情况。5.6 数据库拓扑图以图形化视图展示集群整体架构、节点级联关系、主备层级便于运维人员梳理集群架构、定位故障节点。六、通用规范、约束与风险汇总结合全流程操作整理硬性规范、配置约束与高危操作红线作为日常操作准则IP 配置规范FE/BE 节点 IP 列表与对应复制 IP 列表必须使用英文逗号分隔IP 数量严格保持一致否则导入、创建均会失败。节点数量约束FE、BE 部署阶段主机 / 虚拟机数量最低为 2 台平台自动将首个节点设为主库生产环境建议部署奇数节点提升高可用。目录约束FE 元数据目录、BE 业务数据目录必须为空目录不存在时 CLup 自动创建禁止使用已有数据目录部署集群。账号权限约束Doris 管理账号必须具备超级用户权限推荐使用默认账号root权限不足会导致集群管控失败。虚拟机模板约束虚拟机部署模式下PaaS 模板的 PaaS 类型必须为Yashan这是前置硬性要求。任务与日志约束集群创建、导入、扩容均为后台异步任务故障排查、进度查询统一查看PaaS平台 → 日志管理。高危操作红线重中之重严禁修改集群 VIP、数据目录、Doris 软件路径等底层核心配置该操作仅修改 CLup 配置不同步真实集群极易引发生产事故。端口规范默认端口FE 9030、BE 9060自定义端口需提前放行防火墙并保证全集群端口统一。七、典型使用场景与操作建议结合企业不同基础设施现状给出场景化操作选型建议场景 1存量线上 Doris 集群分散运维选型使用「导入 Doris 存算一体集群」将多套 Doris 集群统一接入 CLup依托平台集中监控、主备管理能力简化运维。场景 2企业存量物理服务器已部署 clup-agent选型选择「在已有主机中创建集群」无需额外创建虚拟机部署速度快、硬件资源利用率最高推荐生产环境使用。场景 3全新虚拟化数据中心无存量物理主机选型选择「创建新虚拟机承载集群」利用 CLup 虚拟机编排能力一站式完成虚拟机创建、集群部署适配云化架构。场景 4Doris 集群业务量上涨存储 / 计算不足选型进入「主备数据库」页面执行 FE/BE 节点扩容横向扩展集群能力。八、常见故障排查指引针对实操中高频问题提供快速排查思路问题 1集群创建长时间卡在后台无完成提示排查进入PaaS平台 → 日志管理查看异步任务日志。常见原因clup-agent 服务异常、主机网络不通、JDK/Doris 版本不匹配、目录权限不足。问题 2集群导入失败排查核对 IP 与复制 IP 数量、VIP 是否被占用、Doris 软件绝对路径是否正确、管理员账号权限是否为超级权限。问题 3节点状态页面显示非UP排查检查主机网络连通性、防火墙端口是否放行、Doris FE/BE 进程是否正常启动。问题 4主备复制延迟过高、同步异常排查进入「复制状态」页面查看延迟数据检查节点复制 IP 连通性、Doris 主备同步配置。问题 5虚拟机创建 / 部署失败排查核对 PaaS 模板 PaaS 类型是否为 Yashan、宿主机资源是否充足、虚拟机 IP 是否网段冲突。九、总结CLup 6.x 对 Apache Doris 存算一体集群的全生命周期管理能力覆盖集群导入、自动化部署、实时监控、节点扩容、主备管控等核心场景同时提供两种部署模式完美适配物理机、虚拟化等不同基础设施环境。对于外部运维团队而言该可视化平台替代了传统手动部署、逐节点运维的模式大幅降低 Apache Doris 集群的运维门槛。在日常操作中需严格遵守 IP、目录、权限等硬性规范坚决规避修改 VIP、数据目录等高危操作遇到异常优先通过平台日志定位问题保障 Doris 集群稳定运行。CLup6.x产品手册CLup简介CLup软件是专为PostgreSQL、PolarDB等数据库实现了高可用(包括读写分离)集群功能和基础监控管理以及备份恢复平台软件本章介绍CLup简介https://www.csudata.com/clup/manual