Jenkins 集成 allure 遇到的问题及解决办法

安装和配置 allure 插件

1. 安装 allure 的插件

   • 操作路径：

     1. 登录 Jenkins
     2. 点击系统管理
     3. 点击插件管理
     4. 点击「Available」
     5. 搜索“Allure Jenkins Plugin”
     6. 点击安装就好

2. 安装 allure

   • 路径：系统配置 -》 全局工具配置 -》 allure commandline
   • 方式一：下载解压 allure，添加路径到安装目录，如图
     下载地址：https://github.com/allure-framework/allure2/releases
     
   • 方式二：勾选自动安装，选择 from maven central，版本选择最新版本
     

3. 安装 JDK

   • 路径：系统配置 -》 全局工具配置 -》 JDK
   • 如果已安装就不需要安装了，尽量选择“JDK 1.8.0”
     

4. 在 build 中传入 allure 的路径，或者写死在代码也行

   1. 如果是传入的话，可以这样写：${WORKSPACE}/target/allure_results
   2. 或者在 build 中先测试获得项目的工作目录，然后写死在代码中

   

5. 配置 allure report
   注意：allure 插件有问题，路径只能在项目工作目录下，一切都是基于工作目录为 “根目录” 的！

   

6. 点击保存就可以构建了

遇到的问题和解决方法

1. Python 版本没有找到
   Linux 只有低版本的 2.7，我按照网上教程安装了高版本 3.9.5，但是没有把 3.9.5 的版本加入到系统路径。
   在 Jenkins 构建时提示 python3.9.5 命令找不到。

   解决方式：

   1. 首先找到 3.9.5 版本的安装路径，例如：/opt/python3.9.5/bin/python3.9，注意要进到 bin 下面的目录创建软连接，添加到系统路径中，命令：ln -s /opt/python3.9.5/bin/python3.9 /usr/bin/python3.9
   2. 因为 Jenkins 并不是使用 root 账户启动的，所以最好把/opt/python3.9.5/bin/python3.9 /usr/bin/python3.9 这两个文件的权限也改成所有都可以用，命令：chmod 777 /opt/python3.9.5/bin/python3.9

2. 使用 pipenv run 命令，提示虚拟环境目录权限不足或者不存在， “/root/.local/share/virtualenvs/xxx”

   1. 首先解决不存在问题，执行命令：mkdir -p /root/.local/share/virtualenvs
   2. 再解决权限不足问题，一样给所有权限，命令：chmod 777 /root/.local/share/virtualenvs

3. 执行“pipenv run python3.9.5 main.py”，提示 import xx 没导入成功
   pipenv run 进入虚拟环境失败了，这是因为我之前已经创建过虚拟环境了，但是权限不足，后面使用 chmod 777 还是不行

   解决办法：直接把虚拟环境删掉，pipenv run 检测到没有虚拟环境就会自动创建的，命令：rm -rf /root/.local/share/virtualenvs/xxx

4. allure-results does not exists
   不知道是 bug 还是 feature，allure 插件只能识别工作空间下的文件夹，所以不能自由指定存放的文件夹。Jenkins 的配置就参考提示的就好了
   
   启动 pytest 时，传入工作空间下的“target/allure-results/”就好了！

   注意：

   1. 如果是传入了工作空间的路径 ${WORKSPACE}，在使用 os.path.join 拼接路径时，切记“target/allure-results/”的“target”前面不需要加上“/”，否则会提示找不到文件夹的
   2. allure 是不会帮你自动清空 target/allure-results/，会导致数据混乱，最好清一下，在 build 加上 “rm -rf ${WORKSPACE}/target/allure-results/*”即可