#DataAgent 版本升级指南

本文介绍如何将 升级 DataAgent 自身版本。

#步骤一：备份数据库

在升级之前，请务必备份整个数据库，以便在升级出现问题时可以回退版本并恢复数据。

1. 登录 DataAgent 系统
2. 点击右上角的齿轮按钮，进入系统设置
3. 选择备份管理器
4. 点击创建备份按钮，等待备份完成

提示

请下载备份文件，请确保备份成功后再继续后续步骤。

如果找不到备份管理器（或下方的迁移管理），请检查权限配置，按以下步骤开启相应权限：

#步骤二：执行数据库迁移

1. 获取最新的迁移文件

   最新的迁移文件见：migration-1774920084621.nbdata

2. 进入迁移管理

   • 点击右上角的齿轮按钮
   • 选择迁移管理

3. 上传迁移文件

   • 点击上传迁移按钮
   • 选择下载的迁移文件
   • 等待迁移执行完成

#步骤三：更新 Docker 镜像

执行以下命令更新 Docker 镜像并重启服务：

docker-compose up -d

由于 docker-compose.yml 中配置了 pull_policy: always，且项目处于开发早期版本暂不更新版本号（统一使用 latest 标签），Docker 会自动拉取最新镜像。

#步骤四：验证升级结果

升级完成后，请验证以下内容：

1. 服务状态：确认所有容器正常运行

   docker-compose ps

2. 功能测试：测试关键功能是否正常

3. 数据检查：确认数据迁移正确，业务建模数据完整

#回退方案

如果升级后出现问题，可以按以下步骤回退：

1. 停止当前服务：docker-compose down
2. 切换回旧版本镜像（修改 docker-compose.yml 中的镜像标签或使用之前的镜像）
3. 启动服务：docker-compose up -d
4. 通过备份管理器恢复之前备份的数据库