需求:
使用Jenkins的「参数化构建过程」,由用户手动输入参数。通过ant脚本接收这个参数,并输出(当然,中间也可以进行复杂的处理,这里为了说明问题,仅做简单的输出)。
1.基础环境
Jenkins1.509.4(现在Jenkins已经升级到2.x,版本差异不是很大)
apache-ant-1.9.6
apache-tomcat-7.0.6
前提是已经有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 class HelloWorld {
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代码 [ 注意理解这个参数的传递过程 ]。