Jenkins结合ant传递参数

　　需求：

　　使用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+"!");
    }

}

<?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>

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

注：上面已经提及，需要将整个项目（包含build.xml）拷贝到Jenkins的工作空间目录下（我的是E:jenkinssrc-usercreate）。

3.4  构建结果

在Jenkins中对该作业点击『立即构建』，要求输入CODE_VERSION的值，这里了输入v2.0。执行结果如下：

4.小结

①Jenkins 「参数化构建过程」 供用户输入参数。

②ant脚本可以作为中间媒介将上述参数传递给Java代码 [ 注意理解这个参数的传递过程 ]。