[CruiseControl]在Windows上配置实例

一 CruiseControl安装

1) 安装JAVA SDK，设置JAVA_HOME环境变量，且将%JAVA_HOME%\bin加入path环境变量。

2) 下载CruiseControl，例如2.8.3版本为cruisecontrol-bin-2.8.3.zip，解压到C:\CruiseControl。

3)  CruiseControl的binary安装中已经包含了ant builder / jetty（提供http server and jmx 对webapps下的cruisecontrol[result/report JSP page] 和 dashboard支持） ,安装后如下：

 

二 配置

以CruiseControl自带实例connectfour为例，配置文件如下：

1）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>

2）dashboard-config.xml

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

 <dashboard>
     <buildloop
        logsdir=""
              artifactsdir="" />
    <features allowforcebuild=""/>
    <trackingtool projectname="" baseurl="" keywords=""/>
     <subtabs>
        <subtab class="net.sourceforge.cruisecontrol.dashboard.widgets.ErrorsAndWarningsMessagesWidget" />
    </subtabs>
</dashboard>

三 运行

1) 运行CruiseControl.bat来启动CruiseControl，

REM CruiseControl.bat

REM Set this if you're using SSH-based CVS
REM set CVS_RSH=

REM Uncomment the following line if you have OutOfMemoryError errors
REM set CC_OPTS=-Xms128m -Xmx256m

REM The root of the CruiseControl directory.  The key requirement is that this is the parent
REM directory of CruiseControl's lib and dist directories.
REM By default assume they are using the batch file from the local directory.
REM Acknowledgments to Ant Project for this batch file incantation
REM %~dp0 is name of current script under NT
set CCDIR=%~dp0

:checkJava
if not defined JAVA_HOME goto noJavaHome
set JAVA_PATH="%JAVA_HOME%\bin\java"
set CRUISE_PATH=%JAVA_HOME%\lib\tools.jar
goto setCruise

:noJavaHome
echo WARNING: You have not set the JAVA_HOME environment variable. Any tasks relying on the tools.jar file (such as "<javac>") will not work properly.
set JAVA_PATH=java

:setCruise
set LIBDIR=%CCDIR%lib

set LAUNCHER=%LIBDIR%\cruisecontrol-launcher.jar

set JETTY_LOGS=%CCIDR%logs

set EXEC=%JAVA_PATH% %CC_OPTS% -Djavax.management.builder.initial=mx4j.server.MX4JMBeanServerBuilder "-Djetty.logs=%JETTY_LOGS%" 
-jar "%LAUNCHER%" %* -jmxport 8000 -webport 8080 -rmiport 1099
echo %EXEC%
%EXEC%

2) CruiseControl的启动log

