基于Jmeter和Jenkins接口自动化测试框架搭建详细过程

拼搏现实的明天。 2022-07-14 12:00 216阅读 0赞

### 1. 下载地址 ###

Jmeter： http://jmeter.apache.org/download\_jmeter.cgi

Ant：http://ant.apache.org/bindownload.cgi

Jenkins：https://jenkins.io/index.html

### 2. Jmeter+Ant安装配置 ###

*  Jmeter解压后运行Jmeter.bat即可使用
 *  Ant下载后解压到目录，按照下列配置系统变量即可：

1) ANT\_HOME：D:\\apache-ant-1.9.4-bin\\apache-ant-1.9.4（此为ANT安装路径）

2) PATH（后面添加以下内容）：*;%ANT\_HOME%\\bin*

3) 测试Ant：在CMD中输入ant –version，如果返回ant版本，则表示安装成功

*  将JMeter目录下extras子目录里ant-JMeter-1.1.1.jar复制到Ant的lib目录下，这样Ant运行时才能找到，"org.programmerplanet.ant.taskdefs.jmeter.JMeterTask"这个类，从而成功触发JMeter脚本。
 *  jmeter默认保存的是.csv格式的文件，所以我们先要设置一下bin/jmeter.properties文件内容，保存

>     jmeter.save.saveservice.output\_format=xml

*  配置ant构建文件build.xml（见附录）

### 3. Jenkins安装与配置 ###

Jenkins安装比较简单，点击msi文件按照要求操作即可，过程若出现问题，可重启下jenkins服务后，再继续安装；

接下来主要介绍Jenkins构建ant项目的配置：

浏览器输入地址http://localhost:8080/显示界面，则表示安装成功

### 4. shell运行环境搭建 ###

安装cygwin后，配置环境变量

l 按照下列配置系统变量即可：

1） JAVA\_HOME：D:\\ Program Files\\Java\\jdk1.8.0\_11（此为JDK安装路径）

2） ANT\_HOME：D:\\apache-ant-1.9.4-bin\\apache-ant-1.9.4（此为ANT安装路径）

3） PATH（后面添加以下内容）：

*;%JAVA\_HOME%\\bin;%JAVA\_HOME%\\jre\\bin;%ANT\_HOME%\\bin;E:\\Program Files\\cygwin\\bin*

4） 测试Ant：在CMD中输入ant –version，如果返回ant版本，则表示安装成功

5） 测试Java：在CMD中输入 java –version，如果返回java版本，则表示安装成功

6） 测试shell运行环境：在CMD中输入sh，如果为提示错误，则表示安装成功

### 5. Testlink与Jenkins对接 ###

1、先安装过程所需要的插件：Testlink Plugin、TAP Plugin

直接在系统管理—>管理插件—>可选插件，中搜索后，点击安装即可

**注意：TAP插件必须用1.25版本的，新版本发布后tap文件链接失效**

2、 系统管理—>系统设置，Testlink配置如下：

**Name**：TestLink 1.9.10

**URL**：http://192.168.4.56/testlink/lib/api/xmlrpc/v1/xmlrpc.php

**Developer Key**：登录TestLink后，选择个人账号—生成新的秘钥，API Key拷贝到这里即可

### 6. TestLink配置 ###

Testlink需要增加自定义字段，如AutoTest，具体的用例如下：

![834003-20161208181802007-1393218413.png][]

注意两点：  
1）测试方式：自动的

2）AutoTest：内容为对应该条用例的.tap文件的文件名

### 7. 构建项目 ###

#### 7.1. 准备测试脚本到SVN ####

![834003-20161208181845726-1257879839.png][]

上图是SVN中对应的文件结构，下面会介绍jenkins构建项目的详细配置。

#### 7.2. 新建一个自由风格的软件项目 ####

![834003-20161208181901460-1376388297.png][]

旧的构建保存了你在一次构建中的所有临时文件，如果构建没有保留的必要，就勾选丢弃旧的构建，同时设置保持构建天使和保持构建的最大个数两个参数。注意：三个设置必须同时设置，否则无效

#### 7.3. 源码管理 ####

选择subversion

![834003-20161208181924194-776776580.png][]

Repository URL：SVN中脚本目录

Credentials：SVN账号用户名和密码，可点击后面的Add添加

Local module directory：SVN下载到本地的目录，配置为【.】默认项目根目录下【注：这个与Ant的build.xml文件中的配置相关联，默认的文件是根目录，若这里有修改，需要修改对应的build.xml文件】

#### 7.4. 触发器配置 ####

![834003-20161208181944069-2037350703.png][]

