杭州,2026年11月3日——FastGPT v4.17.2官方升级指南列出了镜像更新与手动迁移要求,明确本次升级包含镜像 tag 更新与两个手动触发的数据迁移脚本。文档提示,迁移脚本不阻塞服务启动,但执行时机与集群停机状态、旧任务租约到期情况相关,运维人员需按顺序确认后再操作。

镜像更新与升级入口
本次升级首先涉及镜像 tag 的更新,fastgpt-app(FastGPT 主服务)与 fastgpt-pro(FastGPT 商业版)均需更新至 v4.17.2。镜像更新完成后,升级脚本可在管理后台的“管理员 > 版本升级”页面查看与执行。文档说明,本次包含的两个脚本均属于手动触发任务,不会阻塞服务启动,因此运维人员可以在服务运行期间查看脚本状态,但正式执行前需要结合集群实际情况判断时机。建议在升级窗口内先完成镜像替换,再进入后台核对脚本列表与版本号,避免在镜像未更新时提前触发迁移逻辑,导致新旧数据结构不一致。
两个迁移脚本的依赖关系
第一个脚本为历史分块训练任务迁移(20261008_migrate_chunk_training),作用是把存量旧版 chunk 训练任务平滑转换为关联正式数据行的新模式。文档要求,在确认集群中所有旧版本 FastGPT App 与 Pro 实例已完全停止、旧任务租约过期之后,再点击执行。第二个脚本为知识库重建状态迁移(20261009_migrate_dataset_rebuild_status),它依赖第一个脚本完成,把历史知识库数据行中的旧版 rebuilding 标记和过渡状态统一迁移至全新的 indexStatus 重建状态体系。两个脚本存在先后依赖,跳过第一步直接执行第二步会缺少必要的数据前提,因此执行顺序需要严格保持。
停机确认与租约检查
执行第一个脚本前的关键动作是确认集群状态。文档给出的条件是:所有旧版本 FastGPT App 与 Pro 实例已完全停止,并且旧任务租约过期。这意味着运维人员需要先完成实例下线,再等待租约自然到期或按既有机制处理,随后才进入“管理员 > 版本升级”点击执行。由于脚本属于手动触发、不阻塞服务启动,容易出现服务已升级但脚本尚未执行、或脚本在实例未完全停止时被触发的中间状态。建议在升级流程中设置明确的检查点,记录实例停止时间与租约到期时间,确认无误后再推进到脚本执行环节。
脚本执行完成后,需要核验训练任务是否已关联到正式数据行,以及知识库数据行的重建状态是否已统一到 indexStatus 体系。
资料来源:《FastGPT v4.17.2 升级指南》。
关于 FastGPT
FastGPT 是一款开源的组织级 AI 应用平台,提供知识库检索与可视化工作流编排等能力,可按实际需要组织资料输入、模型调用及外部接口衔接。


粤公网安备 44010602000162号