Jenkins使用经验谈4（创建Job）

前面做了那么多工作，现在终于到了创建Job这一步了，某种意义上，Jenkins的主要工作就是为了调度这些Job。Job的创建是有很大自由度的，也没有谁规定一定要创建成什么样子才行。下面我会以实际使用中的几个场景来举例说明。
需要注意的是：

[list]
[*]Job名称千万不要用中文名称（不作死就不会死）。
[*]创建Job名称时最好有个规划，因为我们最后会通过正则匹配自动将Job归类，比如我喜欢 “项目前缀_一些说明-Job类型”这种方式。
[/list]

[b][size=large]先做一些准备活动[/size][/b]

为了方便我们后面的实验，先找一台虚拟机，在上面搭建一下git服务器和代码质量管理平台（我这里使用的是sonar）。

[b][size=large]搭建git服务器[/size][/b]

因这部分不是我们的重点，所以我打算搭建一个最简单的基于SSH的git服务器，假设这台服务器IP为 172.16.12.83。
首选先从 https://github.com/git/git/tarball/master 下载git代码，按照下面的步骤解压并安装。

[code="java"]
# tar xzvf git-git-v1.8.4-474-g128a96c.tar.gz -C /usr/local/src/
# cd /usr/local/src/git-git-128a96c/
# autoconf && ./configure --prefix=/usr/
# make && make install

[/code]

创建一个git用户并以登录到这个git用户，然后在该用户的家目录下创建一个 git_home 用于存放项目代码（暂时先给git用户设置密码为git）。

[code="java"]
# useradd git
# passwd git
Changing password for user git.
New UNIX password:
BAD PASSWORD: it is WAY too short
Retype new UNIX password:
passwd: all authentication tokens updated successfully.
# su - git
[git@svr83 ~]$ mkdir git_home

[/code]

我们现在在 /tmp 下创建一个git 本地库，比如叫 helloJava，然后向这个库里提交一个 readme.txt 文件（因为第一次使用git，还需要设置一下用户名和邮件地址）。

[git@svr83 helloJava]$ git config --global user.email "bookong@gmail.com"
[git@svr83 helloJava]$ git config --global user.name "bookong"
[git@svr83 ~]$ mkdir /tmp/helloJava
[git@svr83 ~]$ cd /tmp/helloJava/
[git@svr83 helloJava]$ git init
初始化空的 Git 版本库于 /tmp/helloJava/.git/
[git@svr83 helloJava]$ echo "hello java project" > readme.txt
[git@svr83 helloJava]$ git add *
[git@svr83 helloJava]$ git commit -m 'initial project'
[master（根提交） d605f94] initial project
 1 file changed, 1 insertion(+)
 create mode 100644 readme.txt

将隐藏的 .git 目录拷贝到 /home/git/git_home 下，并改名叫 helloJava.git 目录。

[git@svr83 helloJava]$ cp -a .git/ /home/git/git_home/helloJava.git

我们在另一台服务器上试着clone出helloJava 项目。

[jenkins@svr82 test]$ git clone ssh://git@172.16.12.83/home/git/git_home/helloJava.git
正克隆到 'helloJava'...
The authenticity of host '172.16.12.83 (172.16.12.83)' can't be established.
RSA key fingerprint is 50:51:8e:ad:e0:da:1d:61:fb:d0:97:c0:2b:46:65:83.
Are you sure you want to continue connecting (yes/no)? yes
Warning: Permanently added '172.16.12.83' (RSA) to the list of known hosts.
git@172.16.12.83's password: 
remote: Counting objects: 3, done.
remote: Total 3 (delta 0), reused 0 (delta 0)
接收对象中: 100% (3/3), done.
检查连接... 完成
[jenkins@svr82 test]$ cat helloJava/readme.txt 
hello java project

简陋的 git 服务器搭建好了，足够我们实验用的了。

[b][size=large]奴隶节点安装git程序[/size][/b]