2010-07-19 04:42:51,712 [main     ] INFO  Main             - CruiseControl Version 2.8.3 Compiled on January 24 2010 2134
2010-07-19 04:42:51,805 [main     ] INFO  XMLConfigManager - reading settings from config file [C:\CruiseControl\config.xml]
2010-07-19 04:42:52,446 [main     ] INFO  CruiseControlController - projectName = [connectfour]
2010-07-19 04:42:52,446 [main     ] INFO  XMLConfigManager - using settings from config file [C:\CruiseControl\config.xml]
2010-07-19 04:42:52,477 [main     ] WARN  ProjectConfig    - No previously serialized project found [C:\CruiseControl\connectfour.ser], forcing a build.
2010-07-19 04:42:52,477 [main     ] INFO  Project          - Project connectfour starting
2010-07-19 04:42:52,477 [main     ] INFO  Project          - Project connectfour:  idle
2010-07-19 04:42:52,509 [Project connectfour thread] INFO  Project          - Project connectfour started
2010-07-19 04:42:52,540 [Project connectfour thread] INFO  Project          - Project connectfour:  in build queue
2010-07-19 04:42:53,665 [main     ] INFO  CruiseControlControllerAgent - Starting HttpAdaptor with CC-Stylesheets
2010-07-19 04:42:53,743 [main     ] INFO  CruiseControlControllerAgent - starting httpAdaptor
2010-07-19 04:42:54,071 [main     ] INFO  CruiseControlControllerAgent - starting rmiRegistry
2010-07-19 04:42:56,384 [main     ] INFO  CruiseControlControllerAgent - starting connectorServer
2010-07-19 04:43:18,555 [BuildQueueThread] INFO  BuildQueue       - BuildQueue started
2010-07-19 04:43:18,555 [BuildQueueThread] INFO  BuildQueue       - now adding to the thread queue: connectfour
2010-07-19 04:43:18,618 [Thread-21] INFO  Project          - Project connectfour:  bootstrapping
2010-07-19 04:43:18,665 [Thread-21] INFO  ProjectController - connectfour Controller: build progress event: bootstrapping
2010-07-19 04:43:23,102 [Thread-23] INFO  ScriptRunner     - Buildfile: projects\connectfour\build.xml
2010-07-19 04:43:23,321 [Thread-23] INFO  ScriptRunner     - 
2010-07-19 04:43:23,321 [Thread-23] INFO  ScriptRunner     - clean:
2010-07-19 04:43:23,462 [Thread-23] INFO  ScriptRunner     -    [delete] Deleting directory C:\CruiseControl\projects\connectfour\target
2010-07-19 04:43:23,993 [Thread-23] INFO  ScriptRunner     - 
2010-07-19 04:43:23,993 [Thread-23] INFO  ScriptRunner     - BUILD SUCCESSFUL
2010-07-19 04:43:23,993 [Thread-23] INFO  ScriptRunner     - Total time: 0 seconds
2010-07-19 04:43:24,196 [Thread-21] INFO  AntBootstrapper  - Bootstrap successful.
2010-07-19 04:43:24,212 [Thread-21] INFO  Project          - Project connectfour:  checking for modifications
2010-07-19 04:43:24,212 [Thread-21] INFO  ProjectController - connectfour Controller: build progress event: checking for modifications
2010-07-19 04:43:24,509 [Thread-21] INFO  Project          - Project connectfour:  No modifications found, build not necessary.
2010-07-19 04:43:24,509 [Thread-21] INFO  Project          - Project connectfour:  Building anyway, since build was explicitly forced.
2010-07-19 04:43:24,509 [Thread-21] INFO  Project          - Project connectfour:  now building
2010-07-19 04:43:24,509 [Thread-21] INFO  ProjectController - connectfour Controller: build progress event: now building
2010-07-19 04:43:25,305 [Thread-25] INFO  ScriptRunner     - Buildfile: projects\connectfour\build.xml
2010-07-19 04:43:25,540 [Thread-25] INFO  ScriptRunner     - ccAntProgress -- clean
2010-07-19 04:43:25,602 [Thread-25] INFO  ScriptRunner     - ccAntProgress -- compile
2010-07-19 04:43:25,665 [Thread-25] INFO  ScriptRunner     -     [mkdir] Created dir: C:\CruiseControl\projects\connectfour\target\classes
2010-07-19 04:43:26,446 [Thread-25] INFO  ScriptRunner     -     [javac] Compiling 10 source files to C:\CruiseControl\projects\connectfour\target\classes
2010-07-19 04:43:34,118 [Thread-25] INFO  ScriptRunner     - ccAntProgress -- sleep
2010-07-19 04:43:34,149 [Thread-25] INFO  ScriptRunner     -      [echo] Sleeping for a while so you can see the build in the new dashboard
2010-07-19 04:44:34,805 [Thread-25] INFO  ScriptRunner     - ccAntProgress -- test
2010-07-19 04:44:35,555 [Thread-25] INFO  ScriptRunner     -     [mkdir] Created dir: C:\CruiseControl\projects\connectfour\target\test-classes
2010-07-19 04:44:40,290 [Thread-25] INFO  ScriptRunner     -     [javac] Compiling 2 source files to C:\CruiseControl\projects\connectfour\target\test-classes
2010-07-19 04:45:08,384 [Thread-25] INFO  ScriptRunner     -     [mkdir] Created dir: C:\CruiseControl\projects\connectfour\target\test-results
2010-07-19 04:45:10,243 [Thread-25] INFO  ScriptRunner     -     [junit] Running net.sourceforge.cruisecontrol.sampleproject.connectfour.CellTest
2010-07-19 04:45:10,243 [Thread-25] INFO  ScriptRunner     -     [junit] Testsuite: net.sourceforge.cruisecontrol.sampleproject.connectfour.CellTest
2010-07-19 04:45:14,196 [Thread-25] INFO  ScriptRunner     -     [junit] Tests run: 1, Failures: 0, Errors: 0, Time elapsed: 3.953 sec
2010-07-19 04:45:14,196 [Thread-25] INFO  ScriptRunner     -     [junit] Tests run: 1, Failures: 0, Errors: 0, Time elapsed: 3.953 sec
2010-07-19 04:45:14,212 [Thread-25] INFO  ScriptRunner     -     [junit] 
2010-07-19 04:45:14,805 [Thread-25] INFO  ScriptRunner     -     [junit] Running net.sourceforge.cruisecontrol.sampleproject.connectfour.PlayingStandTest
2010-07-19 04:45:14,805 [Thread-25] INFO  ScriptRunner     -     [junit] Testsuite: net.sourceforge.cruisecontrol.sampleproject.connectfour.PlayingStandTest
2010-07-19 04:45:14,837 [Thread-25] INFO  ScriptRunner     -     [junit] Tests run: 10, Failures: 0, Errors: 0, Time elapsed: 0.032 sec
2010-07-19 04:45:14,837 [Thread-25] INFO  ScriptRunner     -     [junit] Tests run: 10, Failures: 0, Errors: 0, Time elapsed: 0.032 sec
2010-07-19 04:45:14,837 [Thread-25] INFO  ScriptRunner     -     [junit] 
2010-07-19 04:45:14,852 [Thread-25] INFO  ScriptRunner     - ccAntProgress -- jar
2010-07-19 04:45:15,149 [Thread-25] INFO  ScriptRunner     -       [jar] Building jar: C:\CruiseControl\projects\connectfour\target\connectfour.jar
2010-07-19 04:45:15,430 [Thread-25] INFO  ScriptRunner     - ccAntProgress -- all
2010-07-19 04:45:15,430 [Thread-25] INFO  ScriptRunner     - 
2010-07-19 04:45:15,446 [Thread-25] INFO  ScriptRunner     - BUILD SUCCESSFUL
2010-07-19 04:45:15,446 [Thread-25] INFO  ScriptRunner     - Total time: 1 minute 49 seconds
2010-07-19 04:45:16,259 [Thread-21] INFO  ProjectController - connectfour Controller: build result event: build successful
2010-07-19 04:45:16,259 [Thread-21] INFO  Project          - Project connectfour:  merging accumulated log files
2010-07-19 04:45:16,274 [Thread-21] INFO  ProjectController - connectfour Controller: build progress event: merging accumulated log files
2010-07-19 04:45:16,415 [Thread-21] INFO  Project          - Project connectfour:  build successful
2010-07-19 04:45:16,493 [Thread-21] INFO  Project          - Project connectfour:  publishing build results
2010-07-19 04:45:16,493 [Thread-21] INFO  ProjectController - connectfour Controller: build progress event: publishing build results
2010-07-19 04:45:17,009 [Thread-21] INFO  Project          - Project connectfour:  idle
2010-07-19 04:45:17,009 [Thread-21] INFO  ProjectController - connectfour Controller: build progress event: idle
2010-07-19 04:45:17,087 [Project connectfour thread] INFO  Project          - Project connectfour:  next build in 5 minutes 
2010-07-19 04:45:17,087 [Project connectfour thread] INFO  Project          - Project connectfour:  waiting for next time to build
2010-07-19 04:45:17,087 [Project connectfour thread] INFO  ProjectController - connectfour Controller: build progress event: waiting for next time to build

