写点什么

AREX:接口自动化回归测试完全指南

  • 2023-05-25
    上海
  • 本文字数:4216 字

    阅读完需:约 14 分钟

AREX 是一款开源的基于真实请求与数据的自动化回归测试平台(项目地址:https://github.com/arextest),利用 Java Agent 技术与比对技术,通过流量录制回放能力实现快速有效的回归测试。同时提供了接口测试、接口比对测试等丰富的自动化测试功能,无需编程能力也可快速上手。



在使用 AREX 流量录制功能时,AREX Java Agent 会记录生产环境中 Java 应用的数据流量和请求信息,并将这些信息发送给 AREX 数据存取服务(Storage Service),由数据存取服务导入 Mongodb 数据库中进行存储。当需要进行回放测试时,AREX 调度服务(Schedule Service)将会根据用户的配置和需求,通过数据存取服务从数据库中提取被测应用的录制数据(请求),然后向目标验证服务发送接口请求。同时,Java Agent 会将录制的外部依赖(外部请求/DB)的响应返回给被测应用,目标服务处理完成请求逻辑后返回响应报文。随后调度服务会将录制的响应报文与回放的响应报文进行比对,验证系统逻辑正确性,并将比对结果推送给分析服务(Report Service),由其生成回放报告,供测试人员检查。在整个过程中,AREX 的缓存服务 Redis 负责缓存回放过程中的 Mock 数据和比对结果,以提高比对效率。


本文以 community-test 工具为例,从 AREX Agent 配置到录制回放、问题定位,完整展示 AREX 接口自动化回归测试的全过程。


community-testhttps://github.com/arextest/arex-community-test)是一个由 AREX 提供的用于测试和验证 AREX 系统功能的工具,它是一个 Java 应用程序,依赖于 MySQL 和 Redis,用于模拟业务服务。

AREX 运行环境

笔者在应用环境申请了 Linux 服务器,这是由 OPS 提供的设备。


服务器的 IP 地址是 10.5.153.1,拥有 128GB 内存和 32 Core。该服务器可以通过公司办公网进行访问,但其他外部环境无法访问。主要目的是在该服务器上安装 AREX 服务和部署 community-test 的测试环境。


为了确保服务器能够访问公网,需要进行一些设置。在安装过程中,需要下载 AREX 的安装包,并获取 community-test 的代码进行编译和发布。如果你的服务器可以直接访问公网,则可以跳过设置代理的步骤。否则,需要设置代理以确保服务器能够访问公网。


在端口方面,没有限制对外暴露的端口数量。然而,现在 OPS 对每个服务器做了限制,缺省情况下只允许外部访问的端口是 80 和 8080,其他端口默认是被 block 的。


另外,远程访问受限,本次演示是通过跳板机登录到服务器的。

通过录制回放进行回归测试

安装 AREX

远程登录 10.5.153.1,新建目录 arex


cd arexgit clone https://github.com/arextest/deployments.git
复制代码



执行以下命令启动 AREX:


# 读取当前目录的docker-compose.yml文件,并以服务的方式启动docker-compose up -d# 读取当前目录的docker-compose-distribute.yml文件,并以服务的方式启动docker-compose -f docker-compose-distribute.yml up -d# 读取当前目录的docker-compose-mongo4.4.21.yml文件,并以服务的方式启动, 因为某些服务器硬件版本的原因,不能启动5.0的mongodbdocker-compose -f docker-compose-mongo4.4.21.yml up -d
复制代码


启动后,可以使用 docker-compose ps 命令查看各个服务的状态和配置:



  • State 是各个服务状态,Up 才是正确的,如果是其他状态,则需要重启服务或者查看服务的日志,检查不能启动的原因。

  • arex-front 就是前端,这里我的端口没有修改,缺省为 8088 端口。你可以根据你的环境配置想要的端口,比如 80 端口。

  • MongoDB 的端口仍然是默认的 27017(你也可以使用你的 MongoDB 工具连接到数据库),链接地址是:10.5.153.1:27017,用户名为 "arex",密码为 "iLoveArex"。请注意,在 Docker Compose 的配置中,链接地址应为:mongodb://arex:iLoveArex@mongodb:27017/arex_storage_db,这是因为在 Docker Compose 中使用的是服务名进行网络连接。因此,你可以使用以下地址访问 MongoDB:mongodb://arex:iLoveArex@10.5.153.1:27017/arex_storage_db。

  • arex-storage 的端口是 8093,这是需要在 agent 配置中指定的端口。在我的环境中配置的 storage 地址是 10.5.153.1:8093。


使用 docker-compose images 查看各个服务组件运行的版本:



AREX 的各个组件都是 0.2.10,其中 arex-node 服务后续要去掉,而且功能也没有更新,还是 0.2.7 版本。


启动后,在当前启动目录下有两个目录。其中 arex-logs 是存储各个服务的日志,arex-data 用于存储数据。



启动后,可以在命令行中查看日志:



  • docker-compose logs :查看全部的日志

  • docker-compse logs arex-report-service:查看 Report 服务的日志


安装后访问 AREX 前端页面 http://10.5.153.1:8088/,输入邮箱获取验证码进行登录,如下图:



至此,AREX 的安装结束。

community-test 业务服务安装

下载编译 AREX Agent 代码

git clone https://github.com/arextest/arex-agent-java.gitcd arex-agent-javamvn clean package
复制代码


编译完成:



检查当前目录下的 arex-agent-jar 目录,是否存在最新编译的 arex agent jar 文件:


编译 community-test 代码

拉取代码:


git clone https://github.com/arextest/arex-community-test.git
复制代码



使用 mvn clean package 编译项目



为了运行方便,将 community-test 进行容器化部署:


FROM tomcat:9.0-jdk8-openjdk
ARG WAR_FILE=./target/arex-agent-test-0.0.1-SNAPSHOT.warADD $WAR_FILE /usr/local/tomcat/webapps/
WORKDIR /usr/local/tomcat/confRUN sed -i 'N;152a\\t<Context path="" docBase="arex-agent-test-0.0.1-SNAPSHOT" reloadable="true" />' server.xml
ADD ./arex-agent-0.2.0.jar /usr/local/tomcat/ADD ./arex-agent-bootstrap-0.2.0.jar /usr/local/tomcat/
WORKDIR /usr/local/tomcatEXPOSE 8080CMD ["catalina.sh","run"]
复制代码


容器化编译 shell 如下,仅供参考,相对目录可能都需要修改:


cd ../arex-community-testmvn clean package cp ../deployments/dockerfile/community.Dockerfile ./Dockerfilecp ../arex-agent-java/arex-agent-jar/arex-agent-0.3.0.jar ./arex-agent-0.3.0.jarcp ../arex-agent-java/arex-agent-jar/arex-agent-bootstrap-0.3.0.jar ./arex-agent-bootstrap-0.3.0.jar docker build -t arexadmin01/arex-community-test:0.0.1  . rm -rf ./Dockerfilerm -rf ./arex-agent-0.3.0.jarrm -rf ./arex-agent-bootstrap-0.3.0.jar cd ..
复制代码


至此,已经成功创建用于测试的程序镜像。

SUT 应用配置 AREX Agent

以下是运行 community-test 工具时所使用的原始命令行,并且提供了与数据库和 Redis 的连接配置,如下:


environment:      - JAVA_TOOL_OPTIONS=-Dspring.datasource.url=jdbc:mysql://cmysql:3306/community?useUnicode=true&characterEncoding=utf-8 -Dspring.datasource.username=arex_admin -Dspring.datasource.password=arex_admin_password -Dspring.redis.host=credis -Dspring.redis.port=6379
复制代码


增加 AREX 的配置:


environment:      - JAVA_TOOL_OPTIONS='-javaagent:/usr/local/tomcat/arex-agent-0.3.0.jar' -Darex.service.name=community-service -Darex.storage.service.host=10.5.153.1:8093 -Darex.enable.debug=true  -Dspring.datasource.url=jdbc:mysql://cmysql:3306/community?useUnicode=true&characterEncoding=utf-8 -Dspring.datasource.username=arex_admin -Dspring.datasource.password=arex_admin_password -Dspring.redis.host=credis -Dspring.redis.port=6379
复制代码


  • '-javaagent:/usr/local/tomcat/arex-agent-0.3.0.jar' 这部分就是我们编译的 AREX Agent 的 JAR 文件,该 JAR 文件将作为 Java 代理(Java agent)加载到应用程序中。

  • -Darex.service.name=community-service:这是应用程序的名称,它将在 AREX Replay 页面中显示。

  • -Darex.storage.service.host=10.5.153.1:8093:这是 AREX Storage 服务的地址,指定为 10.5.153.1:8093

  • -Darex.enable.debug=true:这是一个配置选项,如果设置为 true,则将以调试模式运行,即会录制所有的流量。在生产环境中,建议将其设置为 false


启动 arex-community-test 服务,随后在 AREX 前端页面查看应用注册情况:



可以看到,被测试应用 community-test 已经成功运行,其访问地址为 http://10.5.153.1:8080/

回归测试

生产环境发布运行

现在,arex-agent 已经成功地启动并在应用程序中运行,在录制过程中,用户无需进行任何特殊的操作或干预,可以按照常规方式对外提供服务或手动访问应用程序。


在本文的演示中,笔者使用 Collection 中的批量执行功能对 community-service 进行访问,访问地址为 http://10.5.153.1:8080/


在访问过程中,arex-agent 会自动开始录制并将录制的 AREX 用例存储起来,无需用户手动进行录制操作。


业务代码更新

当我们的业务需求实现并提交以后,新版本要编译测试,则执行以下步骤:


  1. 拉取新代码

  2. 编译代码并打包

  3. 重点: 保持 AREX Agent 的配置不变,特别是应用名,AREX 是利用应用名来识别应用和管理用例的。因此在新版本的编译和测试过程中,应保持与之前版本相同的应用名配置。

  4. 发布代码到测试环境:将编译和打包后的应用程序代码发布到测试环境中,以便进行进一步的测试和验证。

在测试环境进行回归测试

进入 AREX Replay 页面,选择 community-service 服务,在右边回放界面上点击 "Start Replay" 按钮,输入回放的地址(我用的是同一个环境,所以地址还是 http://10.5.153.1:8080/),开始回放:


测试问题定位

如果测试比对全部执行且没有任何差异,则测试通过:



如果测试过程中发现问题,如下所示:



点击存在问题的回放报告,展示所有的接口及其回归测试情况,如下图:



点击 DiffScenes(New),将以总体统计视图显示差异点所在。value diff,就是新老版本比对的差异在值差异。



继续点击差异点,查看差异细节,如下图。左边是 benchmark,即生产录制的值;右边是 Test,即测试环境回放过程中返回的值,两者不一致即返回差异信息。



根据发现的差异,找到代码中存在问题的点:


  • 确认问题, 将问题修复,重复"业务代码更新"的章节, 修改→测试发布→比对。

  • 确认非问题, 则将此节点设置为过滤节点,下次回放跳过该节点比对。

  • 持续此操作, 将所有的差异点都确认修复或者差异在预期范围内。

  • 确认修复和发布版本。




AREX 文档:http://arextest.com/zh-Hans/docs/intro/


AREX 官网:http://arextest.com/


AREX GitHub:https://github.com/arextest


AREX 官方 QQ 交流群:656108079

用户头像

https://github.com/arextest 2023-01-11 加入

AREX 是一个基于真实请求与数据的自动化回归测试平台。通过复制线上真实流量到测试环境进行自动化回归测试,解决回归测试的难题。

评论

发布
暂无评论
AREX:接口自动化回归测试完全指南_Java Agent_AREX 中文社区_InfoQ写作社区