之前的文章中，我们创建了两个奴隶节点，操作系统分表为 Win7 和 CentOS。现在我们分表在上面安装git软件。CentOS这个节点的安装方法上面已经介绍了，只要再照做一遍就可以。Win7 下需要安装 msysgit 软件 http://msysgit.github.io/。
到 https://code.google.com/p/msysgit/downloads/list?q=full+installer+official+git 下载一个最新的程序，比如我下载的是 Git-1.8.4-preview20130916.exe，安装时在下图所示步骤里，选择“Run Git from the Windows Command Prompt”，将git添加到PATH路径中，其他都选默认值。


[img]http://dl2.iteye.com/upload/attachment/0090/4325/ddbafd23-cb59-3e6c-bdb8-b5659b40451c.png[/img]

安装后检查一下


[img]http://dl2.iteye.com/upload/attachment/0090/4327/7bfc0b7e-9251-369a-a407-8a227cafa83c.png[/img]

[b][size=large]配置访问git服务器的凭据[/size][/b]

还记得我们在上一集里配置了访问CentOS 奴隶节点的凭据吗？
用相似的方法在git服务器上给git用户添加一个公钥（具体步骤就不重复了），然后将私钥文件（id_rsa）分别拷贝到两台奴隶节点的当前用户家目录下的 .ssh 下（要注意在Linux系统下这个文件的权限必须是600）


[img]http://dl2.iteye.com/upload/attachment/0090/4329/5b48b34a-b2d0-384f-b77f-790f703fd3bf.png[/img]


[img]http://dl2.iteye.com/upload/attachment/0090/4331/3defd416-0e28-3b13-8051-6de79b3a2d07.png[/img]

[b][size=large]搭建一个sonar服务器[/size][/b]

为方便实验，我们把sonar搭建在git服务器上（172.16.12.83）。
首选到 http://www.sonarqube.org/downloads/ 下载最新的SonarQube。


[img]http://dl2.iteye.com/upload/attachment/0090/4333/7006aca0-33aa-3e42-a2f2-1cc649c8a740.png[/img]

解压到 /usr/local/ 下

[code="java"]
# mv sonar-3.7.2.zip /usr/local/
# cd /usr/local/
# unzip sonar-3.7.2.zip

[/code]

虽然Sonar可以使用默认的H2嵌入数据库，但Jenkins上的Sonar插件不支持，所以这里我们要安装一个MySQL的数据库
我们到下载一个 MySQL，我下的是 MySQL-client-5.5.29-1.linux2.6.i386.rpm 和 MySQL-server-5.5.29-1.linux2.6.x86_64.rpm。
下载链接：http://dev.mysql.com/downloads/mysql/5.5.html#downloads
安装这两个 RPM 包。

[code="java"]
# rpm -ivh MySQL-*
[/code]

拷贝模版文件构造 my.cnf。

[code="java"]
# cp /usr/share/mysql/my-medium.cnf /etc/my.cnf
[/code]

修改 my.cnf 内容

...
[client]
...
default-character-set = utf8
...
[mysqld]
...
lower_case_table_names = 0
...

启动 mysql

[code="java"]
# service mysql start
[/code]

进入 mysql 客户端创建默认的库sonar，添加访问用户（用户名sonar，密码sonar），并退出 mysql 客户端。

[code="java"]
# mysql
mysql> grant all privileges on *.* to 'sonar'@'%' identified by 'sonar';
mysql> grant all privileges on *.* to 'sonar'@'localhost' identified by 'sonar';
mysql> flush privileges;
mysql> quit

[/code]

然后可以实验一下用sonar用户能否正常登录：

[code="java"]
# mysql -h localhost -u sonar -p
[/code]

修改 sonar 目录下 conf/sonar.properties 文件，启用 MySQL 相关设置

……
#----- MySQL 5.x
# Comment the embedded database and uncomment the following line to use MySQL
sonar.jdbc.url:                            jdbc:mysql://localhost:3306/sonar?useUnicode=true&characterEncoding=utf8&rewriteBatchedStatements=true
……

启动sonar。

[code="java"]
# pwd
/usr/local/sonar-3.7.2/bin/linux-x86-64
# ./sonar.sh start
Starting sonar...
Started sonar.

[/code]

在浏览器中输入 http://172.16.12.83:9000/ 看到 sonar 的界面。


