备份完整的数据
一个可恢复的备份需要包含数据库、应用数据卷中的附件与密钥,以及 Compose 和环境配置。只备份数据库不能恢复附件。
备份本身也可能包含敏感信息,应保存在受控位置。采用外部附件存储时,还需要覆盖相应存储服务的数据与配置。
检查现有实例
升级前记录当前应用镜像标签、服务配置,并检查服务状态:
docker compose ps
docker compose logs --tail=100 app worker
使用产品源码自带的备份工具,先检查相应版本的使用说明和输出位置。至少在独立环境验证一次恢复,不要只检查备份文件是否存在。
规划升级
- 阅读目标版本的变更和数据库迁移要求。
- 完成数据库、数据卷及配置备份。
- 安排维护窗口,避免升级时继续写入。
- 获取目标版本的 Compose 配置,核对服务与数据库迁移差异。
- 在
.env中将FERONAVI_VERSION设为目标应用版本,例如0.1.0;应用和 worker 会使用同一版本镜像。 - 拉取目标镜像并更新服务。
docker compose pull
docker compose up -d --wait
docker compose ps
如果数据库镜像或主版本发生变化,先按目标版本迁移说明操作。不要仅通过替换镜像标签跨越数据库主版本。
升级后验证
检查登录、项目读取、一次普通工作项修改、附件下载、通知和知识检索。使用 MCP 的团队应再验证一次只读查询及授权范围。
检查应用和 worker 日志。后台任务处于 queued 或 running 时尚未结束,请等待完成后检查结果。
恢复与回退
涉及数据库迁移时,旧应用未必能读取新数据结构。回退应结合升级前的完整备份和目标版本恢复说明,先在隔离环境验证。
恢复完成后同时核对数据库记录和附件内容。确认业务可用后再开放团队访问。