兼容性测试平台sonic搭建（Angent windows）

文章目录

兼容性测试平台sonic搭建（Angent windows）
- @[TOC](文章目录)
前言
一、sonic服务端搭建
- 1.环境准备
- - 1.1 docker安装
  - 1.2 docker compose安装
- 2.配置文件下载及配置
- - 2.1 下载yml配置文件
  - 2.2 修改server的yml配置
- 3.docker安装服务
- - 3.1 启动安装
  - 3.2 验证服务
二、sonic客户端部署
- 1.环境准备
- - 1.1 服务端新建Agent
  - 1.2 JAVA环境配置
  - 1.3 abd环境配置
  - 1.4 npm环境配置
  - 1.5 Appium环境配置
  - 1.6 adbkit环境配置
  - 1.7 chromeDriver插件配置
- 2.Agent配置
- - 2.1 Agent配置文件修改
  - 2.2 启动Agent服务
  - 2.3 接入手机验证
总结

前言

近期兼容性测试有需求，找了一下开源的兼容性测试平台，发现一个不错的，官方链接，简单做一下搭建的笔记

一、sonic服务端搭建

1.环境准备

1.1 docker安装

准备一台centos7.6服务器，确保docker安装，通常centos中docker默认安装，如未安装，执行以下命令

curl -fsSL https://get.docker.com | bash -s docker --mirror Aliyun

执行完成后，查看docker版本号，显示版本号即为成功安装

docker --version

1.2 docker compose安装

下载docker compose二进制文件，至/usr/local/bin目录下点击下载

将可执行权限应用于二进制文件：

sudo chmod +x /usr/local/bin/docker-compose

创建软链：

sudo ln -s /usr/local/bin/docker-compose /usr/bin/docker-compose

查看版本确认是否安装成功

$ docker-compose --version
cker-compose version 1.24.1, build 4667896b

2.配置文件下载及配置

2.1 下载yml配置文件

服务端：/usr/local/src目录下新建sonic-server目录

cd /usr/local/src
mkdir sonic-server

下载服务端yml文件至服务端：/usr/local/src/sonic-server目录

2.2 修改server的yml配置

修改docker-compose.yml文件

vim docker-compose.yml

修改详情如下（注：只需要修改2个IP地址即可，其他配置项保持默认，直接拷贝使用即可）

version: '3'
services:sonic-mysql:image: "mysql:5.7"hostname: sonic-mysqlcommand: mysqld --character-set-server=utf8mb4 --collation-server=utf8mb4_unicode_cienvironment:- MYSQL_ROOT_PASSWORD=Sonic!@#123- MYSQL_DATABASE=sonicvolumes:- ./mysql/data:/var/lib/mysqlports:- "3307:3306"networks:- sonic-networksonic-server-simple:image: "sonicorg/sonic-server-simple:v1.3.2-release"environment:#以下为MySql配置，localhost请替换为自己MySql服务的ipv4地址- MYSQL_HOST=sonic-mysql- MYSQL_PORT=3306- MYSQL_DATABASE=sonic- MYSQL_USERNAME=root- MYSQL_PASSWORD=Sonic!@#123#在服务器部署的话，localhost改为服务器ip，port更改为sonic-server-simple暴露的port（一般不变）- SONIC_API_HOST=localhost- SONIC_API_PORT=8094- SONIC_NETTY_PORT=8095#token加密的key值- SECRET_KEY=sonic#身份验证token有效天数- EXPIRE_DAY=14#前端页面访问地址，不填默认为http://localhost:3000#注意，该项配置的127.0.0.1需要修改为部署服务端的IP地址- CLIENT_HOST=http://127.0.0.1:3000#文件保留天数（指测试过程产生的文件，包括图片、录像等等）- FILE_KEEP_DAY=60#测试结果保留天数- RESULT_KEEP_DAY=60#以下均为Cron表达式#清理文件定时任务- FILE_CRON=0 0 12 * * ?#清理测试结果定时任务- RESULT_CRON=0 0 12 * * ?#发送日报定时任务- DAY_CRON=0 0 10 * * ?#发送周报定时任务- WEEK_CRON=0 0 10 ? * Monnetworks:- sonic-networkvolumes:- files:/keepFiles/- files:/imageFiles/- files:/recordFiles/- files:/packageFiles/- files:/logs/ports:- "8094:8094"- "8095:8095"sonic-client-web:image: "sonicorg/sonic-client-web:v1.3.2-release"environment:#注意127.0.0.1改为服务端的ip地址，port更改为sonic-server-simple暴露的port（一般不变）- SONIC_API_HOST=127.0.0.1- SONIC_API_PORT=8094networks:- sonic-networkports:- "3000:80"volumes:files:networks:sonic-network:driver: bridge

3.docker安装服务

3.1 启动安装

服务器/usr/local/src/sonic-server目录下执行安装

docker-compose up -d

执行docker ps查看是否启动成功

