版本迁移指南 #

本文将介绍如何升级到最新版本。

关于版本规则变动 #

v2.0.0-release 起，Sonic 版本规则更改如下：

1. 第一位是大版本号，基本为一年一更
2. 第二位是有新功能合入就会加 1（特性版本，一般月更）
3. 第三位是修复 Bug 就会加 1（修复版本，一般半周到一周更一次）

以 v2.0.1 为例，就是修复 v2.0.0 的 Bug。

如果有大量新功能发布，就会更新 v2.1.0。

如果 v2.1.0 上线后有 Bug，那么下版本就是 v2.1.1，如果仍有 Bug，那么会继续发布 v2.1.2。

如果想追求稳定的版本，那么应该是上一个特性版本的最后一个修复版本为最稳定。

例如 v2.2.0 的上一个版本为 v2.1.15，那么 v2.1.15 版本就是 v2.1.x 的最稳定的版本

从 v2.5.x 升级到 v2.7.x #

1. 升级前先备份Mysql数据库。
2. 直接前往 这里 下载最新版本zip，down集群后重新up即可。如果更换了部署目录，旧目录下的keepFiles、imageFiles、recordFiles、packageFiles文件夹的内容也要同步到新目录下（部署文档含中国大陆加速镜像部署方式）
3. Agent可前往 这里 下载zip后解压，更新需替换旧版本plugins文件夹与jar文件。Docker版Agent与server同理，前往 这里 重新下载镜像部署即可。（部署文档含中国大陆加速镜像部署方式）
4. v2.7.1 Agent的config/application-sonic-agent.yml新增了wda-xcode-project-path配置用于iOS高版本兼容，可前往iOS接入指南查看。

从 v2.3.x ~ v2.4.x 升级到 v2.5.x #

1. 升级前先备份Mysql数据库。
2. 直接前往 这里 下载最新版本zip，down集群后重新up即可。如果更换了部署目录，旧目录下的keepFiles、imageFiles、recordFiles、packageFiles文件夹的内容也要同步到新目录下（部署文档含中国大陆加速镜像部署方式）
3. Agent jar部署的jdk要求提升至 jdk17，可前往 这里 下载zip后解压，更新需替换旧版本plugins文件夹与jar文件。Docker版Agent与server同理，前往 这里 重新下载镜像部署即可。（部署文档含中国大陆加速镜像部署方式）
4. Eureka默认端口从9090变更至8761

从 v1.4.1-release 以上版本 升级到 v2.0.x ~ v2.3.x #

1. 升级前先备份Mysql数据库。
2. 直接前往 这里 下载最新版本zip，down集群后重新up即可。如果更换了部署目录，旧目录下的keepFiles、imageFiles、recordFiles、packageFiles文件夹的内容也要同步到新目录下（部署文档含中国大陆加速镜像部署方式）
3. jar方式部署的Agent前往 这里 下载zip后解压，更新需替换旧版本plugins文件夹与jar文件。Docker版Agent与server同理，前往 这里 重新下载镜像部署即可。（部署文档含中国大陆加速镜像部署方式）

其他旧版本升级到 v1.4.1-release #

0. server 升级前，先备份数据库。
1. 注意！ 升级后图片路径有所更改，所以旧图片会失效！

sonic-server-gateway:
    image: "registry.cn-hangzhou.aliyuncs.com/sonic-cloud/sonic-server-gateway:v1.4.1-beta"
    hostname: sonic-server-gateway
    environment:
      - SONIC_EUREKA_USERNAME
      - SONIC_EUREKA_PASSWORD
      - SONIC_EUREKA_PORT
      - SONIC_EUREKA_HOST=sonic-server-eureka
      - SECRET_KEY
      - EXPIRE_DAY
    volumes:
      - ./logs/:/logs/
    depends_on:
      - sonic-server-eureka
    networks:
      - sonic-network
    restart: on-failure
    ports:
      - 8094:8094

2. 因新版本 将前后端多个端口合并为单一接口 暴露，配置时需注意。（注意 env 文件与 docker-compose.yml 文件都需要更换）
3. 因整体架构调整较多，可前往 前后端部署 页面重新部署。
4. server 升级后，将旧挂载目录下的 logs、keepFiles、imageFiles、recordFiles、packageFiles 中的内容迁移到新目录下。
5. Agent 改动较大，需要将旧文件全部删除重新部署。配置 yml 时注意 server 的 port 应为 SONIC_SERVER_PORT。

其他旧版本升级到 v1.4.0-release #

1. server 升级前，先备份数据库。
2. 因新版本调整设备数据，尽量将旧版本的 重复序列号(udId) 的设备删除至剩一个。（可查看下方常见问题）
3. 因整体架构调整较多，可前往 前后端部署 页面重新部署。
4. server 升级后，将旧挂载目录下的 logs、keepFiles、imageFiles、recordFiles、packageFiles 中的内容迁移到新目录下。
5. 如果旧版本没有自定义挂载路径（特别是 simple 版用户），您不知道您的本地文件默认储存在哪里，可以 参考这里 （如果你不想使用这个方法，可以参考常见问题第二题）。
6. Agent 改动较大，需要将旧文件全部删除重新部署。

关于 simple 版本 #

综合注册架构、通信逻辑、性能优化等因素，从 v1.4.0-beta 开始，集群版与 simple 版合并，并且在 sonic-server 上继续维护，因此 sonic-server-simple 版本不再维护。

常见问题（Q&A） #

Q1: 我如果不迁移上文提到的若干个文件夹，直接使用新版本自带的文件夹，会发生什么？

A1: 旧版本的图片、录像、截图等信息将失效。当然如果文件不多，直接用新版本也是可以的。

Q2: 如果不用上文第四点的方法，还有别的方法吗？

A2: 可以使用 docker cp 指令将容器内的文件复制到宿主机，再迁移到新版本文件夹中。

Q3: 为什么1.4.0之前旧版本升级需要删除重复的序列号设备？

A3: 旧版本是以单 Agent 内不可重复，后续考虑到用户会将同一设备在多个 Agent 之间迁移，直接以序列号为标识。安卓目前是极低概率才会出现序列号相同的设备（哪怕相同也有办法修改），而苹果的序列号都是唯一的，所以大家不用担心。