开源云真机平台Sonic跨版本升级实践

背景

在此前文章中，我分享过《开源云真机平台-Sonic应用实践》。最早安装的是1.0版本，中间由于服务器系统重装，又顺带一起重新安装了1.5的版本，几个月用下来，体验挺不错，也算是忠实用户了。11.24号sonic发布了最新的2.0.5版本，增加了诸多特性、bug修复及优化。所以这次趁热打铁，直接把我本地的也更新到了2.0.5的版本。本文为此次升级过程中的实践记录。

升级说明

https://sonic-cloud.gitee.io/#/Deploy?tag=upgrade

由于我是v1.5.0-release版本，所以按照官网说明，必须要先升级到v2.0.0-release版本，然后再从v2.0.0-release版本升级到v2.0.5版本才行，不能跨大版本升级。我的Server部署在CentOS上，其中一个Agent部署在同一内网下的另一台CentOS上，另一个Agent部署在一台Windows上。也就是说要分两个阶段分别对Server和两个Agent进行升级。

准备升级文件

Server端文件下载地址：

https://github.com/SonicCloudOrg/sonic-server/releases

Agent端文件下载地址：

https://github.com/SonicCloudOrg/sonic-agent/releases

1.5.0-->2.0.0用到的文件有：

Server端（CentOS）：sonic-server-v2.0.0-release.zip

Agent端（CentOS）：sonic-agent-v2.0.0-release-linux_x86_64.zip

Agent端（Windows）：sonic-agent-v2.0.0-release-windows_x86_64.zip

2.0.0-->2.0.5用到的文件有：

Server端（CentOS）：sonic-server-v2.0.5.zip

Agent端（CentOS）：sonic-agent-v2.0.0-release-linux_x86_64.zip

Agent端（Windows）：sonic-agent-v2.0.0-release-windows_x86_64.zip

1.5.0升级到2.0.0版本

1. server升级前，先备份数据库。
2. 执行docker-compose down
3. 替换旧docker-compose.yml为最新版docker-compose.yml。
4. .env文件最下方新增LDAP_OBJECT_CLASS=person
5. 执行docker-compose up -d
6. Agent更新需替换旧版本plugins文件夹与jar文件。
7. Agent端的jar部署方式：已知部分JDK出现不兼容的问题，Sonic官方推荐使用JDK15，可以前往 这里 安装下载。
8. Agent的config/application-sonic-agent.yml字段有改动，需参考最新版yml备注进行配置。
9. Agent本地环境不再依赖node、npm、谷歌浏览器、chromedriver，可以卸载来减少Agent空间。

升级Server

1.先备份数据库

可以导出一份数据库文件，用于防止升级过程中出现的意外。

2.卸载1.5.0版本的server

进入sonic server的docker-compose.yml所在的目录，执行卸载命令：

docker-compose down

执行命令后，docker会先停掉server相关的各个容器，然后移除sonic server网络：

3. 替换旧docker-compose.yml为最新版docker-compose.yml

解压sonic-server-v2.0.0-release.zip文件，将解压出来的docker-compose.yml替换掉原来的docker-compose.yml

unzip sonic-server-v2.0.0-release.zip

4..env文件最下方新增LDAP_OBJECT_CLASS=person

由于.env文件是隐藏文件，因此要用到ls -al的命令才能查看到

ls -al

在.env文件最下方新增LDAP_OBJECT_CLASS=person

5.启动容器编排

docker-compose up -d

可以看到，server相关的容器均已成功创建和启动，并已升级到2.0.0版本：

升级Agent（CentOS端）

1.替换docker-compose.yml文件

Agent传统方式部署的需替换旧版本plugins文件夹与jar文件，而我之前是也是docker部署的，所以只需替换docker-compose.yml文件，替换后将server、agent地址，按照之前的配置相应修改即可。

2.启动容器编排

docker-compose up -d

可以看到，先会下载2.0.0版本相关的镜像文件，然后创建agent相关的容器：

升级Windows端的agent

1.替换旧版本plugins文件夹与jar文件