不成功再次执行：docker-compose up -d即可

3.2 验证服务

启动完成后，确保对应端口防火墙放行，浏览器访问：http://127.0.0.1:3000，跳转至登录页即服务端部署成功。

二、sonic客户端部署

1.环境准备

1.1 服务端新建Agent

web端进入http://127.0.0.1:3000，直接注册进入，设备中心-Agent中心-新建Agent

1.2 JAVA环境配置

java官网下载jdk18，直接安装即可，下载地址，默认安装完成后配置环境变量JAVA_HOME和path变量，详细配置教程可以直接百度。
注：最低支持版本是jdk16，所以建议直接下最新的好了。
配置完成后cmd窗口，java -version，显示如下即为正常

1.3 abd环境配置

下载Android sdk工具，下载地址：https://www.androiddevtools.cn/

sdk tools中选择windows包下载

下载完成后，解压，选择SDK Manager.exe运行

SDK Manager程序中，保持默认，点击install 17 packages

安装完成后，配置环境变量，ANDROID_HOME目录即解压的目录

path变量添加：%ANDROID_HOME%\platform-tools和%ANDROID_HOME%\tools，保存后确认

cmd窗口执行adb --version，显示版本号即为成功

1.4 npm环境配置

nodejs官网下载windows安装包，直接默认安装即可，下载地址：https://nodejs.org/en/
安装完成后，cmd窗口执行node -v和npm -v显示版本号即为成功

1.5 Appium环境配置

cmd窗口直接执行npm install -g appium，安装完成后，cmd窗口执行 Appium -doctor，显示如下即为成功

1.6 adbkit环境配置

cmd窗口直接执行npm i -g adbkit，安装完成后，执行adbkit -h，显示如下即为成功

1.7 chromeDriver插件配置

下载Agent电脑chrome浏览器匹配的chromeDriver，下载地址，下载完成后放在chrome.exe目录下即可

2.Agent配置

2.1 Agent配置文件修改

官网下载Agent安装包，下载地址，下载完成后，解压至Agent电脑，修改sonic-agent-v1.3.2-release-windows_x86_64\config下的application-prod.yml文件，修改如下
注：修改angent ip，key，server ip即可，其他项保持默认直接复制使用即可

sonic:agent:# 替换为部署Agent机器的ipv4host: 127.0.0.1# 替换为Agent服务的端口，可以自行更改port: 7777# 注意：替换为web页面新增Agent生成的keykey: keyvalueserver:# 这个host改成后端的hosthost: 127.0.0.1# 这个port改成后端文件中心的port（一般不变）folder-port: 8094# 这个port改成后端传输中心的port（一般不变）transport-port: 8095modules:# 安卓模块配置android:enable: true# 是否开启远程adb调试功能use-adbkit: true# iOS模块配置ios:# 如果不需要连接iOS设备，请将true改为false。开启的windows用户请确保本机已安装iTunesenable: true# 替换为你自己使用的wda的bundleId，如果没有.xctrunner后缀会自动补全，建议使用公司的开发者证书wda-bundle-id: com.facebook.WebDriverAgentRunner.xctrunnerappium:enable: true# 默认为0会自动寻找随机端口启动，如果需要指定appium server端口，请在这里设置port: 0# 在线webView调试模块配置webview:enable: true# 谷歌调试端口，一般不需要修改（默认0使用随机端口，如果需要开启防火墙给外部使用，请设置固定端口如7778）chrome-driver-debug-port: 0# Agent机器上的chrome浏览器的driver路径，可以去http://npm.taobao.org/mirrors/chromedriver/下载chrome-driver-path: C:\Program Files\Google\Chrome\Application\chromedriver.exe# Agent日志管理，一般不需要更改，可根据自己需要配置
logging:file:#日志路径name: logs/sonic-agent.loglogback:rollingpolicy:clean-history-on-start: true#保留天数max-history: 3pattern:console: "%clr(%d{${LOG_DATEFORMAT_PATTERN:yyyy-MM-dd HH:mm:ss.SSS}}){faint} %clr(${LOG_LEVEL_PATTERN:-%5p}) %clr(${PID:- }){magenta} %clr(---){faint} %clr([%t]){faint} %clr(%-40.40logger{39}){cyan} %clr(:){faint} %m%n${LOG_EXCEPTION_CONVERSION_WORD:%wEx}"

2.2 启动Agent服务

切换至sonic-agent-v1.3.2-release-windows_x86_64目录下，shift右键打开cmd窗口，执行chcp 65001

输入命令：java -jar sonic-agent-windows-x86_64.jar，显示如下即为启动成功

此时web端对应angent显示为在线状态

2.3 接入手机验证

angent所在电脑插入Android手机，打开开发者模式，允许usb调试，web端显示手机在线即为成功

总结

主要是angent环境搭建有些复杂，需要准备的基础环境比较多，很多资源需要fq才可以，后续更新一个资源包好了，方便下载使用。