测试派 Give testers a home.

新手在将python自动化测试项目集成到jenkins时会遇到很多坑，本文将从安装开始一步一步演示集成的全过程。希望能帮到大家。

1. jenkins的安装

jenkins安装方式有两种：

1. 安装成系统服务
2. 下载war包以java命令启动

本文只是一个供小白学习的简单教程，不具体讲各种操作系统上的jenkins安装，这部分可以看官网教程。

建议：

1. win10家庭版不要安装成系统服务，可能会出现各种问题
2. 关闭各种杀毒，防火墙之类的软件，可能会导致不能正常安装

如果实在是安装不成功，可以下载我提供的免安装版，注意jenkins依赖java环境，所以要提前安装JD

链接：https://pan.baidu.com/s/1tg9mRXezx7MwviC9jNERsw

提取码：vbjh

下载后解压在非中文路径下，然后双击jenkins.exe程序即可，后面要使用的插件都下载好了，当然这只是供大家学习。生产环境下会部署到linux服务器上。

2. jenkins初始化

2.1 解锁Jenkins

安装好jenkins首次进入时，你会看到如下页面

按照页面上的路径找到初始化管理员密码，这个文件没有后缀，所以windows系统的童靴不要双击，右键使用记事本或者任意的文本编辑工具打开即可。复制密码填入输入框点击继续。

jenkins接下来会连接网络(会连接外网)，如果你的电脑不能连接网络，将会打开如下页面：

尽量不要出现安装时断网的情况，如果其他软件都可以访问互联网，还是出现这个页面，请尝试科学上网后再重复这个步骤。

2.2 安装插件

正常情况下，填完管理员密码后会打开如下页面：

点击安装推荐的插件，会跳转到下面的页面：

jenkins会自动安装页面中显示的插件，根据你的网络情况，这个过程会持续数分钟。

2.3 创建第一个管理员用户

插件安装完后会自动跳入管理员创建页面：

填写管理员信息后点击保存并完成。

2.4 配置Jenkins URL

Jenkins URL 用于给各种Jenkins资源提供绝对路径链接的根地址。 这意味着对于很多Jenkins特色是需要正确设置的，例如：邮件通知、PR状态更新以及提供给构建步骤的BUILD_URL环境变量。

学习时，我们使用默认值即可，点击保存并完成，会出现Jenkins已就绪的页面。

点击开始使用Jenkins会进入Jenkins管理的首页面，至此初始化工作完成。

3. 配置插件升级站点国内镜像

后面我们会用到很多插件，而jenkins默认的插件升级站点是外网，经常会连不上或者速度非常慢，我们可以配置成国内的镜像。

进入Manage Jenkins > Manage Plugins > Advance(高级)

滚动到页面底部

将升级站点改成:https://mirrors.tuna.tsinghua.edu.cn/jenkins/updates/update-center.json

然后点击提交, 然后点击立即获取，如果正常页面会刷新，立即获取按钮前会出现多少秒之前获取更新信息的字样。

也有一些文章提示还要去配置json文件中替换www.google.com等，如果你只配置了升级站点不成功可以尝试。

在Jenkins2.270版本上，只配置升级站点即可。

4. 创建python自动化项目

4.1 新建item

点击jenkins首页面的新建Item

在打开的页面中输入项目名称，选择Freestyle project(自由风格项目),再点击确认，进入项目配置页面。

4.2 General配置

General配置中有很多选项，每个选项的后面有问号，点击会介绍当前选项的作用，都是见名思议，后面的配置也是如此。

为了学习简单，我们演示的项目配置为本地项目。点击高级，选中使用自定义的工作空间,在目录中填入项目的根目录绝对路径。

这个目录就是工作空间目录，后面很多配置都是以这个路径为标准使用相对路径来配置。

4.3 源码管理

我们这里配置了自定义工作空间，这里就勾选无，如果是想配置git管理的远程仓库就勾选Git。

勾选了远程仓库jenkins会从仓库下载代码到本地工作空间，默认在.jenkins\workspace下以项目名作为名字的文件夹中。

4.4 构建触发器

