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>
posted @ 2010-10-13 22:09  拂晓风起-Kenko  阅读(4566)  评论(0编辑  收藏  举报