# allure_demo

**Repository Path**: yyunShen/allure_demo

## Basic Information

- **Project Name**: allure_demo
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2021-10-10
- **Last Updated**: 2023-01-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

最近学习简单了解了一下jenkins，并记录记录。

## Python源码demo
简单新建测试用例：test_cases.py。
	参见：https://gitee.com/yyunShen/allure_demo/tree/master
```python
#test_cases.py
# !/usr/bin/env python
# -*-coding:utf-8 -*-

import pytest

class TestCases:
    def test_one(self):
        print("执行用例-1-")
        assert 't' in "this"

    def test_two(self):
        print("执行用例-2-")
        assert 1 == 1

    def test_3(self):
        print("执行用例-3-")
        assert 'p' in "iphone"

    # def test_4(self):
    #     print("执行用例-4-")
    #     assert 4 == 5


if __name__ == '__main__':
    pass
    # 终端命令
    # pytest  test_cases.py --alluredir=allure_result
    # allure generate allure_result  -o allure_report
    
```
## allure本地测试：
   

 - [ ] 注：本地已安装allure并添加allure至环境变量
 
 1. pip install allure-pytest（安装这个辅助allure生成测试报告）
 2. 当前项目下，终端输入：
 

```python
pytest  test_cases.py --alluredir=allure_result
```
 test_cases.py	   （测试用例文件）
  --alluredir=allure_result	（指定allure执行后产生的数据位置，为多个json文件，用作后续报告生成）
 
 4. 第二个命令用作将第二步的json文件转为以HTML展示
