Jenkins+pytest+allure+git环境搭建

Jenkins大家应该都比较熟悉或者有所耳闻，它是现在比较主流的CI/CD工具。这里主要是为测试同学运行测试脚本而写的，没有加上tomcat等web服务。
说说目前集成的目的：自动执行测试写的自动化脚本并生成测试报告（使用allure）
当前环境：操作系统：macOS，脚本语言python
allure安装： pip install pytest-allure-adaptor

Jenkins的环境搭建

Jenkins安装

1. 下载Jenkins：去Jenkins官网选择下载。里面有长期支持版本 (LTS)和每周更新版，两个版本都以 .war 文件, 原生包, 安装程序, 和 Docker 容器的形式分发。为追求稳定所以我选择了长期支持版本，下载的war包形式。
   

2. Jenkins最小推荐配置：Java 8（JRE或JDK），256MB可用内存，1GB +可用磁盘空间

3. 安装Jenkins：下载好后，放在一个指定路径下，这个可以自己设定。使用终端命令，进入放置war包的目录下，执行java -jar jenkins.war --httpPort=9001，Jenkins就启动起来了。
   其中–httpPort=9001是指定Jenkins的端口，可以随意写，不写默认为8080。如果端口被占用（如8080），lsof -i:8080，找出PID，将其kill 掉：kill PID的值；或者Jenkins换一个别的端口。

Jenkins配置

1. 如果安装在本地，直接在浏览器访问127.0.0.1:9001（端口是自己指定的）加载成功会让输入密码，密码在图中红色的路径文件里面（命令行里 cat 红色路径就可以知道文件内容，复制粘贴即可）。
   

2. 下一步会出现插件安装，建议点击推荐安装，此步骤如果在网络情况不好的时候也可以稍后安装。

3. Jenkins界面：插件安装完成（或者不提前安装都可以）就进入Jenkins界面了。首先要手动配置插件，Manage Jenkins --> Manage Plugins(管理插件) ，在第二栏Available中搜索想要安装的插件（我这里搜索Allure和git ）安装后可在第三栏（installed）查看
   

4. Jenkins 全局配置（第四项）：Manage Jenkins --> Global Tool Configuration。
   安装插件后，就有了git 选项，启用插件就点击install automatically。如果本地有安装git则可以在path to Git executable 中添加本地安装路径（mac下查看命令为which git)
   allure插件也是如此，一般也是默认选择install automatically，名称填写allure+版本名称即可，点击保存就完成了。
   
   

5. 开始部署:安装后,进入首页选择New Item，填写名称这里选择Freestyle porject,点击OK进入任务配置界面。
   

6. Jenkins任务配置：在第一栏General（一般）中添加描述。
   第二栏为源代码管理，如果在本地可以使用None,git远程就选择git。选择git需要填写Repository URL就是需要拉取代码的git仓库地址,Credentials点击add去添加一个，如下面介绍。Branches to build这里默认的分支master，可修改成你需要构建项目的那条分支，源码库浏览器选自动就可以了。
   
   
   第三栏为构建触发器选项，这里可以配置是定时、轮询或者手动触发。我这里配置最后一项轮询触发。
   第四栏为搭建环境，没有用到ssh，所以不选
   
   第五栏为构建，这里选择Execute shell,使用shell命令执行。这里的因为Jenkins拉取代码会在固定的.jenkins/workspace这个目录，${WORKSPACE}变量指向了这个地址。
   最后保存就可以了！

第六栏Post-build Actions为构建后动作，点击add post-build action选项，选择allure，Results的path中填写的名称要和${WORKSPACE}后的名称一直，不然报告内容为空。

运行Jenkins

在首页可以查看新的任务，点击最右方小图标就可以构建了。也可以点击name进入任务中，点击开始构建。点击Allure Report就可以查看本次运行的测试结果。

说说踩过的坑

1. 执行shell 脚本没有写 ${WORKSPACE}，导致报告为空或者显示NaN%
2. 执行的shell脚本${WORKSPACE}后的名称和构建后操作 allure的path不一致，导致报告为空或者显示NaN%
   
3. 执行的路径和实际路径不对应，导致找不到对应文件，报错