所谓触发器就是设置自动运行项目的条件。有多种方式，这里我们选择使用定时构建。

勾选Build periodically,点击问号有设置详细说明

我们设置日程表为H 23 * * *，表示每天晚上23点到24点间随机一个时间进行构建。插件推荐使用H来模糊指定，而不是精确指定具体时间，造成构建任务过于集中。

4.5 构建环境

我们当前的项目不需要额外的构建环境，为了在控制台中显示时间戳，可以勾选Add timestamps to the Console Output，其他的按需设置。

4.6 构建

构建就是启动项目，其实本质上就是启动项目执行的命令。点开增加构建步骤按钮后，会出现多个选项

对于python项目来说，一般只会用到两个：

1. Execute Windows batch command 执行windows批处理命令
2. Execute shell 执行shell命令(mac,linux)

这里我们选择执行windows批处理命令，然后在输入框中输入启动项目的命令，可以执行多条命令。注意，这里的命令当前路径为工作空间。

这样，一个python项目的基本配置就完成了，点击保存。然后点击项目管理首页左侧的BuildNow进行第一次构建，检查配置是否正确。

构建完成后，结果是否正确，会在构建序号前通过不同颜色的小球来表示，蓝色表示成功，红色表示失败，黄色表示警告，这个跟构建命令的方式有关。

点击构建序号，进入具体构建的管理页面，可以查看控制台输出，查看日志来调试。

5. 配置HTML报告

如果你的项目单独生成了html格式的报告，想要在jenkins上发布报告需要安装HTML发布插件。

5.1 安装HTML Publisher插件

点击Manage Jenkins > Manage Plugins > 可选插件，搜索html,选择HTML Publisher,点击install without restart

开始安装

如果前面升级镜像配置ok，然后人品够好的话，很快就安装好了

5.2 配置HTML Publisher插件

进入对应项目管理页面，点击配置>构建后操作>增加构建后操作步骤，在打开的弹框中选择Publish HTML reports，

点击新增

然后在HTML directory to archive中填写html报告的相对路径(相对工作空间)

再在**Index page[s]**中填写报告文件名,可以填写具体报告文件名，也可以使用 Ant patterns

这里我们填写***.html**表示所有的html为后缀的文件。

最后保存配置。

5.3 查看html报告

再次构建项目，然后刷新项目管理页面，会在工作区上多了一个HTML Peport的选项，点击即可查看html报告

5.4 配置csp

我们会发现html报告中的样式丢失了，原因是Jenkins中的CSP(Content Security Policy，内容安全策略)的默认配置为一个非常严格的权限集，以防止Jenkins用户受到恶意的HTML/JS文件的攻击。

默认，该权限集会设置为:

sandbox; **default**-src 'none'; img-src 'self'; style-src 'self';

在这个配置下，只允许加载:

1. Jenkins服务器上托管的css/js文件
2. Jenkins服务器上托管的图片文件

如下形式的内容都会被禁止:

1. javascript
2. plugins
3. html中的内联样式，以及引用外站的css文件
4. html中的内联图片
5. frames
6. web fonts
7. ajax
8. ...

非常严格，所以我们的html报告没法正常展示样式了。

要解决该问题，就是修改csp的默认配置。

我们有两种方案来解决这个问题：

5.4.1 临时解决

进入Mange Jenkins > Script console

输入如下命令，并点击运行

System.setProperty("hudson.model.DirectoryBrowserSupport.CSP", "")

如果出现result表示执行成功

再次进行构建，新生成的HTML报告就可以正常展示样式了。注意之前构建生成的HTML报告依旧无效。且jenkins服务重启后，csp会恢复默认。

5.4.2 永久解决

当前jenkins没有提供配置来解决此问题，我们只有在每次启动Jenkins时重新修改该安全策略。windows下jenkins安装目录下有一个jenkins.xml文件(其他方式请查找对应的配置文件)，

里面包含jenkins启动命令，我们可以在<arguments>标签中添加csp的设置参数，注意设置在-jar之前，改之前记得备份这个文件，防止修改错误。

