Mac,Jmeter+Ant+Jenkins 接口测试框架

转载自:https://www.jianshu.com/p/c52205c1a501

jdk安装

jmeter基于Java,所以使用jmeter前需要安装jdk,目前最新jmeter版本需要JDK8

jmeter安装

下载jmeter zip包
jmeter官网:https://jmeter.apache.org/
下载最新版本jmeter zip包,2018/8/22当前最新版本为4.0,需要JDK8,如下图:

jmeter安装.jpg

 

解压jmeter zip包
mac环境下,将zip解压到/user/loacal路径下

 

jmeter解压路径.jpg

jmeter环境变量配置
修改mac的.bash_prifile配置文件,便于直接唤起jmeter

# add jmeter
export JMETER=/usr/local/apache-jmeter-4.0
export CLASSPATH=$JMETER/lib/ext/ApacheJMeter_core.jar:$JMETER/lib/jorphan.jar:$JMETER/lib/logkit-2.0.jar:$CLASSPATH
export PATH=$PATH:$JMETER/bin

jmeter安装验证
iTerm中输入:jmeter -v 查看jmeter版本

jc@jc:~$ jmeter -v
    _    ____   _    ____ _   _ _____       _ __  __ _____ _____ _____ ____
   / \  |  _ \ / \  / ___| | | | ____|     | |  \/  | ____|_   _| ____|  _ \
  / _ \ | |_) / _ \| |   | |_| |  _|    _  | | |\/| |  _|   | | |  _| | |_) |
 / ___ \|  __/ ___ \ |___|  _  | |___  | |_| | |  | | |___  | | | |___|  _ <
/_/   \_\_| /_/   \_\____|_| |_|_____|  \___/|_|  |_|_____| |_| |_____|_| \_\ 4.0 r1823414

Copyright (c) 1999-2018 The Apache Software Foundation

iTerm中输入:jmeter 启动jmeter的GUI mode

jc@jc:~$ jmeter
================================================================================
Don't use GUI mode for load testing !, only for Test creation and Test debugging.
For load testing, use NON GUI Mode:
   jmeter -n -t [jmx file] -l [results file] -e -o [Path to web report folder]
& increase Java Heap to meet your test requirements:
   Modify current env variable HEAP="-Xms1g -Xmx1g -XX:MaxMetaspaceSize=256m" in the jmeter batch file
Check : https://jmeter.apache.org/usermanual/best-practices.html
================================================================================

jmeter用例编写

线程组

作用:设置并发用户数,循环次数,循环时间的模块
新建路径: TestPlain -> Threads(Users) -> Thread Group

 

线程组.jpg

模块属性:

number of Threads(users):并发用户数
Ramp-Up Period(in seconds):全量并发启动的完成时间
Loop Count: Forver/n, Forver:一直运行;n:执行次数
Duration(seconds):循环时间

如下图,设置为10并发,持续30秒,其中1秒内并发数达到10

 

线程组设置举例.jpg

HTTP Request

作用:新建http请求
新建路径:
线程组 -> Add -> Sampler -> HTTP Request

 

http.jpg

模块属性:

Protocol [http]   //协议类型,默认为http,可选择https
Server Name or IP   //请求域名,或IP+端口号
Method   // GET / POST请求
Path   //请求路径
Send Parameters   //请求参数

如下请求
https://xxx.xxx.163.com?_tdchannel={tdchannel} & sdkAuth={sdkAuth}
设置如下图,其中{tdchannel},{sdkAuth}采用CSV文件读取,稍后会介绍

http请求.jpg

 

CSV参数读取

作用:从CSV文件中读取数据,作为HTTPS的请求
新建路径:
线程组 -> Config ELement -> CSV Data Set Config

 

csv参数读取.jpg

模块属性:

Filename  //CSV文件路径
Variable Name  //定义变量名
Delimiter  //CSV分割符,模式使用","
Sharing mode  //作用域,默认选择全域,All thread

如下图,
从指定路径读取csv文件,
csv文件第一列变量名定义为channel,第二列变量定义为sdkAuth
分割符为","
作用域为全域
定义参数变量channel,sdkAuth后,可在请求中使用该变量

 

csv设置.jpg

正则表达式提取

作用:从请求结果中按正则表达式提取参数,即动态提取参数
新建路径:
Http请求 -> Add -> Post Processors -> Regular Expression Extractor

 

正则参数提取.jpg

模块属性:

Apply to  //使用作用域,默认选择 Main sample only 
Field to check  //匹配作用域,如选择Response Headers, 在响应请求头匹配正则表达式
Name of created variable //参数变量名
Regular Expression  //正则表达式
Template //匹配参数

如下图,定义正则匹配参数:
定义参数名为ch5sdk
参数使用域:请求全局
正则匹配范围为Response Headers
正则表达式为:_ch5sdk.us.c.v.online=(.*); Domain=,即匹配online的值

 

