Jenkins+Allure测试报告+飞书机器人发送通知
一、前言
之前讲了jenkins如何设置定时任务执行脚本,结合实际情况,本篇讲述在jenkins构建成功后,如何生成测试报告,以及推送飞书(因为我公司用的是飞书,所以是发送到飞书机器人)。
本次实践搞了一天,踩了一些坑,其中有2个坑可参考如下:
1、关于jenkins生成allure报告是空的:https://blog.csdn.net/qq_37159446/article/details/122233467
2、如遇到构建报错:ValueError: option names {'--alluredir'} already added
解决方案:
pytest-allure-adaptor与allure-pytest的alluredir都被引用造成冲突
pip3 uninstall allure-pytest
module 'pytest' has no attribute 'allure'问题解决
pip3 uninstall pytest-allure-adaptor
pip3 install allure-pytest
二、Jenkins生成Allure报告
1、jenkins安装allure插件
进入jenkins-系统配置-插件管理-可选插件,输入allure后搜索安装
2、jenkins配置全局工具配置
进入jenkins-系统管理-全局工具配置,配置allure
3、jenkins配置项目的构建后操作
进入构建项目的配置页面,选中构建后操作tab,增加构建后操作步骤选择 Allure Report
Results path填写结果文件路径
构建后操作tab点击高级,配置generate路径
4、构建执行shell,如下图
因为我的脚本中有job_url和job_name,所以shell命令后面要带上jenkins内置变量,如果不需要的话也可以不用后面那串,即直接写 python3 excute.py
特别注意:服务器需要安装allure,具体怎么安装可看我之前的博客或者百度(pip3 install allure-pytest)
5、附上Python项目结构图和excute.py代码
# -*- coding:utf-8 -*- import pytest import os if __name__ == '__main__': # pytest执行脚本并生成测试结果文件到report/tmp目录下 pytest.main(['-s','--alluredir','report/tmp']) # 将report/tmp目录下的结果文件生成html类型的测试报告文件到report/html目录下 # -o report/html --clean 是为了清空已有的测试报告再生成 os.system(r'allure generate report/tmp -o report/html --clean')
6、附上jenkins构建控制台图和allure报告
7、附上服务器的文件结构
三、Jenkins发送飞书通知
参考:https://blog.csdn.net/jialiu111111/article/details/122129334
1、 在飞书群中添加自定义机器人,步骤截图如下:
(因为飞书截图有水印,所以这里用别人的博客的图)
图1
图2
图3
图4
2、将这个webhook地址保存起来,后面需要用到
3、Python发送通知的脚本
创建feishu.py
脚本文件,需要将你的webhook地址拷贝到脚本中的url中,思路是找出jenkins的内置变量,将jenkins内置变量定义为python脚本系统变量(sys.argv[1])
# -*- encoding: utf-8 -*- """ @Author : yijiayi @File :feishu.py @Time :2022/4/13 13:41 @Remark :飞书通知 """ import sys import requests #定义python系统变量 JOB_URL = sys.argv[1] JOB_NAME = sys.argv[2] # 飞书机器人的webhook地址 url = 'https://open.feishu.cn/open-apis/bot/v2/hook/xxx4' method = 'post' headers = {'Content-Type':'application/json'} data = { "msg_type": "interactive", "card": { "config": { "wide_screen_mode": True, "enable_forward": True }, "elements": [{ "tag": "div", "text": { "content": "用例已执行完成", # 这是卡片的内容,也可以添加其他的内容:比如构建分支,构建编号等 "tag": "lark_md" } }, { "actions": [{ "tag": "button", "text": { "content": "查看测试报告", # 这是卡片的按钮,点击可以跳转到url指向的allure路径 "tag": "lark_md" }, "url": f"{JOB_URL}/allure/", # JOB_URL 调用python定义的变量,该url是服务器下的allure路径 "type": "default", "value": {} }], "tag": "action" }], "header": { "title": { "content": JOB_NAME + "构建报告", # JOB_NAME 调用python定义的变量,这是卡片的标题 "tag": "plain_text" } } } } res= requests.request(method=method,url=url,headers=headers,json=data) print(res) print(res.json())
4、Jenkins项目中添加配置
1)运行Python脚本语言需要一些环境,我使用Python3,安装Python3的工具
2)在配置中的构建中 加上一行命令即可,如下图:
我这里的testcase是项目目录下的,所以要结合你们项目实际情况变更
shell的变量顺序要跟python定义的系统变量顺序一致,比如python脚本里定义的job_url在前面,那jenkins的shell命令就要将job_url写在前面
python3 testcase/feishu.py $JOB_URL $JOB_NAME
3)构建完成之后,飞书群里就能收到对应的消息,如下图:
我这里就不截图我自己的飞书通知,因为有水印,所以用的是网上的图,具体接口中对应图里哪个字段,在上面的脚本代码中有注释