在临时方案中我们修改了csp为空，表示关闭了内容安全策略，这其实存在很大的安全隐患，正确的做法，我们应该结合项目的实际情况，选择对应的安全策略。例如，我们的html报告中使用了百度的cdn加速，所以需要配置运行加载对应域名的css样式，所以配置如下：

-Dhudson.model.DirectoryBrowserSupport.CSP="sandbox; style-src 'self' libs.baidu.com;"

除此之外，csp还有很多精细的配置，详细配置可参考Content Security Policy Reference。

配置好后，重启服务，如果出现启动失败，检查是否配置错误，前后空格，表点符号。完整的arguments的配置如下：

<arguments>-Xrs -Xmx256m -Dhudson.lifecycle=hudson.lifecycle.WindowsServiceLifecycle -Dhudson.model.DirectoryBrowserSupport.CSP="sandbox; style-src 'self' libs.baidu.com;" -jar "D:\Program Files\Jenkins\jenkins.war" --httpPort=9090 --webroot="D:\Program Files\Jenkins\war"</arguments>

注意：不要复制里面的war文件，webroot的路径，要结合你自己的项目。

按照这种方案重启后，所有的html报告样式都可以正常显示。

如果是下载我提供的免安装版的jenkins，修改目录下的config.yaml文件中的csp配置即可

6. 配置邮件

构建后，我们往往需要通过发邮件的形式通知相应人员。jenkins的默认的邮件只有构建失败时才会发送邮件，且不支持自定义邮件内容。所以需要安装插件**Email Extension Plugin**，然后配置邮件

6.1配置管理员邮箱

进入Manage Jenkins>Configure System>系统管理员邮件地址，填写你用来发送邮件的邮箱。

6.2 配置jenkins默认邮件通知

继续往下滚动到最后，配置邮件通知，点击高级展开所有选项，详细配置如下：

配置好后，点击最下面的通过发送测试邮件测试配置来检查是否配置成功。

如果能够收到邮件表示邮件通知配置成功。现在先保存一下。

6.3 配置Email Extension Plugin

进入Manage Jenkins>Configure System>Extended E-mail Notification，同样点击高级展开高级配置选项，详细配置如下:

往下翻到最后有一个触发配置，默认是失败触发，

点击按钮展开配置，选择always

保存。

6.4 在项目中配置发送邮件

进入项目配置页面，点击增加构建后操作步骤，选择Editable Email Notification

配置发件邮箱和收件邮箱，收件邮箱如果有多个可以用逗号隔开

保存后，构建测试测试是否发送邮件。如果不成功，可以在构建日志中查看失败原因，然后重复上面的步骤。

6.5 发送html格式内容的邮件

Email Extension Plugin插件支持html格式的内容。

再次进入项目配置页面，来到邮件服务配置项，设置Content Type为HTML

然后在Default Content可以写入HTML模板，并且模板中可以使用jenkins对应的环境变量。

例如我使用的模板效果如下：

7. 集成Allure报告

Allure报告是非常好用的测试报告服务。jenkins能很方便的集成Allure。

7.1 下载Allure插件

在插件管理中下载allure

7.2 配置allure服务命令

安装好插件后，进入Manage Jenkins > Global Tool Configuration > Allure Commandline,点击新增Allure Commandline

默认选择了自动安装，这时如果保存，则会在之后的第一次构建中自动下载Allure服务程序，会比较慢。

如果系统上已经安装了allure服务，则可以指定安装目录，取消自动安装选项，在安装目录中填写系统allure服务的安装目录，注意不要配置到bin目录下，另外记得一定要填写别名：

然后保存。

7.3 项目中配置allure

进入项目配置页面，点击增加构建后操作步骤，选择Allure Report

注意allure的配置会添加到最前面，jenkins的构建后步骤是有顺序的，不是简单按照添加的顺序来的。

在Path中配置你的项目中pytest-allure生成的json文件的路径，注意配相对路径(相对工作空间)

然后保存，再次构建如果成功就可以看到在项目管理页面中多了Allure Report的选项

点击即可查看Allure报告。

如果出现打不开报告的情况，请检查构建日志和allure命令行，插件相关配置。

如果出现打开报告显示用例为0，请检查allure插件Path路径配置是否正确。