0
0

Jenkins邮件代发及生成HTML报告

Jenkins邮件代发及生成HTML报告

一、Jenkins的三大概念

1.1 Job

在Jenkins平台中，都是以Job（工程/task）为单位去完成一件事情的。在使用Jenkins时，都会在Jenkins管理界面当中新建一个job/item，在job/item中来构建任务。

1.2 plugin

Jenkins提供平台，集成各种插件来完成一个job。比如：Windows\linux命令、SVN和Git（gitlab、gitee、github）代码获取，邮件发送、测试报告集成都需要安装对应的插件才能在Jenkins当中使用这些功能。

1.3 workspace

Jenkins是通过文件形式来存储和管理数据的。
所以，在安装Jenkins时，要配置Jenkins的主目录，这点我们之前已经配置过了。此外新建的每一个job的目录都会放在workspace（存放文件和数据以及执行任务成功后的文件和数据）中,相当于在workspace中每个job都有一个独立的目录，它们是相互独立的。

二、邮件和HTML插件安装

进入如下路径：Dashboard>>Manage Jenkins>>Plugin Manager,依次安装如下HTML插件和email扩展插件。
在这里插入图片描述
在这里插入图片描述

三、Jenkins邮件配置

3.1 配置管理员邮件地址

进入路径：Dashboard>>Manage Jenkins>>Configure System后，在页面Jenkins Location输入管理员的邮件地址。
在这里插入图片描述

3.2 配置邮件服务器

如下图配置，我这里配置的163邮箱，大家配置也可以选择QQ邮箱，在凭证处配置你的邮箱登录账号和邮箱授权码即可，不会可以百度。配置完保存。
在这里插入图片描述

四、新建item配置邮件和HTML

准备条件：
①新建一个item,我这里选择自由风格；
②选择代码管理工具，我这里选择Git;
③选择构建步骤，我这里使用Windows，因此配置Windows的命令行：python 相对工作空间的路径文件.py

4.1 配置邮件代发

接下来我们配置邮件的详细信息，如图点击Post-build-Actions选择Editable Email Notification
在这里插入图片描述
选择之后，按照下面进行配置。
在这里插入图片描述
关于content-type可以选择text或者HTML，我们这里使用HTML，因为我们后面发送邮件使用的是HTML模板。默认主题、默认内容都可以改的。
在这里插入图片描述
查看帮助命令：
在这里插入图片描述
我的模板的代码如下，大家有兴趣可自取。模板记得先上传仓库。

<!DOCTYPEhtml><htmllang="zh_CN"><head><metacharset="UTF8"name="viewport"content="width=device-width, initial-scale=1.0, maximum-scale=1.0, minimum-scale=1.0, user-scalable=no"><title>Unittest Report</title></head><body><divstyle="text-align: center;"><tableclass="table"border="1"style="border-collapse: collapse;margin: auto;table-layout:auto;width: 50%"><tr><captionstyle="color: #28a745 ;">项目${PROJECT_NAME} 用例执行结果如下:</caption><tdstyle="color: #28a745;width: 10%">测试人员</td><tdstyle="color: #28a745;width: 30%">XXX</td><tdstyle="color: #28a745 ;width: 10% ">用例总数</td><tdstyle="color: #28a745 ;width: 10%">${TEST_COUNTS,var="total"}</td></tr><tr><tdstyle="color: #28a745;width: 10%">构建编号</td><tdstyle="color: #28a745;width: 30%">${BUILD_NUMBER}</td><tdstyle="color: gold ;width: 10%">成功用例</td><tdstyle="color: gold ;width: 10% ">${TEST_COUNTS,var="pass"}</td></tr><tr><tdstyle="color: #28a745;width: 10%">构建结果</td><tdstyle="color: #28a745;width: 30%">${BUILD_STATUS}</td><tdstyle="color:red ;width: 10%">失败用例</td><tdstyle="color: red ;width: 10% ">${TEST_COUNTS,var="fail"}</td></tr><tr><tdstyle="color: #28a745;width: 10%">构建地址</td><tdstyle="color: #28a745 ;word-wrap:break-word;word-break:break-all;width: 30%"><ahref="${BUILD_URL}">${BUILD_URL}</a></td><tdstyle="color:gray ;width: 10% ">跳过用例</td><tdstyle="color: gray ;width: 10%">${TEST_COUNTS,var="skip"}</td></tr><tr><tdstyle="color: #28a745 ;width: 10%">HTML报告地址</td><tdcolspan="3"style="color: #28a745 ;word-wrap:break-word;word-break:break-all;width: 30%;"><ahref="${PROJECT_URL}">${PROJECT_URL}/HTML_20Report/</a></td></tr></table></div></body></html>

