CruiseControl+SVN+Maven+Tomcat6持续集成搭建总结

   最近经理让我去研究并且给搭建一个持续集成的环境，这样一来，以后持续集成开发将会非常方便，开发人员开发完提交代码到SVN，CruiseControl会检测SVN代码是否有异动，如有异动，则自动进行编译，编译成功则自动将编译的结果布暑到tomcat，如编译失败则发送邮件给相关人员，布暑完毕自动重启，这样测试人员就可以在测试站点进行测试。自动化代替人工的反复操作，确实很有意义，并且提高了工作效率。
    起初对CruiseControl一无所知，经过一段时间的研究学习，翻阅大量的资料和反复的试验，总算是将环境给搭建成功了。
    首先借用百科对CruiseControl解释：
CruiseControl ：简称 CC ，持续集成工具，主要提供了基于版本管理工具(如CVS、VSS、SVN)感知变化或每天定时的持续集成，并提供持续集成报告、 Email 、Jabber 等等方式通知相关负责人，其要求是需要进行日构建的项目已编写好全自动的项目编译脚本(可基于Maven 或 Ant) 。
    其次借用网上资料对CruiseControl功能的归纳：
如果以一个项目来简要的说说 cc 的使用，通常项目对于日构建的类型的需求分为两种：

1 、每天的定时自动集成。
2 、感知版本管理工具中的变化而进行自动集成。

项目对于日构建的目标通常为：

1 、感知版本管理工具的变化，如发现有变化，则进行集成。
2 、调用项目编译脚本进行项目集成。
3 、合并项目编译脚本产生的单元测试、功能测试的日志。
4 、将集成报告发布至网站中。
5 、将集成的结果以邮件、 jabber 等等方式通知相应的负责人。

   下面对搭建过程所遇到的问题进行总结，其实持续集成的搭建最主要的就是CruiseControl中的Config.xml的配置。所遇到的问题也是配置的问题。
  
   问题一：与SVN集成，配置后测试报错：net.sourceforge.cruisecontrol.CruiseControlException: svn failed with exception。   在Config.xml配置时，需要调用svn.exe这个命令，如果机子上装了svn那不会出现这问题，可是在公司一般都是svn单独装在一台机子上，我们开发人员都是装个客户端，最常用的就是那个tortoise,可是这个客户端并没有svn.exe，网上有人建议在本机上装个SVN好了，这样做并不稳妥，最好的方案是安装另外一个客户端：CollabNetSubversion-client。

   问题二：与Maven集成时，由于项目比较老，用的技术也陈旧，只能用Maven1.0来编译，不知道怎么写，参考网上大都是与Ant、Maven2.0集成。通过反复的搜索，无意中找到了config.xml文档，哇，这下可兴奋了，里面标签、属性都有,这下配起来心里就有底了。其中goal属性愣是没看懂什么意思，汗，也许是自己英文太菜了吧;不服到网上看别人怎么写，看了几份配置也没看出有什么规律，没辙找经理去，还是经理有经验，一个提示就解决了：goal的属性值与maven.xml中的project的default属性值同;之前还纳闷配置里怎么没有与maven.xml关联，现在豁然开朗。
  
   问题三：搭建的环境不仅仅要编译，还要进行一系列的操作，即意味着要按顺序执行多个脚本，这可又把我难住了，是否把脚本都排在maven脚本后面就好，猜想归猜想，实践才是王道，实践证明猜想不成立，它们是并发执行的，没有先后顺序。读文档找标签，pipedexec比较符合要求，尝试了，报错了，在文档里timeout这个属性不是必要的，可我不想它就一直给报错，汗，找不到解释，那就填上吧。说实在，文档并不好用，晦涩难懂，也许是因为都是英文理解得不到位吧，可这上面例子一点也不好用，一些地方还写错了，不抱怨，有总比没有好。
  
   问题四：与Tomcat集成，大部分人都喜欢用解压的Tomcat吧，我也是，不用安装解压就能用多省事。不过现在集成可一点都不省事，因为其中一步操作是启动tomcat，这一启动不要紧，问题是它弹出的dos窗口就停在那了，这样CruiseControl也停在那了，还给报了个编译失败。没法子，只好安装个安装版的Tomcat，让它以服务的形式在后台运行。很好很强大，通过了。
  
   配置文件相关代码：

<cruisecontrol>
   <project name="current">
        <listeners>
            <currentbuildstatuslistener file="logs/${project.name}/status.txt"/>
        </listeners>

        <bootstrappers>
            <svnbootstrapper localWorkingCopy="projects/${project.name}" />
        </bootstrappers>

        <modificationset quietperiod="30">
            <svn localWorkingCopy="projects/${project.name}"/>
        </modificationset>

        <schedule interval="300">
		 <composite>
         <maven mavenscript="E:/software/maven-1.0.2/bin/maven.bat" projectfile="projects/${project.name}/project.xml"   
		  goal="clean war:webapp" />
<!--     <maven2 mvnscript="mvn" pomfile="projects/${project.name}/pom.xml" goal="clean|package" />
-->  
		  <pipedexec timeout="120">
		     <exec id="1" command="E:\CruiseControl\stop.bat" />      
             <exec id="2" waitfor="1" command="E:\CruiseControl\copy.bat" />
		     <exec id="3" waitfor="2" command="E:\CruiseControl\start.bat" />
		  </pipedexec>
		 </composite>
        </schedule>

        <log>
            <merge dir="projects/${project.name}/test-results"/>
        </log>

        <publishers>
            <onsuccess>
                <artifactspublisher dest="artifacts/${project.name}" file="projects/${project.name}/${project.name}-3.13.5.war"/>
            </onsuccess>
			<htmlemail
                charset="UTF-8"
                mailhost="smtp.163.com" 
                defaultsuffix="@163.com"
                returnname="CruiseControl"
                returnaddress="***@163.com"
                skipusers="true"
                subjectprefix="[CruiseControl]"
                xsldir="webapps/cruisecontrol/xsl"
                css="webapps/cruisecontrol/css/cruisecontrol.css"
                buildresultsurl="http://localhost:8080/cruisecontrol/buildresults/${project.name}">
                <always address="***" />
			    <failure address="***,***"/>
            </htmlemail>
        </publishers>
    </project>
</cruisecontrol>

评论

3 楼 daidalei321 2012-11-15  

我在config.xml配置关闭和启动tomcat，怎么不执行啊？tomcat没有启动。您能给您的stop.bat、copy.bat、start.bat发给我一份参考一下呢？我的邮箱：[e-mail]

我的配置：
<schedule interval="300">
   <maven2 mvnhome="${maven}" pomfile="projects/${project.name}/pom.xml" goal="clean package site"/>
   <pipedexec timeout="240">  
    <exec id="1" command="D:\osgi_tomcat6.0\bin\shutdown.bat" />         
   <exec id="2" waitfor="1" command="D:\osgi_tomcat6.0\bin\startup.bat" />  
   </pipedexec>
</schedule>

2 楼 xafc2370 2012-11-13  

daidalei321 写道

您好我想请教一下与Tomcat集成的配置文件应该怎么写？

这里Tomcat不需要写什么配置文件，编译好后，你将tomcat部署目录指向编译好的文件所放在的目录就可以了。如在server.xml加上如下一行：<Context path="/test" docBase="D:\test" />或者直接让copy.bat拷贝到tomcat的webapps目录下也行。

1 楼 daidalei321 2012-11-12  

您好我想请教一下与Tomcat集成的配置文件应该怎么写？