Jenkins 持续集成安装及使用简介

博客地址：http://www.moonxy.com

一、前言

持续集成（Continuous integration，简称CI）指的是，频繁地（一天多次）将代码集成到主干。

持续集成的目的，就是让产品可以快速迭代，同时还能保持高质量。它的核心措施是，代码集成到主干之前，必须通过自动化测试。只要有一个测试用例失败，就不能集成。

Jenkins 是基于 Java 开发的一种持续集成工具，用于监控持续重复的工作，下载地址：https://bitnami.com/stack/jenkins/installer，提供了 Windows、Linux 和 OS X 平台的安装包。最简便的还是使用提供的 war 包直接启动，下载地址：http://mirrors.jenkins-ci.org/，此时必须保证系统中已经安装了 jdk，最好是 jdk1.5 以上。

二、初始化 Jenkins 插件和管理员用户

下载好 jenkins.war 包之后，在 cmd 下切换到下载目录，然后执行如下命令：

java -jar jenkins.war

启动了自带的 Jetty 服务器

生成随机口令

这样，jenkins 就开始启动了，它的 war 包中自带 Jetty 服务器，第一次启动 Jenkins 时，出于安全考虑，Jenkins 会自动生成一个随机的安装口令。注意控制台输出的口令，复制下来。在浏览器中输入地址：

http://localhost:8080/

首次启动 jenkins 时如果发现一直卡在启动界面，提示：Jenkins正在启动，请稍后...

你可以按 Ctrl + C 强制结束启动，然后再次执行上面的命令，发现就会继续启动了，或者可以修改一下配置文件，因为你所在网络可能被限制了，如下：

进入 jenkins 的工作目录，默认是：C:\Users\Administrator\.jenkins

也可以自定义 jenkins 的工作目录，设置 JENKINS_HOME 环境变量，启动 jenkins.war 后将被解压到 JENKINS_HOME 目录下，同时所有 jenkins 的 plugins 和 配置文件等也将被写入到 JENKINS_HOME 所设置的目录下。

打开 hudson.model.UpdateCenter.xml，将 http://updates.jenkins-ci.org/update-center.json 替换成 http://mirror.xmission.com/jenkins/updates/update-center.json，还是不行的话找到 updates 目录下的 default.json 把里面所有的谷歌地址改成百度的，即将 http://www.google.com/ 替换为 http://www.baidu.com/。

2.1 进入如下页面，输入上面出现的口令

启动后第一次进入如下页面

2.2 进入选择安装插件的页面后，可以选择安装社区推荐的插件或自定义安装，此处选择前者

一般至少需要安装如下几个插件：

Git/Subversion、SSH、Publish Over SSH、Maven 等。

2.3 创建管理员用户

填入账户信息后，进入完成页面：

安装完成。

三、配置 Jenkins 构建工具

用管理员账号第一次登录 Jenkins 后，需要在 "系统管理" -> "全局工具配置" 中，设置你要使用到的构建工具和 JDK 版本。

3.1 进入 jenkins 主界面

3.2 进入全局工具配置页面

点击 "系统管理" -> "全局工具配置"

进入后配置构建工具

3.3 配置 Maven

如果机器上已经安装了 Maven，则在 Maven_HOME 输入框中提供具体的安装路径。否则，你可以选择需要的 maven 版本，让 Jenkins 为你自动下载 maven。

3.4 配置 JDK

同理，如果机器上已经安装了 JDK，则在 JAVA_HOME 输入框中提供具体的安装路径。否则，你可以选择需要的 JDK 版本，让 Jenkins 为你自动下载 JDK。

3.5 配置 Git

如果之前没有为 Jenkins 安装 Git、Subversion（SVN）或 CVS 插件，可以在 "系统管理" -> "管理插件" 中安装。

四、构建作业

构建作业是 Jenkins 构建过程的核心。

4.1 点击创建一个新任务，进入创建项目类型选择页面

如果发现没有 "构建一个maven项目" 这一项，则需要安装 Maven Integration 插件，如下：

4.2 进入构建作业的详细页面

4.3 源码管理

根据自己项目的实际情况选择源码管理的方式：

4.4 构建触发器

其中有 5 个参数，分别表示：

MINUTE：Minutes within the hour（0-59）

HOUR：The hour of the day（0-23）

DOM：The day of the month（1-31）

MONTH：The month（1-12）

DOW：The day of the week（0-7）where 0 and 7 are sunday

常用配置：

0 * * * * 为每个小时执行一次

0 1 * * * 为没天的凌晨1点执行一次，这种配置的设置，适合执行一些冒烟的测试用例

第一个参数：min，0-59

第二个参数：hour：0-23

第三个参数：day：0-31

第四个参数：month：1-12

第五个参数：week：0-7（0 和 7 代表 Sunday）

Jenkins 中 "Poll SCM" 和 "Build periodically"的区别

Poll SCM：定时检查源码变更（根据SCM软件的版本号），如果有更新就checkout最新code下来，然后执行构建动作，配置如下：

*/5 * * * * （每5分钟检查一次源码变化）

Build periodically：周期进行项目构建（它不care源码是否发生变化），配置如下：

0 2 * * * （每天2:00 必须build一次源码）

4.5 构建

在 "Build" 中，默认的项目根目录的 Root POM，即 pom.xml。如果 pom.xml 不在根目录下，就填入子目录，例如：cloud/pom.xml。

如果源码管理中选择 "None"，此处点 "高级..." 可以自定义工作空间中的项目地址，如下：

保存上面的构建作业：

五、构建

构建作业之后，就可以执行构建过程了。

5.1 执行构建的方式

第一种：点击任务名称的右边的小三角，然后点击 "立即构建"

第二种：按照 "构建触发器" 中设置的 "日程表"定时自动触发构建

5.2 构建结果

第一列是 "上次构建状态显示"，是一个圆形图标，一般分为四种：

蓝色：构建成功；

黄色：不确定，可能构建成功，但包含错误；

红色：构建失败；

灰色：项目从未构建过，或者被禁用；

如上显示蓝色，表示构建成功。

注意：手动触发构建的时间与自动定时构建的时间互不影响。

5.3 查看控制台输出

可以查看构建成功的控制台输出：

控制台信息显示将构建的 jar 包从项目的 target 目录下归档到了 jenkins 指定的目录下了

此目录显示按照不同的构建编号，构建成功的项目

这与该工程的构建历史中的编号相对应

如果构建失败，可以通过查看构建失败的控制台输出，来得到具体的出错信息，便于调试

点击后查看错误信息，如下：

第二列是 "编译晴雨表"，如下：

如果看到你项目变成阴云或者下雨，说明你的项目稳定性不好，需要去查找原因，解决问题。

5.4 部署

如果要部署构建好的 war 包，可以在 Post Steps 中填上 shell 命令，直接用脚本部署。

另一种方式是创建另外一个构建项目，手动触发部署。

无论用哪种方式，都是为了确保编译、部署是通过持续集成服务器完成的，而不是某台开发机器。