这里是让脚本每天晚上自动构建执行，若不需要重复执行，则不要勾选该项接口

#### 7.5. 构建Invoke TestLink ####

![834003-20161208182004522-492640988.png][]

注：

1、 TestLink Configuration中TestProjectName和TestPlan Name需要与testlink中的【测试项目】和测【测试计划】一致

2、 TestLink Configuration中BuildName：

1） 可以与Testlink设置一致（这样每次测试结果会在同一个测试版本中记录多次结果）

2） 也可以设置由Jenkins配置返回，如：上图中的$BUILD\_TAG,则表示将构建这次项目的标记作为版本返回到TestLink上，这样每一次构建，Testlink上都会新增一个版本

3、 Targets：这里是指build.xml文件中的<target name=“xxx”>,可设置为空，则默认全部执行

4、 这里的Build File是指Ant的build.xml所在目录，若前面SVN目录有修改，这里也需要一并修改

5、 After iterating all test cases Build Steps：这里运行jmx.sh文件，将Jmeter运行结果XML格式，转换为TAP格式，以便TestLink转换为测试结果

![834003-20161208182021788-1600747202.png][]

这个配置是将TAP结果返回到Testlink，

注意：

Include Pattern：这里的路径与build.xml文件中输出的路径一致。

#### 7.6. TAP结果发布 ####

![834003-20161208182039429-445392117.png][]

Test results:结果路径配置，与build.xml中配置输出路径一致

#### 7.7. 构建后邮件发送 ####

增加构建后操作：Editable Email Notification

![834003-20161208182058382-1339774015.png][]

#### 7.8. 系统配置：邮件的全局参数配置 ####

![834003-20161208182113866-883573060.png][]

未截图的按默认配置

备注：

**Default Subject**：用例执行结果:$PROJECT\_NAME - Build \# $BUILD\_NUMBER - $BUILD\_STATUS!

**Default Content**：

![复制代码][copycode.gif]

${FILE,path="sum/sum.html"}<hr/> 
 
 (本邮件是程序自动下发的，请勿回复！) 
 
 项目名称：$PROJECT_NAME 
 
 构建编号：$BUILD_NUMBER 
 
 svn版本号：${SVN_REVISION} 
 
 构建状态：$BUILD_STATUS 
 
 触发原因：${CAUSE} 
 
 构建日志地址：<a href="${BUILD_URL}console">${BUILD_URL}console</a> <hr/> 
 
 构建地址：<a href="$BUILD_URL">$BUILD_URL</a> <hr/> 
 
 变更集:${JELLY_SCRIPT,template="html"} <hr/>

![复制代码][copycode.gif]

邮件通知配置，根据邮箱实际情况进行配置即可，如下：

![834003-20161208182130601-641938560.png][]

## ##

### 8.附录 ###

JMX2TAP.SH内容：

![ExpandedBlockStart.gif][]