4.2 配置HTML报告

接下来我们配置HTML报告，点击Post-build-Actions选择Publish HTML reports，设置如下,路径都是选择相对路径：
在这里插入图片描述

4.3 配置junit提取xml文件

提取xml文件，点击Post-build-Actions选择Publish JUnit test result report，设置如下,路径都是选择相对路径，至于为什么我们要配置这个，因为Jenkins只能从xml里面读取数据，因此我们的测试报告需要生成一个xml文件才行。
在这里插入图片描述

五、使用unittest生成HTML报告和xml文件

详细信息见代码，文件名test_bd.py;记得上传仓库。

#!/usr/bin/env python3# -*- coding: utf-8 -*-# 2022/10/4 20:49# Author : root# File   : test_bd.pyfrom selenium import webdriver
from selenium.webdriver.common.by import By
import unittest,time
from unittestreport import TestRunner
import xmlrunner

classTestUrl(unittest.TestCase):defsetUp(self)->None:
        br = webdriver.Chrome()
        self.br=br
    deftest_1(self):
        br = self.br
        br.get("https://www.baidu.com")
        br.implicitly_wait(5)
        self.assertEqual(br.title,"百度一下，你就知道",msg="断言标题相等")
        time.sleep(2)deftearDown(self)->None:
        self.br.quit()if __name__ =='__main__':
    suite = unittest.TestSuite()
    suite.addTest(TestUrl("test_1"))
    runner = TestRunner(suite,filename="百度URL测试报告.html",report_dir="./report",
                        title="百度URL测试报告",tester="xx",desc="URL测试报告",
                        templates=2)
    runner.run()
    suite = unittest.TestSuite()
    suite.addTest(TestUrl("test_1"))
    runner_xml = xmlrunner.XMLTestRunner(output="./report",outsuffix="baiduurl",verbosity=2)
    runner_xml.run(suite)

这样我们在report里面就有了HTML和xml文件，到此，我们的项目基本配置完成，可以开始执行了。

六、构建成功却没发邮件

这里我们少配置了一个地方，如图：在配置Editable Email Notification邮件时没有选择触发条件，这里我们选择always，每执行一次就给我们发送邮件。保存。
在这里插入图片描述

七、中文乱码解决

在实际运行后，我发现Jenkins发送的邮件中中文部分会产生乱码，因此解决方式是配置环境变量、全局变量；且HTML模板和这两个变量的编码方式一致才可解决这个问题。
①配置系统环境变量：JAVA_TOOL_OPTIONS=-Dfile.encoding=UTF8
②配置Jenkins全局变量：进入Dashboard>>Manage Jenkins>>Configure System，配置
LANG=zh_CN.UTF8
③保证之前配置的content-type为html（如果使用HTML模板）
④保证模板html的编码方式为UTF8
⑤配置完毕后，关闭Tomcat，等一会重新打开，再次运行即可解决这个问题。
⑥在实际运行中发现Python执行时的也会有乱码，解决办法

但是这样还有一个问题，将编码格式改为UTF8后，控制台路径会乱码；其他正常；但是编码格式改为gb2312,发现邮件无法读取。
在这里插入图片描述

八、Jenkins生成的HTML报告样式问题

具体在Dashboard>>Manage Jenkins>>Script Console执行脚本，如下图输入点击run。参考文章：解决样式问题

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

在这里插入图片描述

九、效果展示

Jenkins里面查看HTML报告，老板再也不担心员工偷懒了，哈哈哈
在这里插入图片描述
邮件查看报告：
在这里插入图片描述

标签： jenkins html 运维
本文转载自: https://blog.csdn.net/xiaomao1993/article/details/127171637
版权归原作者 南风知我意。。 所有， 如有侵权，请联系我们删除。
登录后发布评论

“Jenkins邮件代发及生成HTML报告”的评论:

还没有评论
关于作者
...
overfit同步小助手
文章同步
相关阅读

网络安全法-网络运行安全

使用selenium/drissionpage时如何阻止chrome自动跳转http到https

docker desktop 里部署的Open WebUI 管理员密码忘记了的处理方法

在ubuntu20.04中搭建onsite比赛运行环境

利用开源的低代码表单设计器FcDesigner高效管理和渲染复杂表单结构

Kafka学习笔记

【前端】浏览器输入url到页面呈现发生了什么？

文章导航