Postman+Newman+Jenkins实现接口自动化可持续性部署

提示：支持原创，请勿抄袭！

---

前言

提示：不再详细描接口用例的编写等过程。
步骤：
1.在postman上编写好接口用例（不讲解）；
2.将该用例集合和用例环境导出到某个文件上（不讲解）；
3.下载且配置Node.js；
4.npm下载newman插件；
5.在命令提示符里尝试运行；
6.配置Jenkins；
7.将用例和环境部署到Jenkins；

---

一、下载Node.js

Node.js官方安装包及源码下载地址：https://nodejs.org/en/
点击Download，进入到当前页面。往下滑，点击Previous Releases（以前的版本）。进入到该页面后，选择比较稳定的版本进行下载。
之前我下载的版本是17的，结果会出现一个问题就是版本太高，导致npm newman插件时，提示一直报错。后面改成版本14的就没有问题啦。这里也建议大家下版本稍微低一点的node.js（npm不需要另外下载，node会自带）。
点击download进入到这个界面
根据自己电脑的情况去选择x64还是x86。选择.mis的格式的下载，就不再需要解压文件了。后面的安装只要一直点击next（下一步）就行，详细过程就不再阐述了。

二、node环境配置

1.完成下载后，打开命令提示符（快捷键win+r，输入cmd，回车），查看node跟npm是否已经成功安装。输入命令 node -v可查看到node已成功安装，且可以看到它的版本。输入npm -v

可查看到npm已安装成功，且可以看到它的版本

2.如果需要对全模块的路径跟缓存的路径进行更改。
例如：我想要将这两个的路径放在D盘-我创建的node文件夹里面，那就先在该文件夹下新建两个文件夹，【node_global】及【node_cache】。随后打开cmd命令窗口，输入这两个指令

npm config set prefix "D:\nodejs\node_global"
npm config set cache "D:\nodejs\node_cache"

后面跟随的是你想要的路径地址。

3.打开系统环境配置，选择 高级-环境变量

进入环境变量对话框，在【系统变量】下新建【NODE_PATH】，输入【D:\nodejs\node_global\node_modules】
将【用户变量】下的【Path】修改为【D:\nodejs\node_global】
以上路径位置可以改成你自己的路径位置

三、下载newman插件

上面的部署后，打开cmd命令窗口。输入命令 npm install -g newman
注意：如果输入这个命令提示的是报错（例如：ERROR），那么很有可能是不够权限去运行cmd命令窗口。选择以管理员身份运行，然后再次输入 npm install -g newman 就可以下载了。

四、在命令提示符窗口运行用例

先下载html插件，方便我们在运行成功后，能够查看到的接口用例运行的情况。打开cmd命令窗口，输入

npm install -g newman-reporter-html

随后输入 newman run 存放接口用例的路径 -e 存放接口用例环境的路径
–reporters html --reporter-html-export 存放运行报告的路径

（例如：newman run D:\接口自动化\test\维护分类.postman_collection.json -e D:\接口自动化\em\维护分类.postman_environment.json --reporters html --reporter-html-export D:\接口自动化\report\维护分类测试报告.html）

newman run D:\接口自动化\test\分类.postman_collection.json -e D:\接口自动化\em\分类.postman_environment.json --reporters html --reporter-html-export D:\接口自动化\report\测试报告.html

打开存放运行报告的路径，可以查看已经有报告生成了

打开报告可以查看到接口用例的情况
如果觉得报告的样式太过于简单，想要换一个，可以输入

npm install -g newman-reporter-htmlextra

随后将原来的命令更改成 newman run 存放接口用例的路径 -e 存放接口用例环境的路径
–reporters htmlextra --reporter-htmlextra-export 存放运行报告的路径


两种样式看个人选择（如果后面学习到新的样式，会再来补充）。
注意：如果在cmd窗口运行报错的话，如果又是权限的问题。用管理员身份运行cmd窗口就好啦。

五、部署到Jenkins

第四个步骤完成后，尝试部署到Jenkins上。打开Jenkins，选择new item，选择新建一个项目。

选择自由风格，并为它取个名字，完成后点击下方的ok按钮
随后进入到该项目的设置页面，在这里可以写下关于该项目的描述

这里指的是"保持构建天数" 和 “保持构建的最大个数”，根据自己的实际情况去填写就好啦。
这里填写的是你存放在git或者svn里面的用例等地址，如果有账号密码，则需要填写到credentials这个地方。（点击右侧的add，将自己的账号密码添加进去）如果需要设置该项目每天定时跑一遍的话，可以在这个地方写下命令定时
从左往右的意思为：min hour dom month dow（分 时 天 月 星期）
1.分的取值范围：0-59（如果写0会提示报错的话，将0改成H即可）
2.时的取值范围：0-23
3.天数的取值范围：1-31
4.月的取值范围：1-12
5.星期的取值范围：0-7(0和7都是表示星期天)
如果选择输入为 * ，则表示为每天都需要执行。

这里填上刚刚在cmd窗口写的newman run命令，随后点击下方的save按钮。然后点击Build now进行一次部署。
如果运行成功，将会看到如下标志。进入到存放报告的路径，也可查看到最新的测试报告

以上就是关于postman+newman+Jenkins实现接口自动化的大致步骤。（为什么说是大致呢？因为我这边的Jenkins是早已经给配置好了的，所以我没有写到关于Jenkins配置的相关步骤。这点可能要读者们自己去找别的文章啦。）

如果Jenkins部署时出现的报错等问题，可能是因为以下的情况（欢迎补充）
1.输入命令的地方，少写了 exit 0
2.可能是设置Jenkins时，没有在部署有Jenkins的服务器上安装node或者newman。（有些人是想部署在公司的Jenkins上，所以对应的，node跟Newman也需要安装在对应的服务器上）

总结

如果有写的不对的地方，欢迎大家指出。
也欢迎大家友好的讨论，共同进步。