jenkins详细教程

一、jenkins是什么？

  Jenkins是一个开源的、提供友好操作界面的持续集成(CI)工具，起源于Hudson（Hudson是商用的），主要用于持续、自动的构建/测试软件项目、监控外部任务的运行。Jenkins用Java语言编写，可在Tomcat等流行的servlet容器中运行，也可独立运行。通常与版本管理工具(SCM)、构建工具结合使用。常用的版本控制工具有SVN、GIT，构建工具有Maven、Ant、Gradle。

二、CI/CD是什么？

  CI(Continuous integration，中文意思是持续集成)是一种软件开发实践。持续集成强调开发人员提交了新代码之后，立刻进行构建、（单元）测试。根据测试结果，我们可以确定新代码和原有代码能否正确地集成在一起。借用网络图片对CI加以理解。

  CD(Continuous Delivery， 中文意思持续交付)是在持续集成的基础上，将集成后的代码部署到更贴近真实运行环境(类生产环境)中。比如，我们完成单元测试后，可以把代码部署到连接数据库的Staging环境中更多的测试。如果代码没有问题，可以继续手动部署到生产环境。下图反应的是CI/CD 的大概工作模式。

三、使用Jenkins创建任务

  Jenkins是一个强大的CI工具，虽然本身使用Java开发，但也能用来做其他语言开发的项目CI。下面讲解如何使用Jenkins创建一个构建任务。

  登录Jenkins， 点击左侧的新建任务，创建新的构建任务。

  跳转至如下界面：

  任务名称可以自行设定，但需要全局唯一。输入名称后选择构建一个自由风格的软件项目。并点击下方的确定按钮即创建了一个构建任务。之后会自动跳转到该job的配置页面。

  上图是构建任务配置界面，可以看到上方的几个选项"General"，“源码管理”， “构建触发器”，“构建环境”， “构建”， “构建后操作”。下面逐一介绍。

1、General

  General是构建任务的一些基本配置。配置项目描述、运行节点之类的。

描述: 对构建任务的描述。

丢弃旧的构建： 服务器资源是有限的，有时候保存了太多的历史构建，会导致Jenkins速度变慢，并且服务器硬盘资源也会被占满。当然下方的"保持构建天数" 和 保持构建的最大个数是可以自定义的，需要根据实际情况确定一个合理的值。

项目限制项目的运行节点: 限制项目只在某个节点下运行。

其他几个选项可以查看Jenkins"帮助信息"进行了解。不过这些"帮助信息"都是英文的。

2、源码管理

  源码管理就是配置拉取代码的位置，这里以github为例。

Git：支持主流的github和gitlab代码仓库。这里以github为例。

Repository URL：仓库地址。

Credentials：凭证。可以使用HTTP方式的用户名密码，也可以是SSH方式。 但要通过后面的"添加"按钮添加凭证。

Branches to build：构建的分支。*/master表示master分支，也可以设置为其他分支。

源码浏览器：你所使用的代码仓库管理工具，如github、gitlab，也可使用自动方式。

URL：填入上方的仓库地址即可。

Subversion：就是SVN，这里不作介绍，可自行了解。

3、构建触发器

  构建触发器，顾名思义，就是构建任务的触发器。

触发远程构建(例如，使用脚本)：该选项会提供一个接口，可以用来在代码层面触发构建。

Build after other projects are built：该选项意思是"在其他工程构建后构建"。

Build periodically： 定时构建，就是每隔一段时间进行构建。日程表类似linux crontab书写格式。如下图的设置，表示每隔30分钟进行一次构建。

Build when a change is pushed to GitLab：当有更改push到gitlab代码仓库，即触发构建。后面会有一个触发构建的地址，一般被称为webhooks。需要将这个地址配置到github中。

Poll SCM：该选项是配合上面这个选项使用的。当代码仓库发生改动，jenkins并不知道。需要配置这个选项，周期性的去检查代码仓库是否发生改动。

4、构建环境

  构建环境就是构建之前的一些准备工作，如指定构建工具。

With Ant：选择这个工具，并指定ant版本和jdk版本。

5、构建

  选择下方的增加构建步骤。

Eexcute shell： 执行shell命令，该工具是针对linux环境的。

Execute Windows batch command：执行批处理命令。

6、构建后操作

  构建后操作，就是对project构建完成后的一些后续操作，比如生成相应的代码测试报告。

Publish HTML reports：发布代码覆盖率的HTML报告。

Editable E-mail Notification: 邮件通知，构建完成后发邮件到指定的邮箱。

Allure Report：发布allure报告。

配置完成后，点击保存。若下拉选项中没有需要的项目，则证明缺少对应插件，去插件管理处下载即可。

四、进行jenkins project 构建

  第一次配置好jenkins project之后，会自动触发一次构建。此后，每当有commit 提交到master分支（前面设置的是master分支，也可以设置为其他分支），就会触发一次构建。当然也可以在project页面手动触发构建。点击左边的"立即构建" 手动触发构建。

五、构建结果说明

构建状态

• Successful蓝色：构建完成，并且被认为是稳定的
• Unstable黄色：构建完成，但被认为是不稳定的
• Failed红色：构建失败
• Disable灰色：构建已禁用

构建稳定性

• 构建稳定性用天气表示：晴、晴转多云、多云、小雨、雷阵雨。天气越好表示构建越稳定，反之亦然。

构建历史界面

• console output： 输出构建的日志信息

六、jenkins权限管理

  由于jenkins默认的权限管理体系不支持用户组或角色的配置，因此需要安装第三发插件来支持角色的配置，可以使用Role Strategy Plugin插件。基于这个插件的权限管理设置请参考这篇文章：jenkins基于Role Strategy Plugin插件的权限管理设置，这里不作详细介绍。

最后，放上一张Jenkins的思维导图：