升级过程中有两类任务:一类要人手动点,一类在启动后自动跑。两类任务的约束条件完全不同,混在一起排,最容易出现“以为点完了,其实回填还在跑”的情况。
两类任务的分工
v4.17.2 的两项手动迁移处理旧知识库训练任务与索引重建状态,前一项完成后才能执行后一项。v4.17.3 的三项回填则在启动所需任务及依赖完成后自动开始。升级时先按当前版本和目标版本确定适用步骤,并在管理页查看每个任务的状态。
执行顺序矩阵
| 阶段 | 任务 | 前置条件 | 失败后 |
|---|---|---|---|
| v4.17.2 手动迁移 | 迁移旧版知识库训练任务 | 集群内旧版本 App 与 Pro 已停止,旧任务租约约两小时过期 | 不能跳过,修正后重做 |
| v4.17.2 手动迁移 | 迁移索引重建状态 | 上一项已完成 | 页面会拦住并提示前置任务 |
| v4.17.3 自动回填 | 沙盒团队归属 | 启动依赖完成 | 修数据后从管理页重试 |
| v4.17.3 自动回填 | 目录祖先路径 | 启动依赖完成 | 同上 |
| v4.17.3 自动回填 | 系统模型价格 | 启动依赖完成 | 修数据后重试,未完成前按免费处理 |
两项手动任务在页面上的排列是倒序的,第二项显示在上面,按顺序从上往下点会点反。判断依据是任务名称,不是位置。
维护窗口与回填观察
执行 v4.17.2 手动迁移前,确认集群中旧版本 App 与 Pro 已停止,旧任务租约已过期。文档给出的约两小时指旧任务租约,维护窗口还要计入实际的迁移、验证及回退时间。
v4.17.3 后台回填在启动依赖完成后共享最多三个并发名额。逐项记录完成、失败和重试状态。计费验收前单独确认系统模型价格已经写入 pricing,避免把尚未迁入的模型当作正常零金额用量。
数据来源
| Source | Version | Document |
|---|---|---|
| FastGPT | v4.17.3 | self-host/upgrading/4-17/4173 |
| FastGPT | v4.17.2 | self-host/upgrading/4-17/4172 |