解压sonic-agent-v2.0.0-release-windows_x86_64.zip，由于我的Windows端的agent是传统方式部署的，所以需要替换旧版本plugins文件夹与jar文件：

2.修改agent配置文件

由于2.0.0版本较1.5.0版本变化较大，部分配置发生更改，尤其是Chromedriver弃用等，因此需要修改config文件夹中 application-sonic-agent.yml 的配置信息

sonic:
  agent:
    # 替换为部署Agent机器的ipv4
    host: 192.168.1.188
    # 替换为Agent服务的端口，可以自行更改
    port: 7777
    # 替换为前端新增Agent生成的key
    key: 774ed0c0-b8d6-4bcb-8a68-36bb67d51691
  server:
    # 改成server的SONIC_SERVER_HOST
    host: 192.168.1.20
    # 改成server的SONIC_SERVER_PORT
    port: 3000

modules:
  android:
    # 是否开启安卓模块
    enable: true
    # 是否开启sonic-android-supply远程adb调试功能
    use-sas: true
  ios:
    # 如果不需要连接iOS设备，请将true改为false。开启的windows用户请确保本机已安装iTunes
    enable: true
    # 替换为你自己使用的wda的bundleId，如果没有.xctrunner后缀会自动补全，建议使用公司的开发者证书
    wda-bundle-id: com.dagangtest.WebDriverAgentRunner
  sgm:
    # 是否开启sonic-go-mitmproxy网络抓包功能
    enable: true

3.启动agent

windows用户，要先在控制台输入 chcp 65001 并回车，再输入以下指令

java -Dfile.encoding=utf-8 -jar sonic-agent-windows-x86_64.jar

启动后会先进行一堆初始化操作，如ADB等环境检查，2.0.0版本不再校验chromedriver、nodejs、appium等：

4.查看前台Agent在线状态

启动成功后，刷新前台页面的Agent中心，两台agent均处于在线状态，并成功更新到了2.0.0-release版本：

各个机器展示、使用正常

至此，sonic的Server、Agent均已成功升级至v2.0.0-release版本。

2.0.0升级到2.0.5版本

相比于1.5.0升级到2.0.0，从2.0.0升级到2.0.5就简单得多

1. 升级前先备份Mysql数据库。
2. 在server目录下执行docker-compose down
3. 直接下载最新版docker-compose.yml
4. 执行docker-compose up -d
5. Agent更新需替换旧版本plugins文件夹与jar文件。

升级Server

1.卸载server容器编排

docker-compose down

2.替换docker-compose.yml

下载2.0.5版本的docker-compose.yml文件，按照之前的配置进行修改，替换原来的docker-compose.yml。

3.启动server容器编排

进入sonic server的docker-compose.yml所在目录，执行：

docker-compose up -d

升级Agent（CentOS端）

1.卸载原有agent的容器编排

docker-compose down

2.启动agent容器编排

docker-compose up -d

查看容器列表，sonic-agent_sonic-agent_1容器版本为v2.0.5版本

刷新前台页面，当前agent处于在线状态，版本成功更新为2.0.5：

升级Windows端的agent

1.替换旧版本plugins文件夹与jar文件

解压sonic-agent-v2.0.5-windows_x86_64.zip，与之前一样，需要替换旧版本plugins文件夹与jar文件：

2.启动agent

由于2.0.5版本较2.0.0版本配置未发生变化，所以无需修改application-sonic-agent.yml 的配置信息，直接启动agent即可。同样地，windows用户，要先在控制台输入 chcp 65001 并回车，再输入以下指令：

java -Dfile.encoding=utf-8 -jar sonic-agent-windows-x86_64.jar

刷新前台页面，当前agent处于在线状态，版本成功更新为2.0.5：

各个机器展示、使用正常：

至此，sonic的Server、Agent均已成功升级至v2.0.5版本。

小结

总体来说，此次升级过程相对顺利，只是跨了大版本升级，所以要分两个阶段实行。又由于是两个Agent，且部署在了不同系统，所以步骤确实比较多。但只要耐下心来，认认真真、一点一点操作，一切问题都会迎刃而解！