```python
allure generate allure_result  -o allure_report
```
 		allure_result  （第二步中json文件位置）
 		allure_report	（报告位置）
 
 4. 进入allure_report/index.html查看allure报告
 ![在这里插入图片描述](https://img-blog.csdnimg.cn/03197162becb4c9a83afff08d2011b4e.png?x-oss-process=image/watermark,type_ZHJvaWRzYW5zZmFsbGJhY2s,shadow_50,text_Q1NETiBA6ZW_54Of5LiA56m6X-eak-aciOWNg-mHjA==,size_10,color_FFFFFF,t_70,g_se,x_16)


## 提交代码至gitee

 - [ ] 需配置git环境,git下载地址：https://git-scm.com/downloads。

**1、注册并登录gitee，新建项目allure_demo。**
 
**2、右键，git bash here，输入git init 并新建 .gitignnore文件，并将当前目录下不需上传gitee文件添加进.gitignnore，如下图。**
```python
git init
touch .gitignnore
```
![在这里插入图片描述](https://img-blog.csdnimg.cn/9fd5d2b713414c92952d3667b4ce0855.png?x-oss-process=image/watermark,type_ZHJvaWRzYW5zZmFsbGJhY2s,shadow_50,text_Q1NETiBA6ZW_54Of5LiA56m6X-eak-aciOWNg-mHjA==,size_11,color_FFFFFF,t_70,g_se,x_16)
 **- git bash 下将文件全部提交至gitee项目，gitee查看项目提交。**
```python
git add ...
git commit -m "first commit"
git remote add origin https://gitee.com/XXX/XXXXX.git（改为刚新建的项目地址）
git push -u origin master
```
 
## jenkins关联项目
 - [ ] 部署搭建jenkins，安装时安装推荐安装插件，其他另自行参考
 
 **1.登陆jenkins-Manage jenkins - 插件管理**
 ![在这里插入图片描述](https://img-blog.csdnimg.cn/deea8188d499465e9971eb8c17a6380b.png?x-oss-process=image/watermark,type_ZHJvaWRzYW5zZmFsbGJhY2s,shadow_50,text_Q1NETiBA6ZW_54Of5LiA56m6X-eak-aciOWNg-mHjA==,size_20,color_FFFFFF,t_70,g_se,x_16)
**2、可选插件下，搜索allure并勾选，安装，安装完成可查看已安装存在Allure Jenkins Plugin**
![在这里插入图片描述](https://img-blog.csdnimg.cn/62a1e300eeb348e8b8c641f491dc2cd5.png?x-oss-process=image/watermark,type_ZHJvaWRzYW5zZmFsbGJhY2s,shadow_50,text_Q1NETiBA6ZW_54Of5LiA56m6X-eak-aciOWNg-mHjA==,size_20,color_FFFFFF,t_70,g_se,x_16)
**3、设置全局tool配置**
![在这里插入图片描述](https://img-blog.csdnimg.cn/a2a0ffc99a0d4e178a77247225d8863d.png?x-oss-process=image/watermark,type_ZHJvaWRzYW5zZmFsbGJhY2s,shadow_50,text_Q1NETiBA6ZW_54Of5LiA56m6X-eak-aciOWNg-mHjA==,size_20,color_FFFFFF,t_70,g_se,x_16)
      进入Allure commandline，新增。别名任意填写，取消勾选install automatically。（也可勾选，直接使用），添加安装目录，下方应用并保存。
      ![在这里插入图片描述](https://img-blog.csdnimg.cn/645f5c49c4394b32a09c877796e7d673.png?x-oss-process=image/watermark,type_ZHJvaWRzYW5zZmFsbGJhY2s,shadow_50,text_Q1NETiBA6ZW_54Of5LiA56m6X-eak-aciOWNg-mHjA==,size_20,color_FFFFFF,t_70,g_se,x_16)
![在这里插入图片描述](https://img-blog.csdnimg.cn/cd7e00407a0d449ca159769aae19dac5.png?x-oss-process=image/watermark,type_ZHJvaWRzYW5zZmFsbGJhY2s,shadow_50,text_Q1NETiBA6ZW_54Of5LiA56m6X-eak-aciOWNg-mHjA==,size_20,color_FFFFFF,t_70,g_se,x_16)
4、**jenkins新建任务，并配置。**
 
 - **新增freestyle project ，按你心情的人物名，确定后进入配置修改**
 - **General--新增任务描述**
 - **源码管理--选择Git（无改选项需安装对应git插件），URL选择项目https链接。Credentials未存在信息时需添加（用户名，密码为gitee账号密码，ID、描述任意，其他不用修改），添加后选择。**
 ![在这里插入图片描述](https://img-blog.csdnimg.cn/90424a04ed6543da9c03ce50f5e95e5e.png?x-oss-process=image/watermark,type_ZHJvaWRzYW5zZmFsbGJhY2s,shadow_50,text_Q1NETiBA6ZW_54Of5LiA56m6X-eak-aciOWNg-mHjA==,size_20,color_FFFFFF,t_70,g_se,x_16)
 - **构建--增加构建步骤，选择Windows的Execute Windows batch command，输入（该命令和本地调试时的命令无关联，源码中已注释无需执行）**

```python
 pytest  test_cases.py --alluredir=allure_results
```
![在这里插入图片描述](https://img-blog.csdnimg.cn/4e9ffa68fc6d44c19e9742c331075f8f.png?x-oss-process=image/watermark,type_ZHJvaWRzYW5zZmFsbGJhY2s,shadow_50,text_Q1NETiBA6ZW_54Of5LiA56m6X-eak-aciOWNg-mHjA==,size_13,color_FFFFFF,t_70,g_se,x_16)
![在这里插入图片描述](https://img-blog.csdnimg.cn/516e61a6e48842cdb56ffa82f2a686a5.png?x-oss-process=image/watermark,type_ZHJvaWRzYW5zZmFsbGJhY2s,shadow_50,text_Q1NETiBA6ZW_54Of5LiA56m6X-eak-aciOWNg-mHjA==,size_20,color_FFFFFF,t_70,g_se,x_16)
 
 - **构建后操作--增加Path，对应alluredir，及allure_results。点击高级，在Report Path中，添加报告位置。**
```python
 pytest  test_cases.py --alluredir=allure_results
```

![在这里插入图片描述](https://img-blog.csdnimg.cn/a9f2cbcacaa44ad7aac7d4f7bc84b153.png?x-oss-process=image/watermark,type_ZHJvaWRzYW5zZmFsbGJhY2s,shadow_50,text_Q1NETiBA6ZW_54Of5LiA56m6X-eak-aciOWNg-mHjA==,size_20,color_FFFFFF,t_70,g_se,x_16)
![在这里插入图片描述](https://img-blog.csdnimg.cn/11e6646f75f74668b1559dc8b1db9ada.png?x-oss-process=image/watermark,type_ZHJvaWRzYW5zZmFsbGJhY2s,shadow_50,text_Q1NETiBA6ZW_54Of5LiA56m6X-eak-aciOWNg-mHjA==,size_20,color_FFFFFF,t_70,g_se,x_16)
注：allure_results、allure_report等路径为相对路径，在项目生成后会在工作空间
C:\Windows\system32\config\systemprofile\AppData\Local\Jenkins\.jenkins\workspace\test2_allure_demo（默认路径，可在build之后在控制台查看）
![在这里插入图片描述](https://img-blog.csdnimg.cn/9348ad563fc34012a93182a7493ae39a.png?x-oss-process=image/watermark,type_ZHJvaWRzYW5zZmFsbGJhY2s,shadow_50,text_Q1NETiBA6ZW_54Of5LiA56m6X-eak-aciOWNg-mHjA==,size_20,color_FFFFFF,t_70,g_se,x_16)

 - **应用并保存**

**5、进入当前项目，Build Now，查看构建情况，allure报告。**
![在这里插入图片描述](https://img-blog.csdnimg.cn/bbb592b8a8a746ec88e93ea81da7d14c.png?x-oss-process=image/watermark,type_ZHJvaWRzYW5zZmFsbGJhY2s,shadow_50,text_Q1NETiBA6ZW_54Of5LiA56m6X-eak-aciOWNg-mHjA==,size_20,color_FFFFFF,t_70,g_se,x_16)
**6、allure邮件发送**

 - **安装Email Extension Plugin插件**
![在这里插入图片描述](https://img-blog.csdnimg.cn/065cdeb447ed4c7f9df2c1566a2b997c.png?x-oss-process=image/watermark,type_ZHJvaWRzYW5zZmFsbGJhY2s,shadow_50,text_Q1NETiBA6ZW_54Of5LiA56m6X-eak-aciOWNg-mHjA==,size_20,color_FFFFFF,t_70,g_se,x_16)
 -**邮箱设置： jenkins首页 -- Manage -- Configure System页面，Jenkins Location新增发件人信息**
![在这里插入图片描述](https://img-blog.csdnimg.cn/64b3678f0cb342ff9244edf6e492814c.png?x-oss-process=image/watermark,type_ZHJvaWRzYW5zZmFsbGJhY2s,shadow_50,text_Q1NETiBA6ZW_54Of5LiA56m6X-eak-aciOWNg-mHjA==,size_20,color_FFFFFF,t_70,g_se,x_16)
 **- Extended E-mail Notification--添加对应信息，SMTP Password为邮箱授权码（密码以用户名为QQ邮箱的为例，进入QQ邮箱设置，开启邮件服务，生成授权码。授权码粘贴至jenkins中的密码处），下拉至右下角的Default Triggers点击，勾选**
![在这里插入图片描述](https://img-blog.csdnimg.cn/ff49fef01c1e4c439434f3079cbf00bf.png?x-oss-process=image/watermark,type_ZHJvaWRzYW5zZmFsbGJhY2s,shadow_50,text_Q1NETiBA6ZW_54Of5LiA56m6X-eak-aciOWNg-mHjA==,size_20,color_FFFFFF,t_70,g_se,x_16)
![在这里插入图片描述](https://img-blog.csdnimg.cn/bdf2a90b13144e9794ea61f9498f4d1e.png?x-oss-process=image/watermark,type_ZHJvaWRzYW5zZmFsbGJhY2s,shadow_50,text_Q1NETiBA6ZW_54Of5LiA56m6X-eak-aciOWNg-mHjA==,size_20,color_FFFFFF,t_70,g_se,x_16)
![在这里插入图片描述](https://img-blog.csdnimg.cn/8a6e717cbc6546d3b76b1e985f58200d.png?x-oss-process=image/watermark,type_ZHJvaWRzYW5zZmFsbGJhY2s,shadow_50,text_Q1NETiBA6ZW_54Of5LiA56m6X-eak-aciOWNg-mHjA==,size_20,color_FFFFFF,t_70,g_se,x_16)
**邮箱授权码获取**

![在这里插入图片描述](https://img-blog.csdnimg.cn/0e9caad9fa60482184e7b88dc665640b.png?x-oss-process=image/watermark,type_ZHJvaWRzYW5zZmFsbGJhY2s,shadow_50,text_Q1NETiBA6ZW_54Of5LiA56m6X-eak-aciOWNg-mHjA==,size_20,color_FFFFFF,t_70,g_se,x_16)

 **- 任务job内配置，**
 **- 构建后操作-添加Editable Email Notification**

![在这里插入图片描述](https://img-blog.csdnimg.cn/e977f05a34474cc1b7beb5363942d125.png?x-oss-process=image/watermark,type_ZHJvaWRzYW5zZmFsbGJhY2s,shadow_50,text_Q1NETiBA6ZW_54Of5LiA56m6X-eak-aciOWNg-mHjA==,size_20,color_FFFFFF,t_70,g_se,x_16)
**添加收件人**
![在这里插入图片描述](https://img-blog.csdnimg.cn/400a00b18a3d4233bc0b7e949d5fdd8c.png?x-oss-process=image/watermark,type_ZHJvaWRzYW5zZmFsbGJhY2s,shadow_50,text_Q1NETiBA6ZW_54Of5LiA56m6X-eak-aciOWNg-mHjA==,size_20,color_FFFFFF,t_70,g_se,x_16)
**选择邮件类型为HTML、添加邮件正文。**
![在这里插入图片描述](https://img-blog.csdnimg.cn/6c8015281160409abcc71f1d51caeb2b.png?x-oss-process=image/watermark,type_ZHJvaWRzYW5zZmFsbGJhY2s,shadow_50,text_Q1NETiBA6ZW_54Of5LiA56m6X-eak-aciOWNg-mHjA==,size_20,color_FFFFFF,t_70,g_se,x_16)
**正文内容**（选自：https://blog.csdn.net/qq_42098424/article/details/105539555）
```python
<!DOCTYPE html>    
<html>    
<head>    
<meta charset="UTF-8">    
<title>${ENV, var="JOB_NAME"}-第${BUILD_NUMBER}次构建日志</title>    
</head>    
    
<body leftmargin="8" marginwidth="0" topmargin="8" marginheight="4"    
    offset="0">    
    <table width="95%" cellpadding="0" cellspacing="0"  style="font-size: 11pt; font-family: Tahoma, Arial, Helvetica, sans-serif">    
        <tr>    
            本邮件由系统自动发出，无需回复！<br/>            
            各位同事，大家好，以下为${PROJECT_NAME }项目构建信息</br> 
            <td><font color="#CC0000">构建结果 - ${BUILD_STATUS}</font></td>   
        </tr>    
        <tr>    
            <td><br />    
            <b><font color="#0B610B">构建信息</font></b>    
            <hr size="2" width="100%" align="center" /></td>    
        </tr>    
        <tr>    
            <td>    
                <ul>    
                    <li>项目名称 ： ${PROJECT_NAME}</li>    
                    <li>构建编号 ： 第${BUILD_NUMBER}次构建</li>    
                    <li>触发原因： ${CAUSE}</li>    
                    <li>构建状态： ${BUILD_STATUS}</li>    
                    <li>构建日志： <a href="${BUILD_URL}console">${BUILD_URL}console</a></li>    
                    <li>构建  Url ： <a href="${BUILD_URL}">${BUILD_URL}</a></li>    
                    <li>测试报告： <a href="${PROJECT_URL}allure">${PROJECT_URL}allure</a></li>    
                </ul>    

<h4><font color="#0B610B">失败用例</font></h4>
<hr size="2" width="100%" />
$FAILED_TESTS<br/>

<h4><font color="#0B610B">最近提交(#$SVN_REVISION)</font></h4>
<hr size="2" width="100%" />
<ul>
${CHANGES_SINCE_LAST_SUCCESS, reverse=true, format="%c", changesFormat="<li>%d [%a] %m</li>"}
</ul>
详细提交: <a href="${PROJECT_URL}changes">${PROJECT_URL}changes</a><br/>

            </td>    
        </tr>    
    </table>    
</body>    
</html>

```

添加触发方式：
![在这里插入图片描述](https://img-blog.csdnimg.cn/007f3836dd074d9c938d1178249ba350.png?x-oss-process=image/watermark,type_ZHJvaWRzYW5zZmFsbGJhY2s,shadow_50,text_Q1NETiBA6ZW_54Of5LiA56m6X-eak-aciOWNg-mHjA==,size_20,color_FFFFFF,t_70,g_se,x_16)

 - **应用并保存，build Now后查看邮件报告**
![在这里插入图片描述](https://img-blog.csdnimg.cn/511487c2840b4f88b12d7bbe1da797c1.png?x-oss-process=image/watermark,type_ZHJvaWRzYW5zZmFsbGJhY2s,shadow_50,text_Q1NETiBA6ZW_54Of5LiA56m6X-eak-aciOWNg-mHjA==,size_20,color_FFFFFF,t_70,g_se,x_16)