Jenkins与Allure集成（1）— Jenkins快速入门

一、环境准备

1、jenkins介绍

Jenkins是一款开源 CI&CD 软件，用于自动化各种任务，包括构建、测试和部署软件。

Jenkins 支持各种运行方式，可通过系统包、Docker 或者通过一个独立的 Java 程序。

Jenkins 是一个扩展性非常强的软件，其功能主要通过插件来扩展。

CI/CD 的核心概念是持续集成、持续交付和持续部署。

2、安装JDK

由于Jenkins是基于Java开发的，所以在安装Jenkins之前首先需要安装Java的JDK。

参考：JDK和JRE的区别和环境变量配置

3、下载jenkins

 jenkins官网：Jenkins

  注意jenkins提供两个系列的下载版本，分别是LTS-稳定版本，Weekly-每周迭代版本。这里推荐下载稳定版本。

 这里我下载的是支持java8的版本：2.346.1 

下载jenkins.war

二、部署Jenkins

1、本地部署jenkins

windows平台本地部署jenkins的两种方式

（1）部署到tomcat服务器，把 war 文件放到 tomcat 的 webapps 文件夹中，运行 tomcat。（需要先在本地/服务器上部署Tomcat）

（2）本地部署，cmd命令打开终端进入到jenkins下载目录，运行命令 java -jar jenkins.war。

• 您可以通过`--httpPort`在运行`java -jar jenkins.war`命令时指定选项来更改端口。例如，要通过端口9090访问Jenkins，请使用以下命令运行Jenkins： java -jar jenkins.war --httpPort=9090

管理员密码 "337cfcfc3ace4048af7b5e83e248c5f5"，保存在，C:\Users\057776\.jenkins\secrets\initialAdminPassword

当看到打印出"Jenkins is fully up and running"，表示已经成功的在自己本地电脑上（window）部署好了jenkins服务，后面在使用jenkins过程中不能关闭cmd窗口，不然会终止jenkins服务。

2、登录jenkins

（1）启动jenkins

进入到jenkins.war包所在的目录，输入cmd打开终端，运行命令 java -jar jenkins，当打印出"warJenkins is fully up and running"表示jenkins启动成功了。

（2）登录jenkins

打开浏览器，输入地址：http://localhost:8080（注意，上面的cmd窗口不要关闭，不然无法登录jenkins），需要用到上面的管理员密码来解锁jenkins。

 

安装默认插件进度条如下：

三、配置Jenkins

1、系统配置 Configure System

视图：Dashboard > Manage Jenkins > Configure System

（1）主目录

.jenkins文件夹介绍：

 

• jobs：包含Jenkins管理的构建作业的配置细节、构建产物和数据；
• logs：日志目录
• plugins：存放jenkins已安装插件的相关文件（下载的推荐插件都在这个目录下存放）
• updates：用来存放可用的插件更新，包括插件更新的地址都在该目录下的default.json存储
• nodes:保存节点的配置
• secrets：存放一些秘钥
• userContent：网上说是存放为Jenkins服务器定制化的一些内容，这个小编也不清楚具体存放的啥，这个目录默认是空的，只有一个readme文件
• users：存放用户账号信息
• war：貌似是jenkinswar解压之后的文件
• workspace：存放Jenkins配置的job中相关的文件和中间产物
   

（2）Jenkins Location

 

（3）GitHub配置

凭据选择：Secret text

生成GitHub私人令牌，GitHub主页点击个人头像依次选择：Settings > Developer settings > Personal access tokens (classic)

（4）Gitee 配置

 

 Gitee API V5 的私人令牌获取地址 ：https://gitee.com/profile/personal_access_tokens

 注意，生成令牌要先保存起来，关闭页面后再也看不到令牌了。

2、全局工具配置 Global Tool Configuration

视图：Dashboard > Manage Jenkins > Global Tool Configuration

（1）JDK配置

需要先下载安装JDK，配置环境变量。

（2）Git配置

需要先下载安装git

3、插件管理 Plugin Manager

视图：Dashboard > Manage Jenkins > Plugin Manager

Jenkins 是一个扩展性非常强的软件，其功能主要通过插件来扩展。 插件以及它们的依赖能够自动地从更新中心下载。更新中心是一个由Jenkins项目运营的服务，它提供了一个开源插件的清单，这些插件是由Jenkins社区的成员共同开发和维护的。 

（1）在线安装，更新，卸载你的插件。

（2）针对在线安装不了的插件也可以选择高级功能，加载下载到本地的插件来安装。

 

四、新建项目

1、新建github项目

 （1）仪表盘点击新建项目item，输入项目名，选择自有风格的项目，注意项目名称不能有空格。

（2）项目配置

General：添加项目描述信息和GitHub项目URL地址；

源码管理：配置GitHub上的项目地址，和GitHub的凭证，可以是用户名密码；

构建触发器：这里我们使用手动触发不需要维护，触发器的分类如下：

• 触发远程构建
• 其他工程构建后触发构建
• 定时构建
• Gitee webhook 构建
• GitHub hook构建
• 轮询SCM构建，是指定时扫描本地代码仓库的代码是否有变更，如果代码有变更就触发项目构建。

构建环境：如每次构建之前清除workspace工作空间等，这里我们选择默认选项；

构建：这里我们选择执行windows批处理命令："Execute Windows batch command"；

        cd %WORKSPACE%，"WORKSPACE"是 jenkins内置的环境变量，表示项目工作区的绝对路径。

        pytest，使用pytest运行测试用例

        exit 0，执行完后退出。

构建后操作：可以配置生成allure测试报告等，这里我们选择无；

 （3）项目配置好之后，点击立即构建"Build Now"，可以查看构建状态和结果，以及控制台输出信息。

 

2、新建gitee项目

 （1）配置Gitee，Configure System >> Gitee 配置

（2）安装Gitee插件，Plugin Manager

 （3）新建项目pytest-allure-demo-gitee

 

  

 （4）立即构建

 

---

reference：

Jenkins 用户手册