[img]http://dl2.iteye.com/upload/attachment/0090/4347/774934d0-bb72-3373-8578-f3677e8181d9.png[/img]

[b][size=large]创建一个用于健康检查的Job[/size][/b]

我们打算创建这样一个Job，每十五分钟检查一次代码库，发现有提交动作就触发构建，编译代码并执行单元测试，它的目的是保证构建的完整性。在这个例子里，我们假设代码是Java语言编写，需要JDK 7来编译，使用ant工具来编译执行单元测试，需要在Win 7 系统上来做这一切。
首选我们先进入Jenkins页面中的“系统管理”→“系统设置”，找到 “JDK”部分，选择“新增JDK”。


[img]http://dl2.iteye.com/upload/attachment/0090/4350/f476e971-10a4-34b7-888a-01ef79826ff9.png[/img]

我们选择让Jenkins系统在需要的时候自动安装“Java SE Development Kit 7u40”。


[img]http://dl2.iteye.com/upload/attachment/0090/4352/fa771688-7c65-3196-88e2-7cc8904edf87.png[/img]

注意最下面的错误提示，需要你输入一个Oracle 帐号，点击链接进去，是一个需要输入帐号和密码的页面（帐号可以到 https://login.oracle.com/mysso/signon.jsp 免费注册）。


[img]http://dl2.iteye.com/upload/attachment/0090/4355/b8822d21-4e6e-375f-9b2e-4d7889616076.png[/img]

设置好JDK后，我们找到“Ant”部分，点击“新增Ant”按钮。也同样设置在构建需要时自动安装Ant。


[img]http://dl2.iteye.com/upload/attachment/0090/4357/9b3805f9-5e5f-3c15-b552-21318b85d8d5.png[/img]

作为这一切后，点击屏幕下方的“Save”按钮保存配置。
然后我们写个简单的，用Ant编译的Java小程序，javaAntSample 推送到之前搭建好的git服务器上（具体方法参考前面关于git服务器部分的说明）。在这个程序的 build.xml 里，我们主要想执行 testrun 这个 target，它会完成编译并执行单元测试的工作，最后在项目根路径下产JUnit单元测试的报告 TEST-sample.project1.AllTests.xml。
现在回到Jenkins的首页，点击“新Job”。使用Ant编译的话我们要选择“构建一个自由风格的软件项目”；“任务名称”我写的是“project1_javaAntSample-auto”，这个名字里我想表达说这个Job属于“project1”项目，之后我建立视图时会用正则匹配所有以“project1_”开头的项目；后面的“javaAntSample”希望我直接查看操作目录时有比较直观的提示，我希望用最后的“auto”标明这是一个做监控检查的Job。当然你也可以采用其他的命名规则。


[img]http://dl2.iteye.com/upload/attachment/0090/4359/d8a266cb-9e91-3271-b56a-31bc41014a1e.png[/img]

确定以后涉及的内容比较多，我一点一点来介绍。
首选“描述”这部分很好理解，当你点击进入某个Job查看详情时，会显示在页面的上方，这个部分可以在里面写HTML内容。
下面的“丢弃旧的构建”很重要，我们曾经遇到过使用的太久后无用的发布包（比如WAR包）将磁盘空间耗尽的情况。我建议这里设置“发布包最大保留#个构建”设置为1。


[img]http://dl2.iteye.com/upload/attachment/0090/4361/31018b71-a249-3a9b-88b5-75d899307123.png[/img]

后面的几项我一般不做设置，但“Restrict where this project can be run”要设置希望构建的奴隶节点，我们这里设置为 win。


[img]http://dl2.iteye.com/upload/attachment/0090/4363/bbb9e77a-3663-38f1-95a9-dca6b8fb7851.png[/img]

“高级项目选项”这里，我一般只设置 “Display Name”，这里设置一个中文名称后，在Jenkins里显示Job时优先显示这个值。


[img]http://dl2.iteye.com/upload/attachment/0090/4365/8db7850f-5c31-396e-8243-bd2ea2c0e8b4.png[/img]

下面就到了“源码管理”这部分了，选择“Git”，填写仓库的URL和希望签出的分支名。


[img]http://dl2.iteye.com/upload/attachment/0090/4367/1058a236-114f-373c-b4a9-24a7a8902843.png[/img]

