Jenkins Allure Report 插件的相关配置

Allure 是一个report框架，支持多语言，多平台。可以通过Junit/Testng/pytest等产生的结果集生成酷炫好看的report；同时也可以支持自定义字段，将你想展示的结果展示在报告中，关于它的详细介绍与使用请参考：Allure Framework

这里主要讲一下如何在jenkins上集成allure report。allure report的生成需要allure commandline tool 已经jenkins上对应的allure 插件的支持。

1. 在jenkins 上的manage Jenkins ——->Manage Plugins—–>Available里面搜索Allure Jenkins Plugin 安装
2. 在Manage Jenkins——->Global Tool Configuration——>Allure Commandline 部分，点击添加Allure Commandline
   

3. 填写name(可以随便取名，主要是用来标识)，选择从maven central下载的版本号。（默认添加Allure Commandline时就是这个界面，jenkins在每次job构建的时候自动从maven仓库下载到构建的服务器（或容器）上）
   
   但是我之前这样配置的时候，过段时间后突然出现不能下载的情况，如下图所示：
   
   因此就研究了其他配置方法，不用受一些外界因素的影响：

   a)不自动安装，在跑job服务器上装Allure Commandline，通过在jenkins上指定allure commandline 工具的安装目录。

   在allure repport插件生成报告时 jenkins就可以直接使用该目录下的allure生成报告，不用去自动下载.
   此时在Add Allure Commandline时，取消掉install automatically选择， 同样的输入name，输入的是安装的allure commandline 工具的目录。

   例如，jenkins在连接的A slave(可以是容器也可以是node服务器)上构建job，在该slave的/tmp/allure/目录下安装了allure-2.4.1（详见之后的shell安装步骤）；此处就填入/tmp/allure/allure-2.4.1。
   

   -b)run shell command 安装：在每次job构建的时候，使用指定的shell 命令在构建job的服务器（或容器）上安装allure commandline 工具。
   
   这里label可以不用填，command填写安装allure commadnline的shell 命令：

  mkdir -p /tmp/tools
  cd /tmp/tools/
  wget https://bintray.com/qameta/generic/download_file?file_path=io%2Fqameta%2Fallure%2Fallure%2F2.4.1%2Fallure-2.4.1.zip -O allure2.zip
  unzip allure2.zip  （解压后会在allure-2.4.1目录中，而不是allure2目录，因为下载的是allure-2.4.1，allure2只是下载时候的重命名）

Tool Home填写shell安装的allure所在目录。

4.在job的配置中add post-build actions—->Allure Report，填写相关信息：

path填写的是构建中的junit/testng/pytest等产生的xml结果目录路径（相对路径，相对job workspace）

点击advance,选择生成报告的相应jdk版本

**需要注意的是:
1.最新的allure commandline需要jdk1.8或以上版本。
2.图中出现commandline 以及jdk有选项是需要之前在Jenkins的Global Tool Configuration有配置过一个以上的jdk和allure commandline,因此这里才会出现可以选择哪个版本
jdk配置多个版本请参见Jenkins 为每个job配置相应的jdk版本