需求:
使用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 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中对该作业点击『立即构建』,执行结果如下:
4.小结
①Jenkins 「参数化构建过程」 供用户输入参数。
②ant脚本可以作为中间媒介将上述参数传递给Java代码 [ 注意理解这个参数的传递过程 ]。