你可能注意到了，下面有一大串错误提示“Fail to connect to repository……”这个不用管它，因为Jenkins的主节点我们没有配置访问git服务器的密钥的原因。
如果你在Job执行时出现下面错误


[img]http://dl2.iteye.com/upload/attachment/0090/4369/b481fbcc-14a6-316f-9f91-ffcf9af16982.png[/img]


点击“高级”按钮，我们在下面的地方随便设置一下（可以设置一个管理员的邮箱）。


[img]http://dl2.iteye.com/upload/attachment/0090/4371/c13904fb-9e33-3c32-8e0f-e9e25de80274.png[/img]

下面的“构建触发器”部分，我们希望是每15分钟检查一次代码库，如果有变化，则触发构建。


[img]http://dl2.iteye.com/upload/attachment/0090/4373/b204e98b-250c-392f-9506-52ad203ff9d3.png[/img]

在下面的“构建”部分，点击按钮“增加构建步骤”，选择“Invoke Ant”。


[img]http://dl2.iteye.com/upload/attachment/0090/4375/484341b9-d886-3388-a508-da81367394af.png[/img]

Ant的版本选择我们一开始在“系统设置”里指定的版本，第一次执行前它会自己下载。“Targets”输入“testrun”，这个值来自我们的build.xml文件中的定义。
在下面的“构建后操作”中，点击“Add post-build action”按钮，在列表中选择“Publish JUnit test result report”。


[img]http://dl2.iteye.com/upload/attachment/0090/4377/27ded455-cd41-3a5c-9302-78b1160f08c0.png[/img]


由于我们的报告是输出到项目根路径下，所以我们这里直接填写XML文件名。


[img]http://dl2.iteye.com/upload/attachment/0090/4379/ab471bb3-7735-3370-a495-f7f03da2ebce.png[/img]

现在再次点击“Add post-build action”按钮，选择“E-mail Notification”，添加失败后的邮件提醒。这里不但可以设定固定通知的人，还可以自动发邮件给疑似导致构建失败的人。


[img]http://dl2.iteye.com/upload/attachment/0090/4381/81bd67f2-eb0d-3cb2-beec-134b6e6acea5.png[/img]


[img]http://dl2.iteye.com/upload/attachment/0090/4383/90c04d7f-4fa3-3b3a-87b1-18371814681c.png[/img]

如果你有时间就等待它自动触发构建，否则你可以点击[img]http://dl2.iteye.com/upload/attachment/0090/4386/b5542461-f543-3e11-9247-1bde97a15adc.png[/img]直接触发构建


[img]http://dl2.iteye.com/upload/attachment/0090/4388/cafe903f-dc28-327c-9e52-dc512af63807.png[/img]

这时候你执行Job的构建会发现一直停留在git签出代码阶段，造成这个的原因是家目录不正确，没有找到私钥的原因。我们可以有两个方式解决。

[b][size=large]解决Win7下无法签出git代码[/size][/b]

[b][size=large]方式一：修改Win7奴隶节点的设置[/size][/b]

添加两个环境变量“HOMEPATH”和“USERPROFILE”。


[img]http://dl2.iteye.com/upload/attachment/0090/4390/dc5ced04-75a5-3bf3-8def-da900abb5529.png[/img]

[b][size=large]方法二：安装插件 EnvInject Plugin[/size][/b]

我们在插件管理页面中，安装插件“EnvInject Plugin”。


[img]http://dl2.iteye.com/upload/attachment/0090/4392/ad649277-786d-3595-837d-da13cabf05cf.png[/img]


这时再修改Job的定义（在“参数化构建过程”下面会出现新的属性“Prepare an environment for the run”。设置里面的“Properties Content”


[img]http://dl2.iteye.com/upload/attachment/0090/4396/bfd11054-d5eb-3a48-a9be-69378fe88469.png[/img]

[b][size=large]最后执行结果[/size][/b]

[img]http://dl2.iteye.com/upload/attachment/0090/4398/14975e0a-26a1-3192-9cbd-28d8aeee0760.png[/img]


