ci&ant

自己两个多星期以来对持续集成的概念和应用有了一些了解。下面主要对自己配置持续集成的环境进行总结。（看上去简单，但是对我开始对持续集成都没什么了解的人来说确实费了不少周折）

一  本次持续集成环境的搭建所使用的工具有

cruisecontrol、ant、svn、junit、Slik-Subversion-1.5.6-win32、svnant-1.1.0-RC2.zip

cruisecontrol:是一种持续集成过程的框架，包括了邮件通知，ant 和各种源码控  制工具的插 件。并提供了web接口，用于查看当前和以前的创建的结果.

ant:构建工具。

svn：版本控制工具。

junit：单元测试工具。

slik-subversion：是为了调用svn的客户端命令安装的。

svnant：主要是用到它里面的lib中的jar包，它具体使用还不是很清楚

另外本次的辅助环境还有jdk，相信大家都再也熟悉不过了。

二 环境的搭建步骤：

jdk的安装：根据jdk安装包的提示安装jdk。设置系统的环境变量：
a) JAVA_HOME指明JDK安装路径，就是刚才安装时所选择的路径D:\java\jdk1.5.0_08，此路径下包括lib，bin，jre等文件夹（此变量最好设置，因为以后运行tomcat都需要依赖此变量）；

b) Path使得系统可以在任何路径下识别java命令，设为%JAVA_HOME%\bin;%JAVA_HOME%\jre\bin；

c)CLASSPATH为java加载类(class or lib)路径，只有类在  classpath中，java命令才能识别，设为：.;JAVA_HOME\lib\dt.jar;JAVA_HOME%   \lib\tools.jar (要加.表示当前路径)；%JAVA_HOME%就是引用前面指定的JAVA_HOME；不过本人还是比较相信绝对路径的。

2 ant的安装：ant是集成构建工具，想必大家都不太陌生了。只需要到ant.apache.org的网站下载ant的适当版本解压缩后，配置系统的环境变量：ANT_HOME:d:\apache-ant-1.7.0, path:d:\apache-ant-1.7.0\bin 后，ant就可以在任意目录下运行了，如cmd下运行ant，显示：buildfile：build.xml does not exsit。。。。。

3 安装svn，因为cruisecontrol要用到svn（不知道这两个有什么先后顺序没，因为cc要用svn就先装cc喽）。svn的安装TortoiseSVN-1.5.3.13783-win32-svn-1.5.2.msi安装提示装就可以了。

