Files
deerflow-code/deploy/linux-docker-offline-deerflow-only/docs/07-升级与版本回退.md
T

2.4 KiB

07 升级与版本回退

日常只修改 .py、.tsx、.ts、样式和页面资源时,优先使用 11-只替换前后端源码.md 的源码覆盖层机制。它不传输 Docker 基础层,在部署服务器上基于已保存镜像离线生成很薄的新镜像。

涉及 Compose、部署控制文件或普通镜像增量包时,使用本包自带的通用增量机制,不再解压一套完整基线包:

tar -xzf deerflow-update-*.tar.gz
cd /当前正在使用的DeerFlow部署目录
sudo ./UPDATE_INSTALL.sh --apply /增量包解压目录

增量更新只加载发生变化的镜像并更新白名单控制文件,保留现有 config/deploy.env、JWT 密钥、智能体、custom 技能、知识文件、Docker 卷和旧镜像。详细制作规范、变更分类及校验清单见 09-后续增量更新发版手册.md。

应用时会把旧控制文件备份到 data/updates/backups/。需要回退时:

sudo ./UPDATE_INSTALL.sh --rollback \
  /当前部署目录/data/updates/backups/<对应备份目录>

该操作恢复旧镜像引用和控制文件;不会反向恢复数据库。若新版本执行过不兼容数据库迁移,必须同时恢复升级前数据库备份。

完整基线包切换(仅用于跨大版本或基线损坏)

不同版本完整离线包解压到不同目录,不要覆盖旧目录。升级前备份旧包的 config/deploy.env、data/state/runtime-secrets.json、agents-skills/、外部 MySQL 和三个 Docker 卷。

推荐步骤:

cd /旧包目录
sudo ./OFFLINE_INSTALL.sh --stop

cd /新包目录
# 按旧配置逐项填写新版本 deploy.env;不要直接覆盖,以免漏掉新增字段
vi config/deploy.env
# 复制经人工确认的智能体、技能、知识文件
sudo ./OFFLINE_INSTALL.sh --start

同一个 Compose 项目名会复用现有数据卷。新版本首次启动可能自动创建或迁移数据库表,必须先完成数据库备份。不要在没有数据库备份的情况下来回切换应用版本。

回退时停止新包,在数据库兼容且已备份的前提下启动旧包。若新版本执行了不可逆数据库迁移,应先恢复升级前数据库和卷快照,再启动旧包。

cat VERSION.json
cat images/deerflow-image-list.txt
sha256sum -c SHA256SUMS

旧镜像不会被 --stop 删除,因此通常可以直接回退;只有运维人员明确清理镜像后才需要重新加载旧包镜像。