[img]http://dl2.iteye.com/upload/attachment/0090/4400/4a71f065-fb8f-39de-8b1c-c6ee3ae418bc.png[/img]

[b][size=large]创建一个用于代码质量分析的Job[/size][/b]

假如我们希望对代码进行静态检查，可以创建这种Job。最简单的方式就是与sonar进行集成，sonar支持众多语音的静态检查，包括：.NET（$）、Android、C/C++（$）、C++（社区版）、Java、JavaScript、PHP等等，其中后面带（$）表示收费版本，比如C/C++ 插件一年7000欧元。http://docs.codehaus.org/display/SONAR/Plugin+Library
使用前我们先安装Sonar插件“Jenkins Sonar Plugin”


[img]http://dl2.iteye.com/upload/attachment/0090/4402/ec398d2a-eba8-39e1-b192-500fa1e8a7c1.png[/img]

安装好插件后，我们进入“系统设置”页面。
先找到“Sonar Runner”这里，点击“新增 Sonar Runner”按钮。


[img]http://dl2.iteye.com/upload/attachment/0090/4404/78324d7b-85f8-3306-9e33-3791d6afb864.png[/img]

向下，找到“Maven”部分，新建一个Maven（就像前面创建的Ant一样，需要时他会自动安装的）


[img]http://dl2.iteye.com/upload/attachment/0090/4406/4dd27d1d-dabc-3b4b-ba1f-3b7b573158bb.png[/img]

再向下，找到“Sonar”部分，点击“Add Sonar”按钮。其中“Server URL”就是我们Sonar的访问URL“http://172.16.12.83:9000/”；Sonar默认帐号和密码都是“admin”；数据库部分的设置就是我们前面配置Sonar配置文件中写的MySQL相关设置。


[img]http://dl2.iteye.com/upload/attachment/0090/4408/5f5076ac-1780-3919-9ed3-707fa9326a5b.png[/img]

前一个Job里，我们用Ant构建了一个Java项目，毕竟Ant已经过时了，我们在这个Job试试用Maven构建一个项目，先创建一个用Maven构建的项目 javaMavenSample 推送到我们实验用的git服务器上。Maven构建时除了pom.xml 外还有一个重要的配置是 settings.xml 文件，一般在这个文件中指定私服 nexus 的地址，一般情况下会要求将这个文件放在本地用户家目录下的 .m2 文件夹中。但对Jenkins来说这样可能造成一个构建干扰另一个构建的情况，所以我们将这个 settings.xml 文件放在 javaMavenSample 项目的根目录下一起提交。
现在创建一个新Job，名称就叫“project2_javaMavenSample-nightly”，类型选择“构建一个maven2/3项目”


[img]http://dl2.iteye.com/upload/attachment/0090/4410/519d7472-cc7f-3ebe-894f-0090f7f8b5e1.png[/img]

其他的设置参考前面监控检查的Job吧，这里只说说不一样的地方。
触发构建的日程表我们可以设置成“H 0 * * *”，表示每天晚上0点检查代码库是否有更新。因为静态检查是一个极其消耗资源的缓慢过程，所以没有必要在健康检查中触发。
Maven项目的Job会有一个“Build”部分。“Goals and options”我们写“clean install”，点击“高级”按钮展开高级属性，在“Settings file”这里，选择“Settings file in filesystem”，“File path”上可以写相对于Job工作区的相对路径，这里我们直接写“settings.xml”，这样代码库中随项目一起提交的settings.xml就会生效。


[img]http://dl2.iteye.com/upload/attachment/0090/4412/61792dcd-0346-30ed-8031-936b784bab68.png[/img]

在“构建后操作”这部分，点击“Add post-build action”按钮，添加“Sonar”，基本上安装默认值就可以。


[img]http://dl2.iteye.com/upload/attachment/0090/4414/6a37fa58-ad00-3554-9bfc-0b2549c93b61.png[/img]


[img]http://dl2.iteye.com/upload/attachment/0090/4416/0e93ec6f-7a64-3860-bbc4-33cf75ffa2bf.png[/img]

执行Job看一下。
成功后到我们的Sonar服务器上可以看到结果 http://172.16.12.83:9000/


[b][size=large]创建自动部署测试环境的Job[/size][/b]