4 安装tomcat ，设置系统环境变量CATALINA_HOME=c:\tomcat,CLASSPATH=C:\tomcat\common\lib(加载必要的包）。

5 cuisecontrol的安装，因为本文使用的操作系统为XP，就使用CruiseControl-2.8.2.exe安装就可以了（.exe文件还是很受大家喜欢的）。配置系统的环境变量：CC_HOME=d:\cruisecontrol

6 安装slik-subversion，它会自动写入到path=D:\SlikSvn\bin\ 如果没有写入的话，要麻烦手动加入到系统的环境变量path中，本人曾经遇到过，cmd窗口已经打开但是配置文件执行过程中svn的命令总不能识别发现此处的路径没有加入到path中。

7下载svnant-1.1.0-RC2.zip，把lib包中的jar考到ant的jar中。

三 以上的准备工作已经基本搞定，下面就介绍一下配置文件。此次环境的搭建配置文件是很关键的，因为他们各自有自己的标签，所以还要想达到什么功能慢慢查找，（如果有时间系统学习一下就好了）。

1 ant的关键文件为build.xml（当然也可以起别的名称，自己还要改它的启动文件，就用这个名称吧）下面是一个实例：

<?xml version="1.0" encoding="UTF-8" standalone="no"?>

定义basedir当前的根目录，default默认执行的标签，name工程名
<project basedir="." default="all" name="framework">
<property environment="env" />

定义tomcat的安装目录
<property name="TOMCAT_DIR" location="D:/Tomcat 5.5" />

定义debug的级别
<property name="debuglevel" alue="source,lines,vars" />

为了引用tomcat固有包方便所以增加次属性
<property name="coolink.dist.path" location="D:/Tomcat 5.5/webapps/txsd/WEB-INF" />

指定要编译的工程目录
<property name="CLASS_DIR" location="D:/CruiseControl/projects/framework" />
<property name="target" value="1.5" />
<property name="source" value="1.5" />

编译时候所使用的类路径，id为引用的名称
<path id="Apache Tomcat v5.5 [Apache Tomcat v5.5].libraryclasspath">
  <pathelement location="${TOMCAT_DIR}/common/lib/commons-el.jar" />
  ....
  <pathelement location="${TOMCAT_DIR}/common/lib/servlet-api.jar" />
</path>
<path id="Web App Libraries.libraryclasspath">
  <pathelement location="${coolink.dist.path}/lib/activation.jar" />
  .............
  <pathelement location="${coolink.dist.path}/lib/xmlParserAPIs.jar" />
</path>
  <path id="ant.svn.classpath">
  <fileset dir="D:/CruiseControl/apache-ant-1.7.0/lib">
   <include name="*.jar" />
  </fileset>
</path>
<taskdef name="svn" classname="org.tigris.subversion.svnant.SvnTask">
  <classpath refid="ant.svn.classpath" />
</taskdef>
<path id="txsd.classpath">
  <path refid="Apache Tomcat v5.5 [Apache Tomcat v5.5].libraryclasspath" />
  <path refid="Web App Libraries.libraryclasspath" />
</path>

clean操作，如果build之前不执行此操作，build检查到原有的class文件就不再编译。
<target name="clean">
     <delete file="${CLASS_DIR}/longcon-framework.jar" />
     <delete dir="target" quiet="true" />
  <delete dir="${CLASS_DIR}/source/classes" />
</target>

要build模块的名称build-framework看来可以随便起名字，但是有人说必须和模块名称一致，至今还不知道为什么
<target name="build-framework">
  <echo message="${ant.project.name}: ${ant.file}" />
  <mkdir dir="${CLASS_DIR}/source/classes" />
  <copy includeemptydirs="false" todir="source/classes">
   <fileset dir="${CLASS_DIR}/source" excludes="**/*.launch, **/*.java" />
  </copy>
  <javac debug="true" debuglevel="${debuglevel}" destdir="${CLASS_DIR}/source/classes" source="${source}" target="${target}" encoding="UTF-8">
   <src path="${CLASS_DIR}/source" />
   <exclude name="**/.svn/**" />
   <classpath refid="txsd.classpath" />
  </javac>
</target>

单元测试的部分
<target name="test">
  <mkdir dir="target/test-classes" />
  <javac encoding="UTF-8" srcdir="${CLASS_DIR}/test" destdir="target/test-classes">
   <classpath>
    <pathelement location="${CLASS_DIR}/source/classes" />
    <path refid="Apache Tomcat v5.5 [Apache Tomcat v5.5].libraryclasspath" />
          <path refid="Web App Libraries.libraryclasspath" />
   </classpath>
  </javac>

  <mkdir dir="target/test-results" />
  <junit haltonfailure="no" printsummary="on">
   <classpath>
    <pathelement location="${CLASS_DIR}/source/classes" />
    <pathelement location="${coolink.dist.path}/lib/junit.jar" />
    <pathelement location="target/test-classes" />
   </classpath>
   <formatter type="brief" usefile="false" />
   <formatter type="xml" />
   <batchtest todir="target/test-results">
    <fileset dir="target/test-classes" includes="**/*.class" />
   </batchtest>
  </junit>
</target>

打包放到指定目录
<target name="jar">
  <jar destfile="${CLASS_DIR}/longcon-framework.jar" encoding="UTF-8" update="false" excludes="**/*Test*.class">
   <fileset dir="${CLASS_DIR}/source/classes" />
  </jar>
  <copy includeemptydirs="false" todir="${coolink.dist.path}/lib">
   <fileset file="${CLASS_DIR}/longcon-framework.jar" excludes="**/*.launch, **/*.java" />
  </copy>
</target>

调用svn命令，这与三中的步骤7有密切的联系
<target name="commit">
<svn username="aaa" password="aaa">
         <commit file="${coolink.dist.path}/lib/longcon-framework.jar" message="${msg.commit}"  />
     </svn>
</target>
<target name="all"  depends="clean,build-framework,jar,commit"/>

</project>
注释：

a设置编译所需要的类路径可以用：                      <classpath>
      <pathelement path="${classpath}"/>
      <fileset dir="lib">
        <include name="**/*.jar"/>
      </fileset>
      <pathelement location="classes"/>
      <dirset dir="build">
        <include name="apps/**/classes"/>
        <exclude name="apps/**/*Test*"/>
      </dirset>
      <filelist refid="third-party_jars"/>

   </classpath>

b <target name="test" depends="clean">depends表示依赖关系
2 cruisecontrol的config文件，CC启动的时候会自动寻找此文件，当然你可以通过修改启动文件修改config.xml名称，只要两处一致就能找到，下面是一个config文件的实例：

<cruisecontrol>//cc的固有标签，cc中可以有多个project

<project name="framework">// 工程名称

<plugin name="labelincrementer" classname="net.sourceforge.cruisecontrol.labelincrementers.SVNLabelIncrementer"/>
       <labelincrementer workingcopypath="projects/${project.name}"/> // 显示svn的版本号

listeners：监听器，来报告cc的此项目的运行信息
  <listeners>
   <currentbuildstatuslistener file="logs/${project.name}/status.txt" />
  </listeners>

bootstrappers从svn源码控制程序更新本地版本，据说还有向其它插件提供当前创建的状态

  <bootstrappers>
   <svnbootstrapper localWorkingCopy="projects/${project.name}" username="luojing" password="luojing" />
  </bootstrappers>
  <bootstrappers>//向ant提供当前信息
   <antbootstrapper anthome="apache-ant-1.7.0" buildfile="projects/${project.name}/build.xml" target="jar" />
  </bootstrappers>
  <modificationset quietperiod="30">// 通过svn更新原代码
   <!-- touch any file in connectfour project to trigger a build -->
   <svn localWorkingCopy="projects/${project.name}" username="luojing" password="luojing" />
  </modificationset>

<schedule interval="28800">设定检查编译build版本的时间单位s
   <ant anthome="apache-ant-1.7.0" buildfile="projects/${project.name}/build.xml" />
  </schedule>
  <log>//显示单元测试信息
   <merge dir="projects/${project.name}/framework/target/test-results" />
  </log>
  <publishers>//发布版本
   <onsuccess>//成功，并生成有时间戳的目录
    <artifactspublisher dest="D:/CruiseControl/artifacts/${project.name}" file="projects/${project.name}/longcon-framework.jar" />
   </onsuccess>
   <onfailure>//失败发送邮件到响应的人员
    <htmlemail buildresultsurl="http://localhost:8080/cruisecontrol/buildresults/${project.name}" mailhost="邮件服务器" password="密码" username="用户名" defaultsuffix="@**.com.cn" returnname="PetClinic Continuous Integration" returnaddress="sunny@**.com.cn" charset="UTF-8" skipusers="true" xsldir="webapps/cruisecontrol/xsl" css="webapps/cruisecontrol/css/cruisecontrol.css">
     <always address="接收邮件方的邮箱" />
    </htmlemail>
   </onfailure>
  </publishers>
</project>
<project name="site">
  <listeners>
   <currentbuildstatuslistener file="logs/${project.name}/status.txt" />
  </listeners>

  <bootstrappers>
   <svnbootstrapper localWorkingCopy="projects/${project.name}" username="sunny" password="sunny" />
  </bootstrappers>
  <bootstrappers>
   <antbootstrapper anthome="apache-ant-1.7.0" buildfile="projects/${project.name}/build.xml" target="jar" />
  </bootstrappers>
        <modificationset>//设置只有framework工程成功了才执行此次的操作，体现了project的依赖关系
           <buildstatus logdir="logs/framework"/>
        </modificationset>
</project>
</cruisecontrol>

四 启动CC可以实现集成编译、集成构建、单元测试的功能，对于持续构建这是最简单不过了，要继续努力学习哦。

五 持续集成使用了一段时间发现了源代码目录总是不能自动更新，认真查找发现是因为自己对标签<svnbootstrapper>的理解不正确，现在就是在ant的build.xml中调用svn的提交命令来解决的，不知道思路是否正确，请大家指教。

下面就更清晰的介绍一下常用的标签把。

CC配置文件范connectfour范例Config.xml如下：

<cruisecontrol>
    <project name="connectfour">

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

        <bootstrappers>
            <antbootstrapper anthome="apache-ant-1.7.0" buildfile="projects/${project.name}/build.xml" target="clean" />
        </bootstrappers>

        <modificationset quietperiod="30">
            <!-- touch any file in connectfour project to trigger a build -->
            <filesystem folder="projects/${project.name}"/>
        </modificationset>

        <schedule interval="300">
            <ant anthome="apache-ant-1.7.0" buildfile="projects/${project.name}/build.xml"/>
        </schedule>

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

        <publishers>
            <onsuccess>
                <artifactspublisher dest="artifacts/${project.name}" file="projects/${project.name}/target/${project.name}.jar"/>
            </onsuccess>
        </publishers>

    </project>
</cruisecontrol>

<cruisecontrol>根元素是<cruisecontrol>，该元素很简单，没什么需要配置的属性。

目前CC支持多项目（multiproject），因此可以有多个并行的<project>元素。支持的子元素包括：
<project>
     <property/>
     <plugin/>
     <dateformat/>
     <labelincrementer/>
     <listeners>
        <cmsynergysessionmonitor/>
        <currentbuildstatusftplistener/>
        <currentbuildstatuslistener/>
        <currentbuildstatuspagelistener/>
        <lockfilelistener/>
      </listeners>
     <bootstrappers>
        <accurevbootstrapper/>
        <alienbrainbootstrapper/>
        <antbootstrapper/>
        <clearcasebootstrapper/>
        <clearcaseviewstrapper/>
        <cmsynergybootstrapper/>
        <currentbuildstatusbootstrapper/>
        <currentbuildstatusftpbootstrapper/>
        <cvsbootstrapper/>
        <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/>
      </schedule>
     <log>
        <merge/>
<gzip/>
<delete/>
      </log>
     <publishers>
        <antpublisher/>
        <artifactspublisher/>
        <clearcasebaselinepublisher/>
        <cmsynergybaselinepublisher/>
        <cmsynergytaskpublisher/>
        <compoundpublisher/>
        <currentbuildstatuspublisher/>
        <currentbuildstatusftppublisher/>
        <email/>
        <execute/>
        <ftppublisher/>
        <htmlemail/>
        <http>
        <jabber/>
        <onfailure/>
        <onsuccess/>
        <rss/>
        <sametimeannouncement/>
        <scp/>
        <sfeedocman/>
        <sfeefrs/>
        <sfeetracker/>
        <socket/>
        <weblog>
        <x10/>
        <xsltlogpublisher/>
        <yahoopublisher/>
      </publishers>
   </project>

子元素过多所以详情可以参看官方文档的说明。

这里只介绍几个常用的子元素：

<bootstrappers>:<bootstrappers>在创建之前会运行，相当于一个预处理的作用，<bootstrappers>下面每个子元素都是独立的，因此可以同时配置多个bootstrappers。

CC提供的bootstrappers包括两种，一种用于向其他插件提供项目当前创建的状态，还有一种是从某个源码控制系统更新本地文件，其中最常用的就是<currentbuildstatusbootstrapper>和<svnbootstrappers>。<currentbuildstatusbootstrapper>指定了状态文件的位置，主要是用来访问项目当前创建的状态，CC的<currentbuildstatusbootstrapper>会将创基爱你的状态写入这个文件。

<svnbootstrapper>的作用有点难理解，因为我们每次项目的创建都应该基于最新的代码，因此在创建之前就要获得最新的项目文件，如果使用的是ant来完成这个任务，那么buildfile本身在创建开始之前发生了变化，我们是不是应该先更新这个buildfile，然后才通过buildfile来对项目进行构建呢？<svnbootstrapper>就是为从源码控制系统更新buildfile文件而设计的（还有一种替代的使用方法是使用wrapper buildfile，这样就不用使用<svnbootstrapper>了，wrapper buildfile也是推荐的方法，<modificationset>部分会进行详细的讨论）。

<modificationset>:包括了SourceControl插件的配置信息，用于检查各个源码控制系统中是否发生变化，<schedule>会用到这里的配置信息，如果检测到变化，会触发创建过程。

<modificationset>的属性quietperiod（单位为秒）定义了一个时间值。如果CC检查到了变化，会自检查到变化的源码控制系统的最后一次check in 的时间开始等待，等待时间由quietperiod决定，等待结束之后才触发创建（build）过程，主要是防止有人在check in的过程当中就触发创建过程（可能check in只做了一半，这个时候触发创建显然是不正确的）.

下面是一个modificationset的例子：

<modificationset quietperiod="30">
            <svn localworkingcopy="projects/SFA"/>
</modificationset>