AREX是携程团队开发用于自动化测试的工具,其特点是避免人为维护接口
安装部署
安装之前缺人linux已经安装Docker 和 Docker Compose 可以根据命令docker --version和docker-compose -v确认是否已安装,并且docker是启动状态
service docker status查看docker状态
service docker restart重启docker
在线安装: git clone --depth 1 https://github.com/arextest/deployments.git
cd deployments
离线安装下载GitHub - arextest/deployments: arexTest docker-compose file and demo
解压缩 tar -zxvf deployments-0.4.2.tar.gz
进入解压缩目录 cd deployments-0.4.2
安装: docker-compose up -d
安装过程中出现Error response from daemon: driver failed programming external connectivity on endpoint arex-redis (863d324918d4d811382e18aa4c654c3dcd8187fd336a309a4c972c1c08b1c704): Bind for 0.0.0.0:6379 failed: port is already allocated
这个问题是我启动的metersphere有redis服务占用了redis端口,执行了msctl stop把metersphere服务停了杀掉进程,重新执行: docker-compose up -d
或者是修改deployments-0.4.2文件的 docker-compose.yml的redis,我这里改6399
安装完成查看状态进入解压缩目录执行
查看状态: docker-compose ps
STATUS状态时up是安装成功
前端的服务是arex-front 对应端口8088,
前端浏览器输入http://192.168.1.5:8088/ 输入邮箱地址,输入邮箱的验证码登录
安装AREX Agent 是实现服务录制回放的核心组件,可通过配置 -javaagent
使 agent 动态注入到 jvm,以此来运行 AREX Agent。 AREX Agent 的运行依赖 AREX 的存储服务(AREX storage service)
1)在线安装 git clone https://github.com/arextest/arex-agent-java.git
cd arex-agent-java
mvn clean install
2)我这里是离线安装Tags · arextest/arex-agent-java · GitHub
编译成功后可在 arex-agent-java 文件夹得到一个名为 arex-agent-jar 的新文件夹,其中包含两个 jar 包。我这里mvn clean install 是单测失败可以忽略 可以执行 mvn clean install -DskipTests
我这里自己搭建了个java项目在下面目录
这里先不启动jar,需要java -javaagent启动否则报错,地址已在使用
官方文档:java -javaagent:/path/to/arex-agent-<version>.jar -Darex.service.name=your-service-name -Darex.storage.service.host=<storage.service.host:port> -jar your-application.jar
我这里写:在有jar包的目录下执行java -javaagent:/home/arex-agent-java-0.3.8/arex-agent-jar/arex-agent-0.3.8.jar -Darex.service.name=community-service -Darex.storage.service.host=192.168.1.5:8093 -jar sp-0.0.3-SNAPSHOT.jar
备注
- arex-agent- .jar 是 AREX 提供或者自行编译的 jar 包名称,注意修改路径,我这里安装在home/arex-agent-java-0.3.8/arex-agent-jar/
- your-service-name 你的被测试服务的名称,不同的服务需使用不同的名称,可以自己起一个名字,区分项目
- storage.service.host:port 是storage服务的port,host是对应这个服务的ip,我这里是192.168.1.5
- your-application.jar 你的被测试服务的 jar 包文件