集成与构建指南（5）

1.1         CruiseControl执行脚本

持续集成的过程由缺省文件名为config.xml的配置文件来定义。config.xml中确定了构建周期间隔，以及检测配置库状态、调用Ant配置文件进行构建等步骤的内容。为了实现自动化持续集成，还应编制Ant封装（wrapper）配置文件，它在调用原始Ant构建脚本（相当于将原始Ant脚本封装在内）的基础上，添加用于持续集成的更新源码目录等步骤。

1.1.1          CruiseControl项目配置文件

CruiseControl项目配置文件描述了一个集成项目（project），它由引导段（bootstrappers）、检测修改集段（modificationset）、调度段（schedule）、日志记录段（log）、发布段（publishers）、插件定义段（plugin）组成。引导段用来设置持续集成流程开始执行时相关的初始化任务，例如更新源码管理中的指定文件；检测修改集段则指定了需要检测的已置于配置管理下的目标源码，以便在检测到有源码更新后启动后续的构建步骤，例如clearcase中的某分支下、某视图中的一个目录；调度段是持续集成流程的核心部分，在此确定了构建周期间隔、休眠时段，并描述了构建的目标，目标通常指向一个Ant封装配置文件；日志记录段指定了将向发布步骤提供数据的各项日志记录；发布段则设置了对构建结果进行发布和通知的内容，例如指定报告的E-mail地址等；插件定义段用来指定CruiseControl各项功能实现对应的插件类。

1.1.2       CruiseControl配置文件示例

下面是一个CruiseControl项目的配置文件示例：

 

<?xml version="1.0"?> <cruisecontrol>          <project name="peripheral_api_project">                    <bootstrappers>                             <currentbuildstatusbootstrapper file="currentbuild.txt"/>                    </bootstrappers>                    <modificationset quietperiod="30">                            <clearcase branch="PCHL_V1_Dev" recursive="true"                                     viewpath="d:/Shared_Views/PCHL_V1_Dev/PCHL_Components/protocols_api/peripheral"/>                    </modificationset>                    <schedule interval="60">                             <ant buildfile="proj.xml" target="cleanbuild" multiple="5"/>                             <ant buildfile="proj.xml" target="masterbuild" multiple="1"/>                             <pause starttime="1900" endtime="2359"/>                             <pause starttime="0000" endtime="0659"/>                             <pause day="saturday" starttime="0000" endtime="2359"/>                             <pause day="sunday" starttime="0000" endtime="2359"/>                    </schedule>                    <log dir="logs/peripheral_api_project" encoding="ISO-8859-1">                             <merge dir="d:/Shared_Views/PCHL_V1_Dev/PCHL_Components/protocols_api/peripheral/bin/test-results"/>                    </log>                    <publishers>                             <currentbuildstatuspublisher file="currentbuild.txt"/>                             <email mailhost="sysway.com" returnaddress="xghu@sysway.com" defaultsuffix=""                                      buildresultsurl="http://pchl1-tstn:8080/cruisecontrol/buildresults" logdir="logs/peripheral_api_project"                                      css="C:/Development_Tools/Building-Utils/cruisecontrol-2.1.5/reporting/jsp/css/cruisecontrol.css"                                      xsldir="C:/Development_Tools/Building-Utils/cruisecontrol-2.1.5/reporting/jsp/xsl">                                      <always address="xghu@sysway.com"/>                                      <failure address="xghu@sysway.com"/>                                      <map alias="huxg" address="xghu@sysway.com"/>                             </email>                    </publishers>                    <plugin name="currentbuildstatusbootstrapper"                             classname="net.sourceforge.cruisecontrol.bootstrappers.CurrentBuildStatusBootstrapper"/>                    <plugin name="clearcasebootstrapper"                             classname="net.sourceforge.cruisecontrol.bootstrappers.ClearCaseBootstrapper"/>                    <plugin name="clearcase" classname="net.sourceforge.cruisecontrol.sourcecontrols.ClearCase"/>                    <plugin name="ant"                            classname="net.sourceforge.cruisecontrol.builders.AntBuilder"/>                    <plugin name="pause"                             classname="net.sourceforge.cruisecontrol.PauseBuilder"/>                    <plugin name="email"                             classname="net.sourceforge.cruisecontrol.publishers.HTMLEmailPublisher"/>                    <plugin name="currentbuildstatuspublisher"                             classname="net.sourceforge.cruisecontrol.publishers.CurrentBuildStatusPublisher"/>                    <plugin name="labelincrementer"                             classname="net.sourceforge.cruisecontrol.labelincrementers.DefaultLabelIncrementer"/>          </project> </cruisecontrol>

 

1.1.3       Ant封装（wrapper）配置文件示例

下面是一个Ant封装（wrapper）配置文件示例：

 

<?xml version="1.0"?> <project name="peripheral_api_cc" default="masterbuild">          <property file="proj.properties"></property>          <property name="proj.dir" location="${proj.path}"/>          <target name="update" description="Update packages from ClearCase">                    <ccupdate log="clearcase.log" overwrite="true" viewpath="${proj.dir}"/>          </target>          <target name="clean" description="Clean all build products">                    <ant dir="${proj.dir}/build" target="CleanAll"/>          </target>          <target name="build">                    <ant dir="${proj.dir}/build" target="AutoBuild"/>          </target>          <target name="rununittests" depends="build">                    <ant dir="${proj.dir}/build" target="Test"/>          </target>          <target name="smoketest" depends="build">          </target>          <target name="masterbuild" depends="update,rununittests,smoketest"                    description="Cruise control master build"/>          <target name="cleanbuild" depends="clean,masterbuild"                    description="Cruise control clean build"/> </project>

 

注意本Ant项目配置文件中主要添加了update目标，用来将proj.properties文件中定义的 proj.path=d:/Shared_Views/PCHL_V1_Dev/PCHL_Components/protocols_api/peripheral目录下的所有内容进行更新。

1.1.4       cruisecontrol执行示例

cruisecontrol在命令行下执行的示例：