Jenkins结合ant传递参数

zsy001

　　需求：
　　使用Jenkins的「参数化构建过程」，由用户手动输入参数。通过ant脚本接收这个参数，并输出（当然，中间也可以进行复杂的处理，这里为了说明问题，仅做简单的输出）。

1.基础环境
　　Jenkins1.509.4（现在Jenkins已经升级到2.x，版本差异不是很大）
　　apache-ant-1.9.6
　　apache-tomcat-7.0.6（注：Jenkins放在tomcat中，可参考我写的 《Jenkins默认工作空间及更改默认工作空间》 一文）
　　前提是已经有jdk的支持并配置好了相关的环境变量~

2.思路分析
　　工作一：在Jenkins中配置job的时候选中「参数化构建过程」，选择String Parameter。
　　工作二：写一个含main方法的类，打印这个参数。
　　工作三（重要的工作）：连接输入和输出。具体可以通过ant脚本来实现。ant脚本又可以在用命令行执行的时候传递参数。
　　现在整理一下思路：Jenkins「参数化构建过程」输入参数 → Jenkins执行ant脚本并将参数传递给ant脚本 → ant脚本对含有main方法的类进行编译、打包、执行等操作。

3.开始练兵
　　说明：
　　实际过程可能是：工作二 → 工作一 → 工作三。
　　3.1  工作一

　　3.2  工作三

　　注：cd javaant是因为build.xml文件会放在这个目录之下，见下图：

　　这里还涉及一个很重要的知识点：如何在Jenkins中本地构建job？
　　答案是直接将整个项目拷贝至Jenkins的工作空间之下。如上图，我的Jenkins默认工作空间已经更改为E:\jenkins\，在此目录下建立一个目录src-usercreate，专门用于构建本地job。
　　3.3  工作二
　　直接上代码了。

　　

1 package com.primeton.ant;　　

2　　
3 public>　　
4
　　
5     /**
　　
6      * @param args
　　
7      */
　　
8     public static void main(String[] args) {
　　
9         String version = args[0];
　　
10         System.out.println("Hello,"+version+"!");
　　
11     }
　　
12
　　
13 }
　　


Java代码

　　

1 <?xml version="1.0" encoding="UTF-8" standalone="no"?>　　
2 <project name="javaant" basedir="." default="main">
　　
3
　　
4     <property name="src.dir"     value="src"/>
　　
5     <property name="build.dir"   value="build"/>
　　
6     <property name="classes.dir" value="${build.dir}/classes"/>
　　
7     <property name="jar.dir"     value="${build.dir}/jar"/>
　　
8     <property name="main-class"  value="com.primeton.ant.HelloWorld"/>
　　
9     <property name="CODE_VERSION"  value="v1.2.2"/>
　　
10     <target name="clean">
　　
11         <delete dir="${build.dir}"/>
　　
12     </target>
　　
13
　　
14     <target name="compile">
　　
15         <mkdir dir="${classes.dir}"/>
　　
16         <javac srcdir="${src.dir}" destdir="${classes.dir}"/>
　　
17     </target>
　　
18
　　
19     <target name="jar" depends="compile">
　　
20         <mkdir dir="${jar.dir}"/>
　　
21         <jar destfile="${jar.dir}/${ant.project.name}.jar" basedir="${classes.dir}">
　　
22             <manifest>
　　
23                 <attribute name="Main-Class" value="${main-class}"/>
　　
24             </manifest>
　　
25         </jar>
　　
26     </target>
　　
27
　　
28     <target name="run" depends="jar">
　　
29         <java jar="${jar.dir}/${ant.project.name}.jar" fork="true">
　　
30             <arg value="${CODE_VERSION}"/>
　　
31         </java>
　　
32     </target>
　　
33
　　
34     <target name="clean-build" depends="clean,jar"/>
　　
35
　　
36     <target name="main" depends="clean,run"/>
　　
37
　　
38 </project>
　　


ant脚本　　整个Java工程目录层次如下：

　　注：上面已经提及，需要将整个项目（包含build.xml）拷贝到Jenkins的工作空间目录下（我的是E:\jenkins\src-usercreate\）。
　　3.4  构建结果
　　在Jenkins中对该作业点击『立即构建』，要求输入CODE_VERSION的值，这里了输入v2.0。执行结果如下：

4.小结
　　①Jenkins 「参数化构建过程」 供用户输入参数。
　　②ant脚本可以作为中间媒介将上述参数传递给Java代码 [ 注意理解这个参数的传递过程 ]。