正则参数简介.jpg

观察结果树

作用:查看性能测试结果

新建路径:
线程组 -> Listener -> View Result Tree

 

结果树.jpg

 

模块属性:

Sampler result // 请求基本信息
Request // Request数据
Response data //  Response 数据

结果树rs.jpg

ant安装

官网:
http://ant.apache.org/bindownload.cgi
下载最新版本的ant zip安装包

antZip.jpg

 

解压ant zip包到指定文件

 

ant安装路径.jpg

环境变量设置

# add ant
export ANT_HOME=/usr/local/apache-ant-1.10.5
export PATH=$PATH:$ANT_HOME/bin

安装验证

ant -version

ant验证.jpg

Ant 运行jmeter脚本

配置

1)将 jmeter的extras目录中ant-jmeter-1.1.1.jar包拷贝至ant安装目录下的lib目录中
作用使Ant运行时能够找到"org.programmerplanet.ant.taskdefs.jmeter.JMeterTask"这个类,从而成功触发JMeter脚本

 

jmeter的jar设置.jpg

 

2)修改Jmeter的bin目录下jmeter.properties文件的配置:jmeter.save.saveservice.output_format=xml
作用使Jmeter报告输出文件格式为xml

 

jmeterxml.jpg

Ant执行jmeter脚本

1.jmeter安装目录下新建文件夹
TestReport文件夹:用于保存html的结果报告
TestScrip文件夹:用于保存jmeter的测试脚本

 

jmeter新建文件夹.jpg

2.运行jmeter脚本
如下图,需要注意2个文件

 

antBuild.jpg

 

build.xml:ant根据该文件运行jmeter脚本
build.xml通用模版如下:

<?xml version="1.0" encoding="UTF-8"?>

<project name="ant-jmeter-test" default="run" basedir=".">
    <tstamp>
        <format property="time" pattern="yyyyMMddHHmm" />
    </tstamp>
    <!-- 需要改成自己本地的 Jmeter 目录-->
    <property name="jmeter.home" value="/usr/local/apache-jmeter-4.0" />
    <!-- jmeter生成jtl格式的结果报告的路径-->
    <!-- <property name="jmeter.result.jtl.dir" value="/usr/local/apache-jmeter-4.0/TestReport/testToken/jtl"/> -->
    <property name="jmeter.result.jtl.dir" value="/Users/jc/.jenkins/workspace/helloWorld/test_token/jtl" />
    <!-- jmeter生成html格式的结果报告的路径-->
        <!-- <property name="jmeter.result.jtl.dir" value="/usr/local/apache-jmeter-4.0/TestReport/testToken/html"/> -->
    <property name="jmeter.result.html.dir" value="/Users/jc/.jenkins/workspace/helloWorld/test_token/html" />
    <!-- 生成的报告的前缀-->
    <property name="ReportName" value="TestReport" />
    <property name="jmeter.result.jtlName" value="${jmeter.result.jtl.dir}/${ReportName}${time}.jtl" />
    <property name="jmeter.result.htmlName" value="${jmeter.result.html.dir}/${ReportName}${time}.html" />
    <!-- 输出生成的报告名称和存放路径-->
    <echo message="${jmeter.result.jtlName}"/>
    <echo message="${jmeter.result.htmlName}"/>
    <echo message="${jmeter.result.html.dir}"/>

    <target name="run">
        <antcall target="test"/>
        <antcall target="report"/>
    </target>

    <!--加载jar包,解决显示时间问题-->  
    <path id="xslt.classpath">  
        <fileset dir="${jmeter.home}/lib" includes="xalan*.jar"/>  
        <fileset dir="${jmeter.home}/lib" includes="serializer*.jar"/>  
    </path> 
    
    <target name="test">
        <taskdef name="jmeter" classname="org.programmerplanet.ant.taskdefs.jmeter.JMeterTask" />
        <jmeter jmeterhome="${jmeter.home}" resultlog="${jmeter.result.jtlName}">
            <!-- 声明要运行的脚本。"*.jmx"指包含此目录下的所有jmeter脚本-->
            <testplans dir="/usr/local/apache-jmeter-4.0/TestScrip" includes="test.jmx" />
            
            <property name="jmeter.save.saveservice.output_format" value="xml"/>
        </jmeter>
    </target>
    
    <target name="report">
    <tstamp> <format property="report.datestamp" pattern="yyyy-MM-dd HH:mm" /></tstamp> 
        <xslt
              classpathref="xslt.classpath"  
              force="true" 
              
              in="${jmeter.result.jtlName}"
              out="${jmeter.result.htmlName}"
              style="${jmeter.home}/extras/jmeter-results-detail-report_21.xsl">
              <!--显示dateReport的时间--> 
              <param name="dateReport" expression="${report.datestamp}"/> 
        </xslt>
        <!-- 因为上面生成报告的时候,不会将相关的图片也一起拷贝至目标目录,所以,需要手动拷贝 -->
        <copy todir="${jmeter.result.html.dir}">
            <fileset dir="${jmeter.home}/extras">
                <include name="collapse.png" />
                <include name="expand.png" />
            </fileset>
        </copy>
    </target>
