[CruiseControl]配置文件config.xml

 

一 配置文件config.xml

< cruisecontrol >
    < property />
    < dashboard />
    < include.projects />
    < system >
       < configuration >
          < threads />
       </ configuration >
    </ system >
    < plugin />
    < project >
       < property />
       < plugin />
       < cvslabelincrementer >
       < emptylabelincrementer >
       < formattedlabelincrementer >
       < labelincrementer />
       < p4changelistlabelincrementer >
       < propertyfilelabelincrementer >
       < svnlabelincrementer >
       < listeners >
          < cmsynergysessionmonitor />
          < currentbuildstatusftplistener />
          < currentbuildstatuslistener />
          < currentbuildstatuspagelistener />
          < lockfilelistener />
       </ listeners >
       < bootstrappers >
          < accurevbootstrapper />
          < alienbrainbootstrapper />
          < antbootstrapper />
          < clearcasebootstrapper />
          < clearcaseviewstrapper />
          < cmsynergybootstrapper />
          < cmsynergybaselinebootstrapper />
          < cvsbootstrapper />
          < darcsbootstrapper />
          < execbootstrapper />
          < gitbootstrapper />
          < harvestbootstrapper />
          < lockfilebootstrapper />
          < mercurialbootstrapper />
          < p4bootstrapper />
          < plasticscmbootstrapper />
          < snapshotcmbootstrapper />
          < starteambootstrapper />
          < surroundbootstrapper />
          < svnbootstrapper />
          < tfsbootstrapper />
          < vssbootstrapper />
       </ bootstrappers >
       < modificationset >
          < accurev >
          < alienbrain />
          < alwaysbuild />
          < buildstatus />
          < clearcase />
          < cmsynergy />
          < compound >
             < targets />
             < triggers />
          </ compound >
          < cvs />
          < darcs />
          < filesystem />
          < forceonly />
          < git />
          < harvest />
          < httpfile />
          < mavensnapshotdependency />
          < maven2snapshotdependency />
          < mercurial />
          < mks />
          < p4 />
          < plasticscm />
          < pvcs />
          < snapshotcm />
          < starteam />
          < store />
          < surround />
          < svn />
          < tfs />
          < timebuild >
          < ucm >
          < veto />
          < vss />
          < vssjournal />
       </ modificationset >
       < schedule >
          < ant />
          < maven />
          < maven2 />
          < pause />
          < nant />
          < phing />
          < rake />
          < exec />
          < composite />
          < xcode />
       </ schedule >
       < log >
          < merge />
      < gzip />
      < delete />
      < deleteartifacts />
       </ log >
       < publishers >
          < antpublisher />
          < artifactspublisher />
          < clearcasebaselinepublisher />
          < cmsynergybaselinepublisher />
          < cmsynergytaskpublisher />
          < compoundpublisher />
          < email />
          < execute />
          < ftppublisher />
          < htmlemail />
          < http >
          < jabber />
          < onfailure />
          < onsuccess />
          < origo />
          < rss />
          < sametimeannouncement />
          < scp />
          < sfeedocman />
          < sfeefrs />
          < sfeetracker />
          < socket />
          < twitter >
          < weblog >
          < x10 />
          < xsltlogpublisher />
          < yahoopublisher />
       </ publishers >
    </ project >
</ cruisecontrol >

 

 

二 config.xml的元素<CruiseControl/>和子元素

1）<CruiseControl/>

<CruiseControl/>是配置文件的根节点，可以看做其他的元素容器。

它可以包含子元素：<system>，<project>，<plugin>，<property>，<include.projects>，<dashboard>。

2) <threads> （<system>/<configuration>/<threads>）

<threads> 用来指定CruiseControl可同时build projects的最大数目。默认为1。如果某一时刻需要运行的projects大于threads的count属性指定的值，则多余count的projects将处于等待队列。

它包含属性count。count表示thread的最大数目。

3) <property>

<property> 用来在config.xml中设置一个属性。

它可以包含属性name，value，enviroment，file，toupper。name/value用来表示一个属性；enviroment用来指定可以使用的系统环境变量的前缀，例如当environment为myenv时，表示可以使用系统中的所有的以myenv开始的环境变量，例如myenv.path；file用来加载专门包含<property/>的文件，将所有的property导入到当前config.xml；toupper用来将属性的名字转化为大写。

如下示例：

1.Set a couple of global properties using name/value pairs: 
< cruisecontrol >
     < property  name ="cruisedir"  value ="/home/cruise" />
     < property  name ="logdir"     value ="${cruisedir}/logs" />
    ...
< cruisecontrol >