1 #!/bin/bash
 2 LANG=zh_CN.UTF-8
 3 export LANG
 4 # Parse each result file from the tests, created by JMeter when run by ant.
 5 # Every file created by JMeter will be parsed consecutively by the following for loop.
 6 for XML_resultfile in $(ls -1 results/*.xml); do
 7 echo "XML_resultfile: ${XML_resultfile}"
 8 BASE_filename=$(basename ${XML_resultfile} .xml) 
 9 TestSamples=( $(xpath ${XML_resultfile} '//@lb' 2>/dev/null) ) 
 10 num_of_TestSamples=${#TestSamples[@]}
 11 echo "num_of_TestSamples: ${num_of_TestSamples}"
 12 # Reference to TAP13 file standard:
 13 # link:http://www.4pan.net
 14 # result_selector=0 
 15 if [ ${num_of_TestSamples} -gt 0 ]; then
 16 for ((line=0; ${line} < ${num_of_TestSamples}; line++)); do 
 17 echo "------------------CASE ${line}--------------------------" 
 18 echo "TestCases fullname: ${TestSamples[${line}]}"
 19 isFlag=$( echo ${TestSamples[${line}]} | grep '.*-.*-.*(.\{1,\}):.*')
 20 if [ "${isFlag}" != "" ]; then
 21 filename=$( echo ${TestSamples[${line}]} | cut -d '"' -f 2 | cut -d '(' -f 1 )
 22 TAP_filename=${filename}.tap
 23 isExistTap=""
 24 isExistTap=$(ls -R | grep "${TAP_filename}")
 25 if [ "${isExistTap}" == "" ]; then
 26 TestCase=$( echo ${TestSamples[${line}]} | cut -d '"' -f 2 | cut -d ':' -f 1 )
 27 num_of_testcases=1
 28 TestCase_count1=( $(xpath ${XML_resultfile} "//httpSample[contains(@lb,'${filename}')]/@rc" 2>/dev/null) )
 29 TestCase_count2=( $(xpath ${XML_resultfile} "//sample[contains(@lb,'${filename}')]/@rc" 2>/dev/null) )
 30 ((num_of_testcases=${#TestCase_count1[@]}+${#TestCase_count2[@]}))
 31 echo "TestCase:${TestCase}"
 32 echo "filename:${TAP_filename}"
 33 echo "TestCase_count:${num_of_testcases}" 
 34 label="${BASE_filename} - ${TestCase}" 
 35 echo "TAP version 13" > results/${TAP_filename}
 36 echo ">>>${BASE_filename}.xml Covert to : ${TAP_filename}" 
 37 echo "1..${num_of_testcases}" >> results/${TAP_filename}
 38 # Create an array with testcases labels and results
 39 result_if1=( $(xpath ${XML_resultfile} "//httpSample[contains(@lb,'${filename}')]/assertionResult[failure='true']/failure" 2>/dev/null | tr -d '"' | tr ' ' '_' | sed 's/^_//') )
 40 result_if2=( $(xpath ${XML_resultfile} "//sample[contains(@lb,'${filename}')]/assertionResult[failure='true']/failure" 2>/dev/null | tr -d '"' | tr ' ' '_' | sed 's/^_//') )
 41 ((num_of_resultif_count=${#result_if1[@]}+${#result_if2[@]}))
 42 echo ">TestResult:${num_of_resultif_count}"
 43 #echo "number_result_if:${#result_if[@]}"
 44 if [ ${num_of_resultif_count} -gt 0 ]; then
 45 msg_texts=( $(xpath ${XML_resultfile} "//httpSample[contains(@lb,'${filename}')]/assertionResult[failure='true']/failureMessage" 2>/dev/null | tr -d '"' | tr ' ' '_' | sed 's/^_//') )
 46 result="not ok ${num_of_testcases} ${label} - error[${num_of_resultif_count}]"
 47 echo "${result}">> results/${TAP_filename}
 48 echo "failureMessage:${msg_texts}">> results/${TAP_filename} 
 49 #echo "${result}"
 50 #echo "failureMessage:${msg_texts}"
 51 #(( line=${line}+${num_of_testcases}-1 )) 
 52 #echo "msg_text:${msg_texts}">> results/${TAP_filename}
 53 #num_of_msg_texts=${#msg_texts[@]}
 54 #echo "num_of_msg_texts:${num_of_msg_texts}"
 55 #echo "num_of_msg_texts:${msg_texts}"
 56 #for ((msgnum=0; ${msgnum} <${num_of_msg_texts}; msgnum++)); do 
 57 #msg_text="message[${num}]:'$(echo ${msg_texts[${msgnum}]}| cut -d '>' -f 2 | cut -d '<' -f 1)'"
 58 #echo "${msg_texts}"
 59 #done 
 60 else 
 61 if [ ${num_of_testcases} -gt 0 ]; then
 62 result="ok ${num_of_testcases} ${label} - error[${#result_if[@]}]"
 63 echo "${result}">> results/${TAP_filename}
 64 #echo "${result}"
 65 #(( line=${line}+${num_of_testcases}-1 ))
 66 else
 67 result="not ok 1 - ${num_of_testcases} ${label} - error[XML Covert to TAP ERROR:Xpath query find 0 result]"
 68 echo "${result}">> results/${TAP_filename}
 69 #echo "${result}"
 70 #(( line=${line}+${num_of_testcases} ))
 71 fi 
 72 fi
 73 else
 74 echo ">tap already converted"
 75 fi
 76 else
 77 echo "sample name is not standard"
 78 fi
 79 done
 80 else
 81 echo "over" >> results/${TAP_filename}
 82 fi
 83 done

build.xml内容

![ExpandedBlockStart.gif][]

1 <?xml version="1.0" encoding="UTF-8"?>
 2 <project name="ant-jmeter-test" default="run" basedir=".">
 3 <tstamp> <format property="time" pattern="yyyyMMddhhmm" /> </tstamp>
 4 <tstamp> <format property="report.datestamp" pattern="yyyy/MM/dd HH:mm" /></tstamp>
 5 <property environment="env"/>
 6 <property name="report.title" value="接口测试"/> 
 7 <property name="jmeter.home" value="${env.JMETER_HOME}" /> 
 8 <property name="jmeter.result.dir" value="${env.WORKSPACE}/results" />
 9 <property name="jmeter.sum.dir" value="${env.WORKSPACE}/sum" />
 10 <property name="testplan.dir" value="${env.WORKSPACE}" />
 11 
 12 
 13 <property name="ReportName" value="TestReport" />
 14 <property name="jmeter.result.jtlName" value="${jmeter.result.dir}/${ReportName}.xml" />
 15 <property name="jmeter.result.htmlName" value="${jmeter.result.dir}/${ReportName}.html" />
 16 <property name="jmeter.sum.htmlName" value="${jmeter.sum.dir}/sum.html" />  
 17 
 18 <target name="run">
 19 <echo message="start..."/>
 20 <antcall target="clean" />
 21 <antcall target="test" />
 22 <antcall target="report" />
 23 </target>
 24 <target name="clean">
 25 <delete dir="${env.WORKSPACE}/results/" />
 26 <mkdir dir="${env.WORKSPACE}/results" />
 27 <delete dir="${env.WORKSPACE}/sum/" />
 28 <mkdir dir="${env.WORKSPACE}/sum" /> 
 29 </target>
 30 <target name="test">
 31 <taskdef name="jmeter" classname="org.programmerplanet.ant.taskdefs.jmeter.JMeterTask" />
 32 <jmeter jmeterhome="${jmeter.home}" resultlog="${jmeter.result.jtlName}">
 33 
 34 
 35 
 36 <testplans dir="${testplan.dir}" includes="${env.TESTLINK_TESTCASE_TESTFILEPATH}.jmx" />
 37 <property name="jmeter.save.saveservice.output_format" value="xml"/>
 38 <property name="jmeter.save.saveservice.assertion_results" value="all"/>
 39 <property name="jmeter.save.saveservice.bytes" value="true"/> 
 40 </jmeter>
 41 </target>
 42 <path id="xslt.classpath">
 43 <fileset dir="${jmeter.home}/lib" includes="xalan*.jar"/>
 44 <fileset dir="${jmeter.home}/lib" includes="serializer*.jar"/>
 45 </path>
 46 
 47 <target name="report">
 48 
 49 <xslt classpathref="xslt.classpath"
 50 force="true"
 51 in="${jmeter.result.jtlName}" 
 52 out="${jmeter.result.htmlName}" 
 53 style="${jmeter.home}/extras/jmeter.results.shanhe.me.xsl"> 
 54 <param name="dateReport" expression="${report.datestamp}"/>
 55 </xslt>
 56 <xslt classpathref="xslt.classpath"
 57 force="true"
 58 in="${jmeter.result.jtlName}" 
 59 out="${jmeter.sum.htmlName}" 
 60 style="${jmeter.home}/extras/jmeter-results-detail-report_21-lj.xsl"> 
 61 <param name="dateReport" expression="${report.datestamp}"/>
 62 </xslt>
 63 
 64 <copy todir="${jmeter.result.dir}">
 65 <fileset dir="${jmeter.home}/extras">
 66 <include name="collapse.png"/>
 67 <include name="expand.png"/>
 68 </fileset>
 69 </copy>
 70 </target>
 71 </project>
 72

[834003-20161208181802007-1393218413.png]: /images/20220714/2e59f42d56074263b9b2b8d65b5e3211.png
[834003-20161208181845726-1257879839.png]: /images/20220714/96537724bb494c2f837cfac31412490b.png
[834003-20161208181901460-1376388297.png]: /images/20220714/6f9600247ea54678a3edb8057c67827c.png
[834003-20161208181924194-776776580.png]: /images/20220714/f51520eb848b4565a72ccd38a6016551.png
[834003-20161208181944069-2037350703.png]: /images/20220714/558f352750594a63bf5ad1db96360c1a.png
[834003-20161208182004522-492640988.png]: /images/20220714/b4075e70244c4ab180d8435ad23762f7.png
[834003-20161208182021788-1600747202.png]: /images/20220714/6d0901b42db74425ae142137554dab7a.png
[834003-20161208182039429-445392117.png]: /images/20220714/cbc7f7e2ceb74f768595e1c5d38556d1.png
[834003-20161208182058382-1339774015.png]: /images/20220714/e079fa13fa9d48b18190f363c9d1fd00.png
[834003-20161208182113866-883573060.png]: /images/20220714/c40fe776c65b473da7679ec744ca309e.png
[copycode.gif]: /images/20220714/47bbf80143af4d3abbb54137290a0f53.png
[834003-20161208182130601-641938560.png]: /images/20220714/85f26a4cf63e4945990815c0e4692121.png
[ExpandedBlockStart.gif]: /images/20220714/2362b0ac941644a1a1e319df20d1d1c1.png