跳到主要内容
主机与集群管理

集群管理

创建集群定义、纳管已有进程或一键安装,完成节点启停,以及版本升级与配置合并。

Web UI 打开 集群管理。列表可按运行中、部署中、已停止筛选;卡片显示部署模式、节点数和版本,可以进入详情或停止集群。

创建集群只登记名称、版本和部署模式,不会启动 SeaTunnel 进程。你还需要接入一台在线主机,再选择纳管已有进程或一键安装。

选择接入方式​

路径什么时候用接下来做什么
纳管已有进程主机上已经运行 SeaTunnel创建集群和节点,发现进程后绑定
一键安装要在主机上安装新的 SeaTunnel 集群准备安装包,选择主机和角色,预检后安装

部署模式与状态​

概念取值 / 默认说明
部署模式混合 / 分离混合:Master+Worker 同进程;分离:独立 Master / Worker 进程
节点角色Master、Worker、Master/Worker混合模式常用 Master/Worker
集群状态已创建 → 部署中 → 运行中 / 已停止 / 异常刚创建时为「已创建」
节点状态待部署 / 安装中 / 运行中 / 已停止 / 异常;还可能显示离线离线表示该节点所在主机的 Agent 不在线
默认端口Master 通信 5801、API 8080、Worker 通信 5802可按节点覆盖

纳管已有进程​

  1. 集群管理 → 创建集群:名称、混合或分离、SeaTunnel 版本。
  2. 添加节点:指定在线主机、角色、安装目录与端口(默认可按上表)。
  3. 在主机或节点操作里触发发现(Agent 扫描本机 SeaTunnel 进程)。
  4. 确认绑定后,节点应显示进程 PID 与实际安装目录。
提示

同机多进程时,务必核对角色与端口,避免把 Worker 绑到 Master 节点记录上。

一键安装​

Web UI 的安装包管理中需要有目标版本的安装包。可以先上传,也可以下载;需要的连接器见插件市场。

典型流程:

  1. 选择目标主机与角色(分离模式至少区分 Master / Worker)。
  2. 点击 预检,检查安装目录是否可写、端口是否被占用。
  3. 提交安装:推包 → 解压到安装目录 → 写入集群发现配置 → 按角色启动。
  4. 在 Web UI 查看安装进度;失败可 重试 / 取消。

版本升级​

集群详情打开 升级(也可在详情的 升级记录 里查看历史任务)。流程分三步:准备升级 → 配置合并 → 执行升级。

准备升级​

  1. 选择 目标版本,确认 目标安装目录(默认可按版本推导)。
  2. 在安装包管理备好目标版本安装包;在插件市场备好目标版本所需插件。缺包或缺插件时,界面会提示前往补齐。
  3. 点 运行预检查。通过后进入 配置合并;若改过目标版本或目录,需 重新运行预检查。

升级时会切到目标版本的 connector JAR,并按本地已准备的目标版本插件增量叠加 lib / plugins 依赖;安装包自带的同名基础 JAR 会保留。

配置合并​

页面标题为 配置差异处理。系统对比当前集群配置与目标版本配置;不会自动替你决定冲突行该用哪一边。

区域作用
配置文件列表按文件切换;有差异的文件带数量标记,无差异会标明
旧版本配置当前集群生效的内容;可 整份采用旧版本
最终合并结果将下发的最终配置;可直接编辑
新版本配置目标版本提供的内容;可 整份采用新版本

有冲突的行可点 采用旧值 / 采用新值。全部差异处理完后,才能 生成升级计划。

部分文件若两边无真实冲突,系统可能自动合并并提示原因;仍需你确认整体结果。只要还有 待选择 / 需要明确选择 的项,就不能生成计划。

执行升级​

生成计划后核对版本、安装包、节点目标与步骤,再 启动升级执行。执行页可看:

面板说明
完成比例当前任务整体进度
执行详情步骤树 或 节点执行状态
日志面板按步骤、级别、节点过滤持久化日志

常见收尾步骤包括健康检查、可用性验证与完成。任务结束后可在集群详情的 升级记录 再次打开执行详情;也可基于同一计划 重新执行(会新建任务,旧任务日志保留)。

升级前

对关键同步作业先做 Savepoint 或暂停,再启动升级,便于失败或回退后恢复位点。

日常运维​

在集群详情 / 节点列表可对 整集群 或 单节点 做:

操作说明
启动 / 停止 / 重启经 Agent 下发
查看日志拉取节点侧引擎日志,便于排启停与作业异常
加节点支持单台添加与同机批量添加;添加前可预检
删节点 / 删集群先查看正在运行的作业;主机仍关联集群节点时,不能从主机管理删除
升级见上文「版本升级」
停集群前

对关键同步作业先做 Savepoint 或暂停,再执行停止 / 滚动重启,保留恢复位置。

和主机管理的边界​

  • 主机:机器 + Agent 是否连通、资源心跳
  • 集群:SeaTunnel 拓扑与进程生命周期
  • 节点是否可操作,同时取决于节点状态与主机是否在线