2.Set a collection of global properties from the properties file "config.properties":
< cruisecontrol >
     < property  file ="config.properties" />
    ...
< cruisecontrol >

3.Load the system's environment into a collection of global properties. Uppercase all environment variable names: 
< cruisecontrol >
     < property  environment ="env"  toupper ="true" />
     < property  name ="logdir"      value ="${env.CCDIR}/logs" />
    ...
< cruisecontrol >

4.Define a global property called "buildmanager". Override it's value only within the scope of the project called "project2". 
< cruisecontrol >
     < property  name ="buildmanager"  value ="buildmgr@here.com" />

     < project  name ="project1" >
         <!--  ${buildmanager} resolves to "buildmgr@here.com"  -->
     </ project >

     < project  name ="project2" >
         < property  name ="buildmanager"  value ="someoneelse@here.com" />
         <!--  ${buildmanager} resolves to "someoneelse@here.com"  -->
     </ project >
< cruisecontrol >

5.As demonstrated here, properties and plugin pre-configuration can be an extremely powerful combination. 
< cruisecontrol >
     <!--  Load environment variables  -->
     < property  environment ="env"  toupper ="true" />

     <!--  Commonly used directories  -->
     < property  name ="reportdir"   value ="${env.CCDIR}/report" />
     < property  name ="projectdir"  value ="${env.CCDIR}/checkout/${project.name}" />
     < property  name ="testdir"  value ="${projectdir}/build/junit-reports" />
     < property  name ="logdir"  value ="${env.CCDIR}/logs/${project.name}" />

     <!--  Defaults for email  -->
     < property  name ="buildmaster.email"   value ="buildmaster@example.com" />
     < property  name ="buildmaster.name"   value ="Buildmaster" />

     <!--  Preconfigure our plugins  -->
     < plugin  name ="log"
            dir ="${logdir}" />

     < plugin  name ="currentbuildstatuslistener"
            file ="${logdir}/buildstatus.html" />

     < plugin  name ="cvs"
            localworkingcopy ="${projectdir}" />

     < plugin  name ="ant"
            antscript ="${env.ANT_HOME}/bin/ant"
            antWorkingDir ="${projectdir}"
            target ="cruise" />

     < plugin  name ="htmlemail"
            buildresultsurl ="http://servername/cruisecontrol/buildresults/${project.name}"
            mailhost ="smtp.example.com"
            returnaddress ="${buildmaster.email}"
            returnname ="${buildmaster.name}"
            subjectprefix ="[BUILD ${project.name}]"
            xsldir ="${reportdir}/jsp/webcontent/xsl"
            css ="${reportdir}/jsp/webcontent/css/cruisecontrol.css" />

     < project  name ="project1" />
         < listeners >
             < currentbuildstatuslistener />
         </ listeners >
         < log >
             < merge  dir ="${testdir}" >
         </ log >
         < modificationset >
             < cvs />
         </ modificationset >
         < schedule >
             < ant />
         </ schedule >
         < publishers >
             < htmlemail >
                 < always   address ="${buildmaster.email}" >
                 < failure  address ="proj1dev@example.com" >
                 < ignore  address ="buildmaster" >
             </ htmlemail >
         </ publishers >
     </ project >

     < project  name ="project2" />
         < listeners >
             < currentbuildstatuslistener />
         </ listeners >
         < log >
             < merge  dir ="${testdir}" >
         </ log >
         < modificationset >
             < cvs />
         </ modificationset >
         < schedule >
             < ant />
         </ schedule >
         < publishers >
             < htmlemail >
                 < always   address ="${buildmaster.email}" >
                 < failure  address ="proj2dev@example.com" >
             </ htmlemail >
         </ publishers >
     </ project >
</ cruisecontrol >

4）<include.projects>

<include.projects>用来将多个config文件合并为config文件。

它包含属性file，表示要include的config文件的相对路径。

5）<dashboard>

<dashboard>用来为build loop指定dashboard。

它包含属性url，postinterval。url为dashboard的url，postinterval表示build loop传输build信息到dashboard的间隔。

6）<project>

<project>是基本的工作单元。包含检查source修改，build，发布build结果。

它包含属性name，buildafterfailed，forcebuildnewproject，requiremodification，forceonly。buildafterfailed为ture表示即使build失败了，cruisecontrol继续保持build；forcebuildnewproject为ture表示如果没有发现project的序列文件（project.ser）就强制project开始build；requiremodification为ture表示当source code有修改时build，但是如果需要定时build或手动测试时，requiremodification需要为false。

它包含子元素<listeners>，<bootstrappers>，<modificationset>，<schedule>，<log>，<publishers>，<plugin>。

 

完！