主机与集群管理
集群管理
创建集群定义、纳管已有进程或一键安装，并完成节点启停与日常运维。
Web UI 打开 集群管理。列表可按运行中、部署中、已停止筛选；卡片显示部署模式、节点数和版本，可以进入详情或停止集群。
创建集群只登记名称、版本和部署模式，不会启动 SeaTunnel 进程。你还需要接入一台在线主机，再选择纳管已有进程或一键安装。
选择接入方式
| 路径 | 什么时候用 | 接下来做什么 |
|---|---|---|
| 纳管已有进程 | 主机上已经运行 SeaTunnel | 创建集群和节点，发现进程后绑定 |
| 一键安装 | 要在主机上安装新的 SeaTunnel 集群 | 准备安装包，选择主机和角色，预检后安装 |
部署模式与状态
| 概念 | 取值 / 默认 | 说明 |
|---|---|---|
| 部署模式 | 混合 / 分离 | 混合：Master+Worker 同进程；分离：独立 Master / Worker 进程 |
| 节点角色 | Master、Worker、Master/Worker | 混合模式常用 Master/Worker |
| 集群状态 | 已创建 → 部署中 → 运行中 / 已停止 / 异常 | 刚创建时为「已创建」 |
| 节点状态 | 待部署 / 安装中 / 运行中 / 已停止 / 异常；还可能显示离线 | 离线表示该节点所在主机的 Agent 不在线 |
| 默认端口 | Master 通信 5801、API 8080、Worker 通信 5802 | 可按节点覆盖 |
纳管已有进程
- 集群管理 → 创建集群：名称、混合或分离、SeaTunnel 版本。
- 添加节点：指定在线主机、角色、安装目录与端口（默认可按上表）。
- 在主机或节点操作里触发发现（Agent 扫描本机 SeaTunnel 进程）。
- 确认绑定后，节点应显示进程 PID 与实际安装目录。
提示
同机多进程时，务必核对角色与端口，避免把 Worker 绑到 Master 节点记录上。
一键安装
Web UI 的安装包管理中需要有目标版本的安装包。可以先上传，也可以下载；需要的连接器见插件市场。
典型流程：
- 选择目标主机与角色（分离模式至少区分 Master / Worker）。
- 点击 预检，检查安装目录是否可写、端口是否被占用。
- 提交安装：推包 → 解压到安装目录 → 写入集群发现配置 → 按角色启动。
- 在 Web UI 查看安装进度；失败可 重试 / 取消。
日常运维
在集群详情 / 节点列表可对 整集群 或 单节点 做：
| 操作 | 说明 |
|---|---|
| 启动 / 停止 / 重启 | 经 Agent 下发 |
| 查看日志 | 拉取节点侧引擎日志，便于排启停与作业异常 |
| 加节点 | 支持单台添加与同机批量添加；添加前可预检 |
| 删节点 / 删集群 | 先查看正在运行的作业；主机仍关联集群节点时，不能从主机管理删除 |
停集群前
对关键同步作业先做 Savepoint 或暂停，再执行停止 / 滚动重启，保留恢复位置。
和主机管理的边界
- 主机：机器 + Agent 是否连通、资源心跳
- 集群：SeaTunnel 拓扑与进程生命周期
- 节点是否可操作，同时取决于节点状态与主机是否在线