创建一个自动部署到测试环境的Job有很多方法。

[b][size=large]方法一：通过Deploy Plugin[/size][/b]

安装“Deploy Plugin”插件。这个插件支持 Tomcat 4.x/5.x/6.x/7.x、JBoss 3.x/4.x、Glassfish 2.x/3.x 的自动部署。


[img]http://dl2.iteye.com/upload/attachment/0090/4418/129e8705-09a9-3838-aab0-01d7a1e1968e.png[/img]

你可以在设置Job的“构建后操作”部分添加“Deploy war/ear to container”


[img]http://dl2.iteye.com/upload/attachment/0090/4420/bbe0661a-575a-317f-a93f-dc9dc4530432.png[/img]


[img]http://dl2.iteye.com/upload/attachment/0090/4422/93f28f95-2469-3532-8625-c3b9b37b8731.png[/img]

要注意的是，比如你自动部署到 Tomcat 上，那么它的 webapps 目录下 manager 需要保留，然后在 conf/tomcat-users.xml 文件中，添加如下内容

        <role rolename="manager-gui"/>
        <role rolename="manager-script"/>
        <role rolename="manager-jmx"/>
        <role rolename="manager-status"/>
        <role rolename="manager"/>
        <role rolename="admin"/>
        <user 
                username="admin"
                password="admin" 
                roles="manager-gui,manager-script,manager-jmx,manager-status, admin, manager"/>

[b][size=large]方法二：通过脚本[/size][/b]

这种方式更自由，你可以写好一个脚本来做你希望的事情，然后通过Jenkins来远程启动这个脚本。
如果时执行Windows下的批处理，就选择“Execute Windows batch command”，如果是bash脚本，就选择“Execute shell”。


[img]http://dl2.iteye.com/upload/attachment/0090/4424/c32b7a0e-2ca1-3c65-82a7-36cccf7c1f7d.png[/img]

写脚本时，有写Jenkins的内部变量你可以使用，比如我们这个实验系统，有个页面就是介绍这些内部变量的 http://ci.abc.com/jenkins/env-vars.html/。


[img]http://dl2.iteye.com/upload/attachment/0090/4426/f96979d6-d28c-3f9a-9e97-783cd26f3532.png[/img]

[b][size=large]创建一个做集成测试的Job[/size][/b]

这一类的Job一般是依赖某个Job（比如手动部署测试环境）构建后启动构建。所以我们在配置Job属性时配置：


[img]http://dl2.iteye.com/upload/attachment/0090/4428/a3bc649a-0906-342c-a2dc-04935595c35e.png[/img]

[b][size=large]展示报告[/size][/b]

Jenkins 的插件已经覆盖了大部分的报告格式（测试报告、静态检查报告等），如果你使用了一个工具的报告格式是不常见。你可以尝试把格式转化为XUnit兼容的格式展示。或者可以将报告产生的XML文件结合 XLS文件通过 “HTML Publisher Plugin” 插件来展示。


[img]http://dl2.iteye.com/upload/attachment/0090/4430/600624bf-b0d1-38ff-9e60-912be2731732.png[/img]

关于 XSL 展示 XML ，有兴趣可以看看 http://www.ibm.com/developerworks/cn/xml/theme/x-xsl.html

[b][size=large]交互风格的Job[/size][/b]

这是个有趣的功能，比如上面我们说的用于自动部署的Job，如果常规的构建方式，我们只能构建最新的代码，如果我们希望能部署指定的某次提交到测试环境怎么办呢？我们可以设置“参数化构建过程”来实现（参数化构建的本质是在构建前让你和Job有个交互过程，交互结果以环境变量方法参与到Job的构建）。
首选参考前文，在主节点上安装git工具并且配置访问git服务器的私钥（id_rsa）到 .ssh 目录下。
编辑Job的属性，找到“参数化构建过程”添加一个“Git Parameter”。


[img]http://dl2.iteye.com/upload/attachment/0090/4432/0c850294-e445-3e4a-92ac-9e4517ec7eb1.png[/img]

执行后发现并没有列出git上的所有提交。


