CruiseControl 安装 配置 教程 实例 搭建服务器 （CruiseControl + git/svn） 拂晓风起

去下载最新的安装包，在xp下的话，直接下载exe最好了~~

CruiseControl过程简单讲就是：按照config.xml的配置，定期对配置的项目进行更新，然后自动构建（这里就需要配置用什么来获取，CVS还是SVN等），并做好每次构建的记录。

CruiseControl持续集成环境的配置安装 

    第一步：

         A、从官方网站下载最新的稳定版本（最好下载exe版本，不用配置这么多变量）

         B、下载JAVA安装包

　　　C、 安装代码同步工具，SVN或Git等

   第二步：解压下载的工具包，并在你的环境变量中增加环境变量    

        A、JAVA_HOME设置为你的JAVA安装目录

        B、设置系统path变量（把JDK路径，SVN和Git路径加入path变量中，并使得Svn和Git等代码管理工具可命令行调用，Git还需要配置HOME，详细见本文最后）

   第三步：直接运行CC解压目录/安装目录下的cruisecontrol.bat即可

   第四步：在你的浏览器地址栏输入：http://localhost:8080/dashboard/tab/dashboard ，如果有界面表示安装成功

   第五步：关闭cruisecontrol.bat窗口。配置config.xml，加入project，见下边介绍。

   第六步：重新运行cruisecontrol.bat。

　　　　　　如果要改服务的端口，请修改安装目录下的cruisecontrol.bat。找到-jmxport 8000 -webport 8180 -rmiport 1099

　　　　　　webport就是网页版监视器的端口。另外CC的exe版本会在windows中加了服务，可以用msconfig去修改启动配置。

参考这个文章，理解CruiseControl目录的结构，例如projects。

http://www.cnblogs.com/xiaocheng/archive/2009/06/21/1507755.html

参考这个文章，进行配置（config.xml和projects里边的build.xml）：

http://shenzhenchufa.blog.51cto.com/730213/272575

关键是bootstrappers，设置每次schedule的build之前，该启动什么。

例如填<svnbootstrapper    localWorkingCopy="projects/${project.name}/ABC/" />，即是到localWorkingCopy目录下,执行svn -update命令来更新代码。也可以用其他的，例如Git。

然后是modificationset，具体参考上述的文章内的注释。

在config.xml中注明有什么项目，然后projects中对应放这个项目

（config.xml不配置svn信息或者其他代码同步工具的信息，初始化的时候，应该手工先在project目录中checkout那个svn项目，并设置保存密码）

具体请参考http://cruisecontrol.sourceforge.net/main/configxml.html（这里有对每个节点最官方的说明）

关于config文件，这里也有一个简单的例子：

http://www.blogjava.net/qimoxuer12/articles/270896.html

可能出现的问题：

1. 如果配置后发现无法启动，右击CruiseControl.bat编辑，在最后空白处，加一行pause。这样就可以看到出错信息了。

2. 如果项目文件无法自动更新。可能是svn等代码管理工具没有配置成命令行执行。

　　须确保在命令行下,svn可以使用。因为CC启动后,会通过svn -update去配置库上更新CC中的项目代码.  可以用svn --version测试是否在命令行模式下可使用。如果使用其他同步工具，例如Git，也一样，应该先在该目录尝试命令行方式获取最新代码。

　　这里就需要安装subversion并配置path了，也可以简单直接安装VisualSVN Server。毕竟CC的机器同时作为SVN服务器也不错。（有人说TortoiseSVN安装后没有命令行方式，对此我不清楚，我是直接把乌龟和VisualSVN Server都安装了，所以什么都不用配置。也许CC就自带了svn，所以可以一步一步来，先装CC，看能否用svn命令，不行再装乌龟，再不行。。。）

 　　关于SVN Server，见：http://www.cnblogs.com/kenkofox/archive/2010/10/17/1853525.html

关于CC + git，参考一下以下的配置，主要就是bootstrapper的配置了。同样先在project目录中clone出git的项目，之后CC会调用git命令行更新代码。

　　1.  启动CC后，可能会出现问题，可能会停在bootstrapping不动，参考了一篇文章说法，这是因为通过CC启动的git不能访问到SSH引起的。需要在系统变量中，添加HOME，设置为用户目录C:\Documents and Settings\XXXX。同时，还要在path中加入git的路径，让git能在CMD中使用（右击我的电脑，属性，高级，环境变量）

      2.  注意路径问题。localWorkingCopy指定的路径必须正好是Git项目的目录（内有“.git”隐藏目录）。因为Git的clone命令需要先指定一个空目录，所以这里需要注意一下，别指定为父目录。

      3.  ！！！初始化项目目录一定要用clone命令，不要用pull什么的。

<?xml version="1.0" encoding="UTF-8"?>
<cruisecontrol>
 
    <project name="your_project" buildafterfailed="false">
        <propertyfilelabelincrementer propertyfile="projects/${project.name}/source/build.number"
                                      propertyname="build.number"
                                      preBuildIncrementer="true" />
 
        <property file="projects/${project.name}/source/config.properties" />
 
        <listeners>
            <currentbuildstatuslistener file="logs/${project.name}/status.txt" />
        </listeners>
 
        <bootstrappers>
            <gitbootstrapper localWorkingCopy="projects/${project.name}/source" />
        </bootstrappers>
 
        <modificationset quietperiod="60">
            <git localWorkingCopy="projects/${project.name}/source/" />
        </modificationset>
 
        <schedule interval="60">
            <ant anthome="apache-ant-1.7.0"
                 buildfile="projects/${project.name}/source/build.xml"
                 target="dist">
                <property name="continuous-integration" value="true" />
            </ant>
        </schedule>
 
        <log dir="logs/${project.name}">
            <merge dir="projects/${project.name}/build/logs/"/>
        </log>
 
       ......
 
   </project>
 
</cruisecontrol>