需求:
使用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 工作二
直接上代码了。
package com.primeton.ant; public class HelloWorld { /**
* @param args
*/
public static void main(String[] args) {
String version = args[0];
System.out.println("Hello,"+version+"!");
} }
Java代码
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<project name="javaant" basedir="." default="main"> <property name="src.dir" value="src"/>
<property name="build.dir" value="build"/>
<property name="classes.dir" value="${build.dir}/classes"/>
<property name="jar.dir" value="${build.dir}/jar"/>
<property name="main-class" value="com.primeton.ant.HelloWorld"/>
<property name="CODE_VERSION" value="v1.2.2"/>
<target name="clean">
<delete dir="${build.dir}"/>
</target> <target name="compile">
<mkdir dir="${classes.dir}"/>
<javac srcdir="${src.dir}" destdir="${classes.dir}"/>
</target> <target name="jar" depends="compile">
<mkdir dir="${jar.dir}"/>
<jar destfile="${jar.dir}/${ant.project.name}.jar" basedir="${classes.dir}">
<manifest>
<attribute name="Main-Class" value="${main-class}"/>
</manifest>
</jar>
</target> <target name="run" depends="jar">
<java jar="${jar.dir}/${ant.project.name}.jar" fork="true">
<arg value="${CODE_VERSION}"/>
</java>
</target> <target name="clean-build" depends="clean,jar"/> <target name="main" depends="clean,run"/> </project>
ant脚本
整个Java工程目录层次如下:
注:上面已经提及,需要将整个项目(包含build.xml)拷贝到Jenkins的工作空间目录下(我的是E:\jenkins\src-usercreate\)。
3.4 构建结果
在Jenkins中对该作业点击『立即构建』,要求输入CODE_VERSION的值,这里了输入v2.0。执行结果如下:
4.小结
①Jenkins 「参数化构建过程」 供用户输入参数。
②ant脚本可以作为中间媒介将上述参数传递给Java代码 [ 注意理解这个参数的传递过程 ]。