3）connectfour的ant的log

Buildfile: projects\connectfour\build.xml
ccAntProgress -- clean
ccAntProgress -- compile
    [mkdir] Created dir: C:\CruiseControl\projects\connectfour\target\classes
    [javac] Compiling 10 source files to C:\CruiseControl\projects\connectfour\target\classes
ccAntProgress -- sleep
     [echo] Sleeping for a while so you can see the build in the new dashboard
ccAntProgress -- test
    [mkdir] Created dir: C:\CruiseControl\projects\connectfour\target\test-classes
    [javac] Compiling 2 source files to C:\CruiseControl\projects\connectfour\target\test-classes
    [mkdir] Created dir: C:\CruiseControl\projects\connectfour\target\test-results
    [junit] Running net.sourceforge.cruisecontrol.sampleproject.connectfour.CellTest
    [junit] Testsuite: net.sourceforge.cruisecontrol.sampleproject.connectfour.CellTest
    [junit] Tests run: 1, Failures: 0, Errors: 0, Time elapsed: 3.953 sec
    [junit] Tests run: 1, Failures: 0, Errors: 0, Time elapsed: 3.953 sec
    [junit] 
    [junit] Running net.sourceforge.cruisecontrol.sampleproject.connectfour.PlayingStandTest
    [junit] Testsuite: net.sourceforge.cruisecontrol.sampleproject.connectfour.PlayingStandTest
    [junit] Tests run: 10, Failures: 0, Errors: 0, Time elapsed: 0.032 sec
    [junit] Tests run: 10, Failures: 0, Errors: 0, Time elapsed: 0.032 sec
    [junit] 
ccAntProgress -- jar
      [jar] Building jar: C:\CruiseControl\projects\connectfour\target\connectfour.jar
ccAntProgress -- all

BUILD SUCCESSFUL
Total time: 1 minute 49 seconds

4）build后通过curisecontrol page（report JSP）查看结果

 

5）build后通过dashborad来查看结果

 

6）build后通过dashboard的build tab来查看build统计

 

7）通过JMX来管理

 

完！