使用文档备份与升级

备份与升级

备份数据库、附件和配置,升级 Feronavi,并在需要时恢复数据。

备份完整的数据

一个可恢复的备份需要包含数据库、应用数据卷中的附件与密钥,以及 Compose 和环境配置。只备份数据库不能恢复附件。

备份本身也可能包含敏感信息,应保存在受控位置。采用外部附件存储时,还需要覆盖相应存储服务的数据与配置。

检查现有实例

升级前记录当前应用镜像标签、服务配置,并检查服务状态:

docker compose ps
docker compose logs --tail=100 app worker

使用产品源码自带的备份工具,先检查相应版本的使用说明和输出位置。至少在独立环境验证一次恢复,不要只检查备份文件是否存在。

规划升级

  1. 阅读目标版本的变更和数据库迁移要求。
  2. 完成数据库、数据卷及配置备份。
  3. 安排维护窗口,避免升级时继续写入。
  4. 获取目标版本的 Compose 配置,核对服务与数据库迁移差异。
  5. 在 .env 中将 FERONAVI_VERSION 设为目标应用版本,例如 0.1.0;应用和 worker 会使用同一版本镜像。
  6. 拉取目标镜像并更新服务。
docker compose pull
docker compose up -d --wait
docker compose ps

如果数据库镜像或主版本发生变化,先按目标版本迁移说明操作。不要仅通过替换镜像标签跨越数据库主版本。

升级后验证

检查登录、项目读取、一次普通工作项修改、附件下载、通知和知识检索。使用 MCP 的团队应再验证一次只读查询及授权范围。

检查应用和 worker 日志。后台任务处于 queued 或 running 时尚未结束,请等待完成后检查结果。

恢复与回退

涉及数据库迁移时,旧应用未必能读取新数据结构。回退应结合升级前的完整备份和目标版本恢复说明,先在隔离环境验证。

恢复完成后同时核对数据库记录和附件内容。确认业务可用后再开放团队访问。

输入关键词,搜索全部使用文档。