先看版本通道

确认目标是 stable,不要把 Pre-release 当正式版。

再阅读当前版本到目标版本之间的说明。

运行迁移报告

主版本升级先处理所有 critical 项。

记录需要改变的节点、变量和执行方式。

完整备份

备份数据库、加密密钥、凭据配置、工作流和二进制文件。

只导出工作流 JSON 并不等于完整备份。

复制测试环境

在隔离实例恢复备份并执行升级。

不要拿生产数据库做第一次实验。

跑回归测试

测试 Webhook、定时任务、Code、AI、文件、子工作流和错误通知。

对照升级前的固定样本与结果。

安排发布窗口

暂停必要流程,通知负责人并保留回滚时间。

升级后观察队列、错误率和执行时间。

准备回滚

明确怎样恢复旧镜像与旧数据库。

主版本数据迁移可能不可逆,回滚必须依赖升级前备份。