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在命令行下执行的示例: