Jmeter+Maven+Jenkins+Git接口自动化流程

Posted mtxue

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了Jmeter+Maven+Jenkins+Git接口自动化流程相关的知识,希望对你有一定的参考价值。

 

 

 

 

   最近在实现 Jmeter+Maven+Jenkins+Git 接口自动化,研究不到两周,实现了 Jmeter+Maven+Jenkins+Git  接口自动化 的整体流程。 仅以此博客简单记录下自己实现的过程。

一. 职责、角色明确

  Jmeter: 执行者,录制接口测试脚本,运行脚本,得到结果,生成报告,统计数据;

  Maven,Git :管理者, Maven 主要负责项目的依赖管理,Git 主要负责项目的代码管理;

  Jenkins:调度者,持续集成(CI)工具;构建、部署自动化;可以持续编译,运行代码;运行UT或集成测试;将运行结果发送至邮件,或展示成报告。

二. 接口自动化意义

  基本上来说,有这么几点好处:提供测试效率;  完成手工测试复杂,但对自动化测试很简单的事 ;  反复执行; 提高维持测试覆盖度;日常巡检;

三. 环境准备

      想要全部实现,首先需要确保环境是ok的。jdk,jmeter,maven,git,jenkins 都需要是ok的。

3.1. java环境:java包安装,配置环境变量

cmd中 输入 java -version,显示java版本即安装成功

Java下载地址连接:https://www.oracle.com/technetwork/java/javase/downloads/jdk12-downloads-5295953.html

3.2  Jmeter安装

  Jmeter下载:http://jmeter.apache.org/download_jmeter.cgi

  jmeter下载压缩包后,解压,配置环境变量。

  即可使用 验证cmd,输入jmeter -v,显示jmeter版本,jmeter可正常使用。

技术图片

3.3 Maven

  maven 下载链接:http://maven.apache.org/download.cgi

  选择 二进制zip存档链接,下载解压,安装;

  配置环境变量,MAVEN_HOME;将%MAVEN_HOME%\\bin添加到Path变量下

  验证:cmd中输入 mvn -v

maven运行,需要安装maven IDE插件--eclipse:下载安装链接: https://www.runoob.com/eclipse/eclipse-install.html,安装neon版本。 (具体安装,不再详述)

3.4 git 

  git 下载: http://git-scm.com/downloads

  git安装完成后,在菜单git-git bash,点击,显示一个类似命令行窗口的东西,说明git安装成功。

其中git 安装完毕后,需要进行ssh连接,才能使用。 稍微,git的ssh 认证单独写一篇。

3.5 Jenkins, 如果公司有运维,一般是运维在服务器上安装Jenkins,然后给相关人员 公司jenkins地址链接,同时每个人的用户名与密码。 

当然,没有运维,自己电脑上也可以安装本地jenkins,进行自动化的构建。

下面进入本篇的正题:接口自动化 整体流程。。  自动化流程 -----key

一、使用jmeter 进行接口脚本准备,脚本运行通过,保存脚本jmx,导出。

二、使用eclipse 创建Maven项目 eclipse打开--file---New--other,

Select a wizard,选择Maven--Maven project,点击next。

界面进入New Maven Project,选择 第二个:User default Workspace location:使用本地默认的工作空间

技术图片

 

 默认使用第2 个,点击next。界面进入New Maven project,Catalog,Filter 选择 Artifact Id: maven-archetype-webapp,版本1.0,点击next、

技术图片

其中Group Id:组Id,针对一个项目的普遍唯一识别符。是项目组织唯一的标识符,实际对应JAVA的包的结构,是main目录里java的目录结构,相当于我们日常使用的包名,例如:org.hhh,最好是填写公司或者组织名称 com.company Artifact Id:要新建的项目的名字,项目的唯一的标识符,实际对应项目的名称,就是项目根目录的名称 Version:版本号,默认0.0.1-SNAPSHOT。 package:输入group、artifact,会自动生成package,目录+名字=完整路径。输入group,artifact,点击next,生成maven项目 注意:group id+artifact id+version必须是一个唯一的名字,不要和任何别的jar包全名一模一样,否则会引发冲突。

技术图片

 

 使用eclipse,创建maven项目、成功。

使用eclipse 创建maven项目,只会自动生成src/main/resources 和target/classes, target/test-classes,需要自己手动添加其他目录,并且指定项目的source以及编译后的输出目录。 使用eclipse运行接口测试脚本,选择project 右击----run as ------maven build,然后再弹出的对话框Goals 写上verify,--run。运行后会有测试结果文件,显示BUILD SUCCESS,即为运行成功。