</project>

根据个人环境的不同,上述需要修改的模版参数为:

<!-- 需要改成自己本地的 Jmeter 目录-->
<property name="jmeter.home" value="/usr/local/apache-jmeter-4.0" />

<!-- jmeter生成jtl格式的结果报告的路径-->
<property name="jmeter.result.jtl.dir" value="/Users/jc/.jenkins/workspace/helloWorld/test_token/jtl" />

<!-- jmeter生成html格式的结果报告的路径-->
<property name="jmeter.result.html.dir" value="/Users/jc/.jenkins/workspace/helloWorld/test_token/html" />

<!-- 声明要运行的脚本。"*.jmx"指包含此目录下的所有jmeter脚本-->
<testplans dir="/usr/local/apache-jmeter-4.0/TestScrip" includes="test.jmx" />

jmeter脚本xx.jmx
根据build.xml中的testplans节点配置,运行test.jmx

3.运行结果
对应build.xml的路径,输入

ant run

运行结果结果

 

ant运行结果.jpg

4.查看运行报告
build.xml中设置的jmeter生成html格式的结果报告的路径查看结果

 

ant测试结果.jpg

 

html测试结果浏览器查看

 

html结果.jpg

Jenkins安装

安装Jenkins
官网:https://jenkins.io/index.html
安装方式
1.官网下载zip包
2.brew install jenkins

jenkins环境变量配置
mac 命令行编辑.bash_profile

# add jmeter
export JMETER=/usr/local/apache-jmeter-4.0
export CLASSPATH=$JMETER/lib/ext/ApacheJMeter_core.jar:$JMETER/lib/jorphan.jar:$JMETER/lib/logkit-2.0.jar:$CLASSPATH
export PATH=$PATH:$JMETER/bin

JDK配置
配置路径:
系统管理 -> 全局工具配置 -> JDK

 

jdk配置.jpg

Ant配置
配置路径:
系统管理 -> 全局工具配置 -> Ant

 

ant配置.jpg

1.构建一个自由风格的项目

 

image.png

2.配置构建步骤
参数说明

Ant Version //jenkins全局工具配置过Ant后,点击表单会出现在下拉框中,直接选中即可;
Targets //前一章中提到的build.xml文件中的targets的名字;
Build File //指定build.xml文件的路径以及文件名

image.png

3.jmeter.log授权
命令行输入

ls -lh
chmod 777 jmeter.log

如下图,jmeter.log为可执行文件

 

image.png

4.运行Jenkins任务

 

image.png

5.邮件配置
全局配置邮件发送者:
配置路径:
Jenkins的系统管理 -> 系统设置 -> Extended E-mail Notification

 

image.png

项目配置邮件接收者:
配置路径:
Jenkins项目 -> 配置 -> 构建后操作
参数配置

Project Recipient List //邮件接收者列表,间隔符为","
Content Type //邮件格式,选择“HTML(text/html)”
Default Content //默认邮件模版
Attachments //邮件附件,如test_token/html/*.html,表明html文件夹下所有html都会作为邮件附件
Triggers //高级设置的选项,建议选择运行success/failure-any 都Send To Reciplent List

邮件配置截图如下:

 

image.png

 

image.png

附件路径说明
1.Jenkins主目录
查看路径:系统管理 -> 系统设置 -> 主目录

 

image.png

2.Jenkins工作共建
Jenkins主目录/workspace

 

image.png

3.Ant执行build.xml配置
Jenkins能够获取工作区间的文件,因此需要修改builder.xml中的参数,将测试结果保存到Jenkins对应项目的工作区间,附件就能正确读取
如下

工作空间路径:
/Users/jc/.jenkins/workspace/helloWorld/
对应build.xml的参数设置为:
<property name="jmeter.result.jtl.dir" value="/Users/jc/.jenkins/workspace/helloWorld/test_token/jtl" />
<!-- jmeter生成html格式的结果报告的路径-->
<property name="jmeter.result.html.dir" value="/Users/jc/.jenkins/workspace/helloWorld/test_token/html" />

验证方法
运行对应项目,查看工作区间是否生成目标附件,如下图

 

image.png

 

ps:   整个环境搭建过程,查的资料踩的坑都挺多。主要参考文章转载记录下,大的方向都是按这个走的,还是比较详细的。

  • 0
    点赞
  • 2
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值