Hudson CI入门

最近正好有机会在工作中推广持续集成，就借机在项目中做了一些应用，起初选择了老牌的CruiseControl ，不过在实际的使用中总感觉CruiseControl在多模块的Maven项目方面有些力不从心，而且结果报表和使用界面上也不是让我很满意，配置起来还有点麻烦，也许TW的几个核心贡献者都把精力放在Cruise上了吧……

在一个项目结束后，决定抛弃CruiseControl，在新项目里试试Hudson ，经过几天的接触，有种相见恨晚的感觉。Hudson几乎就是完全符合我对持续集成工具的要求，有些地方甚至还大大超过了我的预期。

 

1、安装

从http://hudson-ci.org/ 下载最新的hudson.war 包。如果只是试用，可以直接用：

java -jar hudson.war

正常使用时建议部署到Web容器中，以Tomcat为例，将文件解压到webapps里即可。

注1： Tomcat中建议将URI编码设为UTF-8 ，修改Tomcat的conf/server.xml，在<Connector>中添加URIEncoding="UTF-8"。

<Connector port="80" protocol="HTTP/1.1" connectionTimeout="20000" redirectPort="8443" URIEncoding="UTF-8"/>

注2： 建议修改Hudson的HUDSON_HOME 配置，默认的位置比较隐蔽，可以指定一个位置，专门用于Hudson存放文件。打开webapps/hudson/WEB-INF/web.xml，找到HUDSON_HOME的env-entry。

<env-entry> <env-entry-name>HUDSON_HOME</env-entry-name> <env-entry-type>java.lang.String</env-entry-type> <env-entry-value>D:/Hudson</env-entry-value> </env-entry>

2、全局设置

Manage Hudson中选择Configure System，其中可对Maven、JDK、Ant进行设置，因为使用Hudson时一般都已经安装好了这些东西，所以不用勾选Install automatically，只需在Add时指定名字和相应的HOME位置即可。

因为在进行构建及测试等工作时，会占用大量内存，所以需要调整MAVEN_OPTS ，可以调整全局MAVEN_OPTS，也可以为每个项目单独设置MAVEN_OPTS，例如，设置Global MAVEN_OPTS为-Xmx1024m -Xms512m。

 

3、安装插件

插 件机制为Hudson带来了无限的扩展性，默认安装后Hudson已经自带了一些插件，例如maven、subversion等，可以通过Hudson管 理界面中的Plugin Manager来安装更多插件。由于我在过程中需要做静态代码分析和单元测试覆盖率分析，所以需要额外安装一些插件：

• Static Analysis Collector Plug-in
• Static Analysis Utilities
• Checkstyle Plug-in
• FindBugs Plug-in
• PMD Plug-in
• Emma Plugin

此外，如果需要定制邮件通知内容，还可以安装Hudson Email Extension Plugin。以及Dashboard View，用于显示仪表板。

 

4、项目配置

虽然Hudson也有rake的插件，不过我们还是以Maven为主，所以在New Job里选择Build a maven2 project，新建完成后也可以对项目设置进行修改。

• Source Code Management中可以配置相应的版本管理工具，例如Subversion，如果Subversion的Repository需要认证，Hudson在完成设置后会提示的。
• Build Triggers用于设置如何触发构建，Build periodically可设置定时，共5项内容，以空格分隔，具体配置可点击配置界面右侧的问号（这个做的也很人性化，随时可以获取所需的帮助）

  MINUTE HOUR DOM(Day of Month) MONTH DOW(Day of week)

• Build项中主要设置项目的pom.xml，还有构建时使用的Maven Goals，例如

compile test findbugs:findbugs emma:emma

• Build Settings和Post-build Actions中可以根据上面使用的Goals勾选相应的内容，例如，要发布Checkstyle、Findbugs和PMD的报告，需要合并发布分析结果，需要发布单元测试覆盖率报告等

凡是有问题，先找右侧的问号，基本就能知道该如何配置了。

需要生成报告，就需要提供报告所需的数据，因此在正式使用前需要在项目的pom.xml中配置Maven插件。

在<reporting>段中增加如下内容（版本号请根据最新版本调整）：

<reporting> <plugins> <plugin> <groupId>org.codehaus.mojo</groupId> <artifactId>findbugs-maven-plugin</artifactId> <version>2.3</version> <configuration> <xmlOutput>true</xmlOutput> <threshold>High</threshold> <effort>Default</effort> <relaxed>true</relaxed> <findbugsXmlOutput>true</findbugsXmlOutput> </configuration> </plugin> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-checkstyle-plugin</artifactId> <version>2.4</version> </plugin> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-pmd-plugin</artifactId> <configuration> <targetJdk>1.5</targetJdk> </configuration> </plugin> <plugin> <groupId>org.codehaus.mojo</groupId> <artifactId>emma-maven-plugin</artifactId> <version>1.0-alpha-2</version> <inherited>true</inherited> </plugin> </plugins> </reporting>

<build>段中同样加入emma插件：

<plugin> <groupId>org.codehaus.mojo</groupId> <artifactId>emma-maven-plugin</artifactId> <version>1.0-alpha-2</version> <inherited>true</inherited> <executions> <execution> <id>instrument</id> <phase>pre-site</phase> <goals> <goal>instrument</goal> </goals> </execution> </executions> </plugin>

注3： 如果觉得静态代码分析的各个规则过于严格，希望定制，也可以在pom.xml中进行定制，模块化的项目中，子模块中的配置可以覆盖上级配置，以 Findbugs为例，如果希望去掉一些规则，可在<plugin>的<configuration>配置中加入：

<excludeFilterFile>findbugs-exclude.xml</excludeFilterFile>

同时新建findbugs-exclude.xml，内容如下：

<FindBugsFilter> <Match> <Bug pattern="EI_EXPOSE_REP, EI_EXPOSE_REP2" /> </Match> </FindBugsFilter>

完成所有的配置后，可以等待定时执行或者手工去触发构建，构建之后就能在项目页面查看到漂亮的图表及报告了。