二)、Maven项目约定

Maven中使用项目约定,它约定Java源代码放在哪个目录,约定编译的class文件放在哪个目录,约定资源或配置文件放在哪个目录,每一种文件的存放目录都有着明确的约定,下面是Maven的项目约定结构图:

MavenProject(项目根目录)    

|----src —— 源代码目录    |     

  |----main        ----  开发使用

    |----java —— 存放项目的.java文件     

    |----resources —— 存放项目资源文件,如spring、hibernate配置文件    |      |       

    |----webapp ---如果是web项目则需要该目录,存放WEB-INF目录、web.xml、jsp、html、js等文件    | 

  |----test -----测试 主用         

    |----java —— 存放所有测试.java文件,如JUnit测试类  

    |----resources —— 存放项目测试用的资源文件,如spring, hibernate配置文件  

|----target —— 项目输出目录,存放经过编译的class文件和打包部署的jar包等    

|----pom.xml —— 定义项目的对象模型,同时标识该项目是一个Maven项目

三)、本地构建Maven项目

1.在src下手动新建test目录,src/test目录下新建jmeter文件夹,把准备好的jmeter接口测试的jmx脚本复制到这个文件夹下

2.在src/test目录下创建resources文件夹,并把测试模板(E:\\apache-jmeter-5.1\\apache-jmeter-5.1\\extras的如下文件)复制到这个resources文件下

文件1:jmeter-results-detail-report_21.xsl 

文件2:jmeter-results-report_21.xsl

3.将下面五个文件从jmeter/bin目录复制到 src/test/jmeter文件夹

文件1 :jmeter.properties

文件2:saveservice.properties

文件3:system.properties

文件4:upgrade.properties

文件5:user.properties

四)、关键点:pom.xml 配置文件 -------构建 Maven项目中最重要的一个文件

pom 配置文件,maven项目生成时 ,pom文件中是有一部分内容的。 我们主要是在pom 文件中增加各种插件

4.1 测试报告---html地址配置。properties 增加在dependencies依赖之前

<properties>

<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>

<jmeter.result.jtl.dir>$project.build.directory/jmeter/results</jmeter.result.jtl.dir >

<jmeter.result.html.dir>$project.build.directory/jmeter/html</jmeter.result.html.dir > <jmeter.result.html.dir1>$project.build.directory/jmeter/html1</jmeter.result.html.dir1>

<ReportName>TestReport</ReportName>

</properties>

其中需要注意,多个报告时, html 与 html1, dir 与dir1。 如果设置一样,生成报告 可能会存在 报告一致的情况。

其他插件增加在 dependencies依赖 build finalName 后

测试报告configuration中的 transformationSets配置

<dir>$jmeter.result.jtl.dir</dir>

<stylesheet>src/test/resources/jmeter-results-detail-report_21.xsl</stylesheet>

<outputDir>$jmeter.result.html.dir</outputDir>

<fileMappers>

<fileMapper implementation="org.codehaus.plexus.components.io.filemappers.FileExtensionMapper"> <targetExtension>html</targetExtension> </fileMapper> </fileMappers>

核心插件jmeter -maven-plugin     --------核心插件

<plugin>

<groupId>com.lazerycode.jmeter</groupId>

<artifactId>jmeter-maven-plugin</artifactId>

<version>2.4.1</version>

<configuration>

<resultsFileFormat>xml</resultsFileFormat>

<ignoreResultFailures>true</ignoreResultFailures>

<ignoreResultErrors>false</ignoreResultErrors>

<testResultsTimestamp>false</testResultsTimestamp>

<resultsDirectory>$jmeter.result.jtl.dir</resultsDirectory>

</configuration>

<executions>

<execution> <id>jmeter-tests</id>

<phase>verify</phase>

</plugin>

<goals>

<goal>jmeter</goal>

</goals>

</execution>

</executions>

此核心插件:用来执行jmx脚本,版本号特别注意。 上一页与本页是 该核心插件。其中配置解释 resultsFileFormat:设置jmeter生成结果文件格式; ignoreResultFailures:设置忽略失败是否停止运行; ignoreResultErrors:设置忽略错误是否停止运行 testResultsTimestamp:设置结果是否有时间戳 resultsDirectory: 指定jtl 生成目录。

脚本所在文件夹

<executions>

