灿烂的阳光,苦涩的生活,认真做,你能行!

持续集成 Java手册

上一篇 / 下一篇  2009-02-18 14:23:01 / 个人分类:文档

持续集成 Java手册

一、概念

Martin Fowler的文章:Continuous Integration  中文翻译:持续集成

二、工具

传统工具:VisualStudio.Net,VisualSourceSafe,Rational ClearCase

自动编译工具:Ant

回归测试工具:JUnit

代码检查工具:CheckStyle

持续集成工具:CruiseControl

三、步骤

  • CruiseControl监控远程版本控制系统的变化

  • 变化发生时CruiseControl调用编译工具进行编译(Ant等)

  • 编译成功后调用JUnit进行回归测试

  • 编译成功后调用CheckStyle进行代码检查

  • 完毕后将编译结果、测试结果、代码检查结果发送至开发人员、主管经理,并发布至网站,甚至报警器

    所有这一切都是按照编制好的脚本自动进行的

四、实施示例

目前我们使用的是ClearCase,主控软件为CruiseControl,其脚本文件为cccc.xml

  • 配置远程版本控制系统

<modificationset quietperiod="30">
 <clearcasebranch="main"viewpath="D:/cc_view/chelseafc/Nucleus2.0/Port"recursive="true" />
 </modificationset>
  • 配置编译工具

<schedule interval="30">
 <antantscript="C:/Java/JBuilder2005/thirdparty/ant/bin/ant.bat"buildfile="D:/cc_view/chelseafc/Nucleus2.0/Port/clearcase-build.xml"target="cleanbuild"multiple="1" />
 </schedule>
  • 配置测试用例(在ant的配置文件中)

<target name="test"depends="init"description="Run unit tests">
 <deletedir="${junit.results}" />
 <mkdirdir="${junit.results}" />
-<junit fork="yes"haltonfailure="yes">
-<classpath>
 <pathelementlocation="${build.dir}" />
 </classpath>
 <formattertype="plain"usefile="false" />
 <formattertype="xml" />
-<batchtest todir="${junit.results}">
 <filesetdir="${build.dir}"includes="**/*Test.class" />
 </batchtest>
 </junit>
 </target>
  • 配置报告形式
<publishers>
 <currentbuildstatuspublisherfile="currentbuild.txt" />
-<htmlemail mailhost="mail.chelseafc.com.cn"returnaddress="workflow_engine@chelseafc.com.cn"subjectprefix="ContinuousIntegration:"buildresultsurl="http://chelsea:8044/cruisecontrol/buildresults"spamwhilebroken="true"xsldir="F:/software/Agile.Net/cruisecontrol-2.2/reporting/jsp/xsl"css="F:/software/Agile.Net/cruisecontrol-2.2/reporting/jsp/css/cruisecontrol.css"logdir="D:/Tomcat 4.1/webapps/cruisecontrol/samplelogs">
 <alwaysaddress="chelsea@chelseafc.com.cn" />
 <alwaysaddress="ajax@chelseafc.com.cn" />
 <mapalias="chelsea"address="chelsea@chelseafc.com.cn" />
 </htmlemail>
 </publishers>
  • 其中CruiseControl暂时没有提供代码检查工具的支持,建议使用Ant来调用CheckStyle,示例如下(没有真正运行过):
<target name="web.checkstyle">
 <mkdirdir="${target.temp}/checkstyle" />
 <mkdirdir="${target.web}/checkstyle" />
-<taskdef resource="checkstyletask.properties">
-<classpath>
 <filesetdir="${support.tools}/checkstyle31"includes="**/*.jar" />
 </classpath>
 </taskdef>
-<copy file="${support.tools}/checkstyle31/custom.xml"overwrite="true"tofile="${target.temp}/checkstyle/custom.xml">
-<filterset>
 <filtertoken="source.java"value="${basedir}/${source.java}" />
 <filtertoken="target.checkstyle"value="${basedir}/${target.temp}/checkstyle" />
 </filterset>
 </copy>
-<checkstyle. config="${target.temp}/checkstyle/custom.xml"failOnViolation="false">
 <filesetdir="${source.java}/main"includes="**/*.java" />
 <formattertype="plain" />
 <formattertype="xml"toFile="${target.temp}/checkstyle/checkstyle_errors.xml" />
 </checkstyle>
 <stylebasedir="${target.temp}/checkstyle"destdir="${target.web}/checkstyle"includes="checkstyle_errors.xml"style="${support.tools}/checkstyle31/checkstyle-noframes.xsl" />
 </target>

五、几点提示

  • CruiseControl会自动根据本地ClearCase的View监控远程VOB
  • 其实除了监控远程版本控制系统外其它的任务都可以由Ant来完成,CC只负责监控变化并调用Ant即可
  • 可以为cruisecontrol.bat加入启动参数“-port 8055”,这样可以用JMX(http://localhost:8055)来控制cc
  • 最好避免中文路径,否则就需要手工为几个Xml格式的文件,如cc的report Servlet的Web.xml等加入编码方式“<?xml version="1.0" encoding="UTF-8"?>,或者将中文路径映射为虚拟硬盘:“subst Y: "D:/cc_view/chelsea/Platform/开发/Nucleus2.0/Source"”
  • 中文log无法正常显示时,需要设置CruiseControl配置文件中<log>元素的“encoding”属性,如:
    <log dir="D:/Tomcat 4.1/webapps/cruisecontrol/samplelogs"encoding="utf-8">
     <mergedir="D:/cc_view/chelseafc/Nucleus2.0/Port/test-results" />
    </log>
  • 编译失败后,在下次checkin之前,一般不需要重新编译,这时可设置<project>的“buildafterfailed”属性为false来避免重新编译
  • <htmlemail>的几个属性好像没有缺省设置,虽然文档里说从2.1.7开始有缺省设置,包括xsldir,css,logdir
  • 各种工具的安装、使用,在各自的文档里都非常详细,网上亦有无数资源

六、参考资料

  • DailyBuild全攻略
  • Draco.Net
  • 持续集成.Net手册

TAG:

 

评分:0

我来说两句

显示全部

:loveliness: :handshake :victory: :funk: :time: :kiss: :call: :hug: :lol :'( :Q :L ;P :$ :P :o :@ :D :( :)

Open Toolbar