Web API 持续集成:PostMan+Newman+Jenkins(图文讲解)
本文由葡萄城技术团队于OSChina原创并首发
转载请注明出处:葡萄城官网,葡萄城为开发者提供专业的开发工具、解决方案和服务,赋能开发者。
上篇文章我们已经完成了API测试工具选型,接下来是一系列周期性的开发测试过程:接口开发、检出代码、运行测试、记录结果、发送报告。为了快速发现问题,并减少重复过程以节省时间、费用和工作量,我们需要一套完整的持续集成解决方案,除接口开发之外其他环节全部自动完成,无需太多的人工干预。
这篇文章将对持续集成解决方案进行一步一步的讲解,希望对大家能有帮助。
1. Web Api 测试工具选型
目前市场有很多的用于API 测试的工具,如Postman, SoapUI, YApi, HttpRunner等等。
在进行了很多的尝试后,我们最终还是决定在Postman和Soap UI间做出抉择,在经过我们详细的对比后:https://my.oschina.net/powertoolsteam/blog/2243550
最终我们选择了Postman。
2. 用Postman创建项目
选型做好了,第二步当然是Postman用起来了,创建自己的项目。参照Postman官网的文档。https://learning.getpostman.com/docs/postman/collections/intro_to_collections/
- 创建 LeyserkidsApi项目
3. 源码管理
因为我们项目使用TFS做源码管理,这里就以TFS为例。
- 把Postman中项目LeyserkidsApi的Collection和Envrionment导出为json文件。
- TFS创建项目LeyserKids,追加Postman导出的JSON文件,进行资源版本管理。接下来展示的项目结构如下:
4. Jenkins服务搭建
我们称搭建Jenkins Server的机器为:机器A,后续步骤需要对这台机器安装一些Services。
5. Jenkins与TFS关联
- 创建FreeStyle Project :Test
- Jenkins主页->Manage Jenkins->Manage Plugins->找到Team Foundation Server插件并安装。
- 进入Project Test详细页面->Configure->Source Code Management
- Build Triggers 设置当源码发生变化时,重新构建。可以每天定时构建。
6. Jenkins构建(Build)
Newman是用命令行来执行Postman的Collection。可以很容易的和Jenkins集成。Newman是基于Nodejs的,所以首先得安装Nodejs。
- 在机器A(Jenkins Server)上安装nodejs和newman。参照:https://learning.getpostman.com/docs/postman/collection_runs/command_line_integration_with_newman
- 进入Test详细页面->Configure ->Build->Add Build Step->Execute Windows batch command->command
7. 邮件配置
Jenkins构建之后,发送邮件,通知构建结果。邮件配置步骤如下:
- Jenkins主页->ManageJenkins->Manage Plugins->找到Email Extension Plugin插件并安装->插件安装之后需要重启jenkins 服务
- Jenkins主页->Manage Jenkins->Configure System-> Extended E-mail Notification, 配置邮件Server
- 进入Test详细页面->Configure-> Post-build Actions->Add post-build action(Editable-Email Notification)
- 进入Test详细页面
- 对Test进行配置
- Post-build Actions追加动作:Editable-Email Notification
- 配置Editable-Email Notification
- 进入Test详细页面
8. 项目构建
经过以上步骤的配置,构建完成之后,会收到邮件,根据链接在console output查看构建结果,不是很直观。下一步中将进行改善。
9. 更优美的邮件模板
默认的邮件内容过于简单,用Email Extension Plugin 提供的Groovy标准HTML模板:groovy-html.template
- 进入Test详细页面->Configure-> Editable-Email Notification-> Default Content配置模板
- 重新Build,查看邮件,邮件内容变的易读行,发送错误红色显示很是醒目。成功则显示为绿色,一目了然。
10. 更简洁精炼,美观的构建报告:Html Report
查看Console Output 中的构建结果,易读性差,而且也不美观,所以我们要改进。用newman生成HTML Report,再通过HTML Publisher插件展示到Jenkins。
- Jenkins主页->ManageJenkins->Manage Plugins->找到HTML Publisher插件并安装。
- 在机器A(Jenkins Server)上通过Nodejs安装reporter-html-template
$ npm install -g newman-reporter-html
newman-reporter-html使用参见:https://github.com/postmanlabs/newman-reporter-html#readme
- 环境准备好了,把准备好的模板:htmlreqres.hbs上传到TFS项目的templates下。
我用了https://github.com/MarcosEllys/awesome-newman-html-template 这个小伙伴的模板,进行了些许改造。
-
进入Test详细页面->Configure-> Execute Windows batch command->command
把导出的index.html放在了当前Job对于的newman文件夹(文件夹会自动创建)下。此路径将在下一步配置中使用。
- 进入Test详细页面->Configure-> Post-build Actions->Add post-build action(Publish Html report)
配置Html Report ,展示上一个步骤生成的Index.html文件。
- 重新构建,查看生成的HTML Report,结果如下,是不是好很多
- 进入Test详细,查看最新Html Report
-
查看某次构建的Report,选中一个build history,查看HTML Report。
- Report详细
- 如果你的Report样式或JS脚本加载不正确,解决方案如下:
https://testerhome.com/topics/9476
以上,内容比较多,写的比较粗,欢迎交流。
- 进入Test详细,查看最新Html Report
![](/img/my/wx.png)
低调大师中文资讯倾力打造互联网数据资讯、行业资源、电子商务、移动互联网、网络营销平台。
持续更新报道IT业界、互联网、市场资讯、驱动更新,是最及时权威的产业资讯及硬件资讯报道平台。
转载内容版权归作者及来源网站所有,本站原创内容转载请注明来源。
- 上一篇
分布式锁方案论证与实现
概述 我们在实际的接口或者业务开发中,不管是服务器单点还是服务器集群,都会有分布式锁的使用场景。 比如最常见的接口重复提交(业务重复处理)、商品超卖等问题,通用的解决方案就是本文所使用的“分布式锁”, 在同一个业务中,其中一个请求获取到锁之后,其他请求只有在获取到锁的请求释放锁(或者锁失效)之后才能继续“争抢”锁, 没有获得锁的请求是没有执行业务的权限的。 方案论证 这里我们主要讨论两种方案:基于redis的分布式锁和基于zookeeper的分布式锁 基于redis的分布式锁 redis自身就提供了命令:SET key value NX PX expireTimeMs,专门用于处理分布式锁的场景,效率高且提供锁失效机制, 即使由于某种情况客户端没有发送解锁请求,也不会造成死锁。 但是如果redis跑在集群的情况下,由于redis集群之间采用异步的方式进行数据同步,因此在并发量大的情况下有可能遇到数据同步不及时造成多个请求同时获取到锁, 虽然业界有redlock算法以及redisson客户端实现能基本处理此类问题,也并不能完美解决这个问题,其算法逻辑实现还很复杂, 更有甚者有分布式的专家...
- 下一篇
自然语言处理工具包 HanLP在 Spring Boot中的应用
本文共 782字,阅读大约需要 2分钟 ! 概 述 HanLP 是基于 Java开发的 NLP工具包,由一系列模型与算法组成,目标是普及自然语言处理在生产环境中的应用。而且 HanLP具备功能完善、性能高效、架构清晰、语料时新、可自定义的特点,因此十分好上手,本文就结合 Spring Boot来将 HanLP用起来! 注: 本文首发于 My Personal Blog:CodeSheep·程序羊,欢迎光临 小站 本文内容脑图如下: 下载 HanLP数据和程序 由于 HanLP库将数据与代码分离,因此我们需要分别下载所需数据和 jar包: 所需 data数据包下载地址为 data.zip 所需 jar包下载地址为 hanlp-release.zip 工程搭建 创建一个普通的 Spring Boot工程,不赘述 引入 HanLP数据 和 配置 下载完成以后,首先解压 hanlp-release.zip压缩包,然后将解压出的 HanLP的 jar包引入 Spring Boot工程,然后需要来放置 HanLP所需配置和数据: 将解压后 hanlp-release.zip压缩包中的 hanlp....
相关文章
文章评论
共有0条评论来说两句吧...