<execution>

<id>jmeter-tests</id>

<phase>verify</phase>

<goals>

<goal>jmeter</goal>

</goals>

</execution>

</executions>

插件 xml-maven-plugin, 配置文件中: (该插件:根据xsl模板把jtl文件转换成html) ?

<groupId>org.codehaus.mojo</groupId>

<artifactId>xml-maven-plugin</artifactId>

<version>1.0.2</version>

<executions>

<execution>

<phase>verify</phase>

<goals>

<goal>transform</goal>

</goals>

</execution>

</executions>

<configuration>

xml 插件的configuration 中配置两个报告 transformationSet ,每个报告中包括dir,stylesheet,outputDir,报告配置如下

<transformationSet>

<dir>$jmeter.result.jtl.dir</dir>

<stylesheet>src/test/resources/jmeter-results-detail-report_21.xsl</stylesheet>

<outputDir>$jmeter.result.html.dir</outputDir>

<fileMappers>

<fileMapper implementation="org.codehaus.plexus.components.io.filemappers.FileExtensionMapper">

<targetExtension>html</targetExtension> </fileMapper>

</fileMappers>

</transformationSet>

注意:多个报告时,报告的stylesheet、outputDir 必须不能一致。stylesteet 是指定的报告样式,可以自己网上下载样式,放置jmeter 相关文件中,这里写上;也可以使用jmeter 包中现有的 报告样式; 另外,jmeter的配置文件,其实可以进行修改 代码,来获得自己想要的报告样式;

最后一个插件,XSLT插件  (忘记这个插件是什么作用了)

<dependency>

<groupId>net.sf.saxon</groupId>

<artifactId>saxon</artifactId>

<version>8.7</version>

</dependency>

基本以上,是所有的pom 中需要配置的插件。 代码需要自己输入,粘贴会出现 缩进等问题

五)、eclipse运行接口测试脚本

运行接口测试脚本

选择project 右击----run as ------maven build,然后再弹出的对话框Goals 写上verify,--run。

运行后会有测试结果文件。运行,console中等待运行完毕,显示build success,即运行成功。

脚本构建成功,在target中生成报告,target中 jmeter/html 中是生成的报告。

如果有多维度报告,jmeter会存在多个html。

注意问题:如果需要生成多个报告,pom.xml文件中html的transformationSet 中,stylesheet 配置两个报告模板,生成html报表文件路径outputDir 不能重复,一个dir,一个dir1 到此,jmeter + maven项目,本地已经构建成功。可成功生成报告。

技术图片

 

 技术图片

 

 三、Jenkins   本地下载安装

https://jenkins.io/download/ 官网下载安装;

坑一:jenkins中新建项目 没有一个 “创建一个Maven项目”的选项

解决:需要安装Maven 项目插件:Maven Integration.

系统管理---管理插件--可选插件,搜索框中输入插件名Maven Integration,搜索到,点击安装,安装完毕重启,重启ok。

jenkins 构建maven本地项目

Maven项目本地调试通过,在cmd中切换到maven 项目 的pom.xml 所在路径, 执行mvn clean install ,显示BUILD SUCCESS----执行成功

jenkins中 Manage Jenkins, Glogal Tool Configuration, 配置jdk,

其中,install automatically ,如果想使用本地jdk,可以不勾选。

写上本地jdk 版本号,jdk 本地安装路径 maven 使用本地maven的话,同样不勾选,install automatically ,写上本地maven 版本号,本地maven 安装路径。

配置完成,点击应用。 (本地jenkins,JDK,maven需要自己配置。 公司服务器,jenkins 基础服务运维负责)

技术图片

 

 Jenkins 本地构建

jenkins新建项目----maven项目,构建Maven项目,

General:输入简单的描述               源码管理:None   

Pre Steps:Execute Windows batch command

命令:  (cmd 命令窗口框中的命令一致,即可。)

cd C:\\Maven\\MavenProject\\testOne    

mvn clean install

Build

Root POM: C:\\Maven\\MavenProject\\testOne\\pom.xml

点击:应用。

即可 应用,构建的时候,起作用。

点击构建,点击build 下的本次构建的进度条,--console output,查看日志,日志最后Finish success,即构建成功。 构建失败,同样可以在日志中查看错误。

二)、Jenkins Html测试报告

系统管理---- 插件管理-- 可选插件,下载HTML Publisher。 (本地jenkins需要,公司jenkins,运维)

