跳到主要内容
版本：2.3.13

SeaTunnel Engine(Zeta) 版本升级

本文档说明如何以受控方式升级已有的 SeaTunnel Engine 环境。如果您要从零开始部署新环境，请先阅读 SeaTunnel Engine(Zeta) 安装部署。

升级前准备​

在开始升级前，建议先确认以下事项：

  1. 阅读不向前兼容的更新，确认目标版本是否引入了会影响作业、监控或集成脚本的破坏性变更。
  2. 记录当前部署模式、集群名、端口配置、连接器列表、JDBC 驱动以及自定义启动参数。
  3. 在替换安装包或镜像前，先备份 config/、connectors/、plugins/、自定义脚本以及部署清单。
  4. 将目标版本准备在新的目录、镜像 tag 或独立发行包中，避免直接原地覆盖正在运行的安装目录。

步骤 1：保护运行中的作业​

如果当前环境中存在有状态或长时间运行的作业，升级前需要先保护它们的运行状态。

  • 对依赖 checkpoint 或 savepoint 恢复的作业，建议在停止旧版本前先创建 savepoint 或完成可恢复暂停。
  • 对可以从源端安全重跑的作业，也建议在停止前记录作业配置和当前运行状态。

--savepoint 和 --restore 的命令用法可参考客户端命令行工具。

步骤 2：替换安装包和依赖​

在运行状态保护完成后，再升级各节点上的 SeaTunnel 安装包或容器镜像。

  • 确认目标版本所需的连接器 JAR 和 JDBC 驱动已经同步到位。
  • 在重启前重新核对 JVM 参数、日志配置、集群配置以及自定义启动脚本。
  • 如果这次升级还伴随部署拓扑调整，请结合 SeaTunnel Engine(Zeta) 安装部署 重新确认目标架构。

步骤 3：重启并验证​

完成新版本安装后，不要立即恢复全部正式流量，建议先做验证。

  1. 启动升级后的本地服务或集群节点。
  2. 先提交一个小型验证任务。
  3. 检查作业提交、作业列表、日志和监控信息是否正常。
  4. 只有在验证任务通过后，再恢复或重启关键作业。

步骤 4：验证失败时回滚​

如果升级后的环境未通过验证：

  1. 先停止或隔离新版本环境。
  2. 恢复旧版本安装包、配置备份和必要依赖。
  3. 使用之前已经验证过的稳定环境恢复或重新提交关键作业。

相关文档​