[img]http://dl2.iteye.com/upload/attachment/0090/4434/6622ec39-8fc2-3100-8191-0f26b8128db7.png[/img]

在“系统管理”→“System Log”中


[img]http://dl2.iteye.com/upload/attachment/0090/4436/e9696917-d512-314d-a0ed-b0270dd67a83.png[/img]

查看“所有系统日志”得知，后台报错“No such file or directory”。我觉得这是Jenkins的一个Bug，我们配置Job是在奴隶节点上执行，它却在主节点上查找目录。关于这个问题我们用另一个方法来解决，[b]我们欣赏一下在主节点构建的Job使用Git参数做参数化构建的效果。有一点要注意，这里虽然列出提交Id但不代表选择后会签出指定的这次提交代码，它只是将你选择的内容保存到你指定Name命名的环境变量里。[/b]


[img]http://dl2.iteye.com/upload/attachment/0090/4438/b6d418b2-20db-341d-b9d2-a36d5d02ef1f.png[/img]

刚才说的另一个方法需要安装两个插件“Extended Choice Parameter plugin”和“Extensible Choice Parameter plugin”他们可以扩展参数化构建过程。


[img]http://dl2.iteye.com/upload/attachment/0090/4440/638e1213-8e76-327f-aa07-13ed2444dfbd.png[/img]

我们在 Jenkins 服务器上创建一个目录 /jenkins/tmp/，然后签出 javaMavenSample 项目的代码。

[code="java"]
# mkdir /jenkins/tmp/
# cd /jenkins/tmp/
# git clone ssh://git@172.16.12.83/home/git/git_home/javaMavenSample.git

[/code]

在Jenkins的服务器上创建一个 /jenkins/tools/ 目录，然后在下面写一个脚本 genProject2Revision.sh，内容如下：

#!/bin/bash

cd /jenkins/tmp/javaMavenSample
/usr/bin/git pull
echo "revision=\\" > /jenkins/tools/project2_revision.txt
/usr/bin/git log --pretty=oneline | /bin/awk '{printf "%s,\\\n", $1}' >> /jenkins/tools/project2_revision.txt

设置crontab 让这个脚本每小时执行一次。

[code="java"]
# crontab -l
0 * * * * /jenkins/tools/genProject2Revision.sh

[/code]

这样我们每小时就会更新 project2_revision.txt 文件内容如下


[img]http://dl2.iteye.com/upload/attachment/0090/4442/94adc652-fd59-3638-b4c4-b693b941b906.png[/img]

现在设置Job，添加“Extended Choice Parameter”


[img]http://dl2.iteye.com/upload/attachment/0090/4444/b4bddab6-7320-3419-8827-0f6c97caeb85.png[/img]

[img]http://dl2.iteye.com/upload/attachment/0090/4446/c9bb1ae6-fe28-38b1-b6ee-5f160bbbe794.png[/img]


再执行Job，可以选择了


[img]http://dl2.iteye.com/upload/attachment/0090/4448/98653a0d-268a-330c-a026-e6da71c8d58c.png[/img]

这里做的选择只会将选择内容保存到 GIT_COMMIT 环境变量里，要希望签出选定的代码，创建一个Pre-build setup。


[img]http://dl2.iteye.com/upload/attachment/0090/4450/70c0f7cc-7d7e-33dc-90f8-c8cdaebab9b9.png[/img]

目前这个测试项目的提交历史如下


[img]http://dl2.iteye.com/upload/attachment/0090/4452/839e05fd-5fe8-3b55-b903-f55705bee7cb.png[/img]

当我选择中间的那次提交 ed8ec8bf4966cf41b859b5f60dd0fc96f5797af2 时，执行结果如下：


[img]http://dl2.iteye.com/upload/attachment/0090/4454/36a71a72-bdfe-3a0f-88b2-f049ffb868d2.png[/img]

当选择最早的那次提交 2f65720bb717c4e62ae9d2e34d521689e30cd463 时，执行结果如下，构建失败的原因参考上面的提交历史可知，那次提交时 settings.xml 文件还未添加。


[img]http://dl2.iteye.com/upload/attachment/0090/4456/8ecc18ee-9daf-3dd7-a73b-f15213553e5c.png[/img]