构建项目,构建后操作-----Publish HTML reports 构建后操作-----Publish HTML reports,

HTML directory to archive: target\\jmeter\\html (jenkins本地项目可使用路径,一般连接公司jenkins时,默认所在位置:当前项目目录,所以直接输入当前目录后路径即可)

index page:index.html

Report title: 测试报告

技术图片

三)Jenkins 邮件通知

Email Extension Plugin 插件

系统管理---系统设置,在系统设置中找到Jenkins Locaction 填好JenkinsURL 跟系统管理员的邮件地址,注意必填。

邮件通知--点击高级配置 QQ邮箱smtp服务器地址:**smtp.qq.com** (qq邮箱要登陆邮箱→设置→账户 开启SMTP服务) 使用SMTP认证,勾选。

jenkins 邮件通知输入,

用户名:输入自己的QQ

密码:Q邮箱的话,是你开启smtp服务后他会给你密码的,而不是你的QQ邮箱密码了。

端口号:465 勾选通发送测试邮件测试配置 ,Test configuration 点击,测试是否配置成功。 如果email 显示成功,则测试 邮件发送成功。

注意:邮件端口号:一定 465,其他,邮件通知发送不成功。

四、 Jmeter + Maven + Jenkins + Git

本地代码放置git上,代码同步;

源码管理,选择Git,输入git 上该项目http地址,输入git用户名、密码

需要配置--general、源码管理、构建触发器、Build、Post Steps、构建设置(E-mail Notification)、 构建后操作(html报告,邮件Edirtable Email Notification)--- 搞定。

使用 git中代码,Pre Steps 就不需要输入命令。 ---build 中 pom + goals 命令就可以了 (使用公司服务jenkins,一般jenkins各种系统配置运维会配置。个人拿到自己的账号、密码,登录成功,就可以构建自己的自动化项目了)

Build中,root Pom 输入maven 项目 ./pom.xml Goals and options :clean verify

技术图片

Post Steps   

构建三个选择---可根据需要设置

技术图片

 

 

构建设置:邮箱设置,多个邮箱,英文空格为间隔。选择第一、第三 ------(可根据自己实际需要进行设置) 每一次不稳定的构建、每一次失败的构建--都需发送邮件

技术图片

 

 

构建后操作 构建后 HTML 报告,报告路径:target/jmeter/html index page:多个jmx 脚本,多个报告时,以英文逗号隔开 Report title:jenkins运行完毕脚本后,显示的报告title

 

构建后邮件设置

构建后邮件-Editable Email Notification

勾选 Project Recipient List :[email protected] [email protected] (邮件接收人,多个接收人时可空格/逗号 隔开)

Project Reply-To List : $DEFAULT_REPLYTO

Content Type :HTML(text/html) ---- 邮件 中内容格式

Default Subject : $DEFAULT_SUBJECT

Default Content : $DEFAULT_CONTENT

Advanced Setting:点击 (高级配置)

Pre-send Script :$DEFAULT_PRESEND_SCRIPT

Post-send Script: $DEFAULT_POSTSEND_SCRIPT

Triggers , 勾选 Always, send to --勾选 Recipient List, 高级--点击

展开中: Recipient List :收件人

Reply-To List: $PROJECT_DEFAULT_REPLYTO (回复列表)

Content Type:HTML(text/html)

Subject: 【接口测试报告】$PROJECT_NAME - $BUILD_STATUS - Build #$BUILD_NUMBER!

subject--邮件标题

Content:邮件中内容,是一段 html 代码。

点击应用。。

到目前为止,jmeter + maven +jenkins +git,项目已全部增加。

jenkins中点击testone,进入;

点击左侧--立即构建,下面显示构建进度条 进度条走完,变成 蓝色球:构建成功;

变成灰色球,构建失败;

构建过程中,点击 该次构建,进入本次构建详情页, 构建详情页中,左侧有控制台输出,点击进入可查看 构建日志 构建完毕,收件人邮箱收到 本次构建结果。

 

以上是关于Jmeter+Maven+Jenkins+Git接口自动化流程的主要内容,如果未能解决你的问题,请参考以下文章

使用Jmeter-Maven-Plugin搭建基于jmeter+Jenkins的性能测试平台

Jmeter +Maven+jenkins+eclipse 接口自动化测试

使用Maven Jenkins和JMeter自动化测试

Jmeter+Jenkins+Maven 集成

Jenkins+maven+jmeter接口可持续集成自动化测试

maven+jmeter+jenkins集成