我有一组来自不同git仓库的java项目,我想用Jenkins构建。
它们都共享相同的ant构建脚本,该脚本通过ant导入机制使用项目特定的配置部分(例如编译类路径)。
目前我是手动进行共享的,但是在修改公共部分时很容易出错。
所以我的问题是:在jenkins服务器上跨多个构建作业管理共享ant构建脚本的好方法是什么?
这个问题并不少见,@whiskeyspider指出这并不局限于Jenkins。在我看来,这也是阻碍大型遗留ANT构建的问题之一。随着时间的推移,更改公共逻辑变得越来越困难,因为有理由担心这会破坏依赖构建。
将公共逻辑保存在单独的存储库或git子模块中是合理的建议,因为这样可以对该逻辑进行版本控制。另一种选择是将公共逻辑打包为ANT库
<project ... xmlns:common="antlib:com.example.commonbuild">
<taskdef uri="antlib:com.example.commonbuild">
<classpath>
<fileset dir="${lib.dir}" includes="commonbuild-1.0.jar"/>
</classpath>
</taskdef>
..
..
<target name="build">
<common:compileAndPackage srcDir="${src.dir}" buildDir="${build.dir}" jarFile="${build.dir}/${ant.project.name}.jar"/>
</target>
虽然它看起来更复杂,但我认为创建这些类型的常见任务可以使构建文件更具可重用性和可读性。它还使您的组织的自定义是显而易见的。我发现它对于隐藏可能涉及讨厌的嵌入式脚本的实现细节特别有用。
最后,我非常喜欢使用ivy来管理我的第三方依赖。这意味着我可以轻松地从存储库下载构建所需的公共逻辑的任何版本。
如何创建ANT库
├── build.xml
└── src
└── com
└── example
└── commonbuild
└── antlib.xml
antlib.xml
<antlib>
<macrodef name="compileAndPackage">
<attribute name="srcDir"/>
<attribute name="buildDir"/>
<attribute name="jarFile"/>
<sequential>
<mkdir dir="@{buildDir}/classes"/>
<javac srcdir="@{srcDir}" destdir="@{buildDir}/classes" includeantruntime="false"/>
<jar destfile="@{jarFile}" basedir="@{buildDir}/classes"/>
</sequential>
</macrodef>
</antlib>
注意:
- 这个例子只有一个任务。实际上,您的公共构建逻辑将提供多个macrodef。
build . xml
只是jar up XML文件:
<target name="build" description="Create jar">
<jar destfile="${build.dir}/commonbuild-${version}.jar" basedir="${src.dir}"/>
</target>
我的构建逻辑还会将这个jar文件发布到我的存储库中,以便其他构建可以使用ivy将它拉下来。也意味着公共构建逻辑可以有一个独立的和正式的发布管理生命周期(在大型组织中非常重要)
几个想法…
- 将Ant脚本存储在您的单个项目可以从中提取的工件存储库中,就像任何其他依赖项一样。
- 创建包含构建脚本的父Git项目。在父项目中,将每个单独的子项目作为Git子模块拉下。为了在构建脚本中参数化子项目引用,您可能需要对脚本进行一些小修改。
这个答案不是特定于Jenkins的,应该可以移植到其他构建服务器。
我自己也找到了另一个选择:
将公共构建脚本中的"可重写"部分声明为"中立"元素,例如,为路径定义定义一个空路径:
<path id="additional-classpath" />
可选择在中性定义之后导入另一个构建脚本,使其覆盖现有的构建脚本:
<import file="compile-classpath.xml" optional="true" />
在导入的文件中,您现在可以定义元素以适应要构建的项目的个别需求。