Luntbuild - 自动化构建与管理，用户手册

AccuRev 端口号的格式为<servername>:<port>，其中<servername> 和 <port> 应该用实际的AccuRev的服务器名和端口号代替。 该属性是可选的，该属性的值会覆盖acclient.cnf值。

在该目录下保存accurev的可执行文件 如果如果系统目录下没有包含accurev的可执行文件，那么应该放在 在该目录下。

从VCS check out代码来进行创建之前的等待周期(也就是多长时间没有用户check in)，以秒为单位。 这是为了避免在其他人正在做check in的过程中check out代码。 该属性为可选，如果该属性没有设置，那么在check out代码出来创建之前不会有等待周期。

Clearcase 服务器端视图存储的位置，该属性用于创建当前项目的Clearcase视图的stgloc选项值。 该属性和"Explicit path for view storage"只指定一个即可

只有"Clearcase view stgloc name"属性没有指定的时候该属性才需要。 如果指定了，那么创建当前项目的Clearcase视图的时候，该值将作为-vws选项值代替-stgloc选项

Config spec 用于创建Clearcase快照视图

如果在上述的Config spec下指定要获取某些分支下的最新版本，这个时候该属性有效。Luntbuild用 该属性来决定自上一次创建后资料库是否发生了改变。该属性包括了多种条目，每个条目的格式为 "<path>[:<branch>]" 其中<path>是VOB下的路径，该值对于上述的config spec是可见的。对于该目录下的任何子目录， Luntbuild会检查clearcase服务器端内容是否发生了变化。 如果<branch>指定了，那么Luntbuild将会检查指定的分支里的内容是否发生了变化。 多个条目可以通过";"符号或者多行来区分。

当您使用Luntbuild为当前项目创建有关的Clearcase快照视图的时候，可以执行mkview sub命令的命令行选项。 可以指定的命令行选项包括-tmode, -ptime, and -cachesize，例如您可以指定"-tmode insert_cr"，这样就使用 Windows的文本行终结符。

cleartool可执行文件所在的路径。如果在系统的路径下找不到cleartool的可执行文件，就会在 这里设置的目录下找。

在Luntbuild准备从VCS检出代码前，需要确保最近一次检入操作距离现在的最短时间(单位为秒)，在这段时间不能有新的检入操作。 这样是为了避免有其他用户正在做检入的过程中Luntbuild做检出的操作，从而导致捡出代码的不一致性。 该属性为可选属性，如果为空，Luntbuild就会立刻检出代码，并执行构建，而不会检测当前VCS中是否有正在进行的检入操作。

例如:pserver:administrator@localhost:d:/cvs_repository。 如果您的连接方式是ssh，请设置:ext:协议，并且要设置好ssh相应的环境，这些设置都在都在Luntbuild外进行。 详情参考cvs用户指南。

使用pserver协议来连接的CVS口令

该属性指要使用的cvs是否是cygwin下的cvs？ 可选的值为"yes"或"no"，默认值为"no"。

该选项用来设置log命令的"-S"选项是否禁止？ 可选的值为"yes"或"no"，默认值为"no"。 在log命令中使用-S选项可以加速对cvs代码库中发生变化的检测， 不过早期的cvs并不支持该选项。如果是早期的cvs版本，请输入"yes"来禁止该选项。

该属性用来设置在检测CVS代码库的变化的时候是否禁止history命令。 可选的值为"yes"或"no"，默认值为"no"。 和log命令一起使用history命令可以加速对cvs代码库中发生变化的检测， 但是，有些cvs代码库并没有保存commit的历史信息，这种情况下，应该使用"yes"来禁止该命令。

cvs可执行文件所在的路径。如果在系统路径下找不到cvs的可执行文件，就会在 这里设置的目录下找。

在Luntbuild准备从VCS检出代码前，需要确保最近一次检入操作距离现在的最短时间(单位为秒)，在这段时间不能有新的检入操作。 这样是为了避免有其他用户正在做检入的过程中Luntbuild做检出的操作，从而导致捡出代码的不一致性。 该属性为可选属性，如果为空，Luntbuild就会立刻检出代码，并执行构建，而不会检测当前VCS中是否有正在进行的检入操作。

该属性为可选属性。如果指定了，那么会以文件的修改时间为检测对象来检测源目录内容的变化。 所有检测到的已修改的文件将会复制到项目工作目录下，并在此基础上进行构建。

在Luntbuild准备从VCS检出代码前，需要确保最近一次检入操作距离现在的最短时间(单位为秒)，在这段时间不能有新的检入操作。 这样是为了避免有其他用户正在做检入的过程中Luntbuild做检出的操作，从而导致捡出代码的不一致性。 该属性为可选属性，如果为空，Luntbuild就会立刻检出代码，并执行构建，而不会检测当前VCS中是否有正在进行的检入操作。

Perfoce端口格式<port>, 或者 <servername>:<port>, 其中<servername> 和 <port> 将被实际的Perforce服务器名和端口代替。

在此指定访问Perfoce服务器的用户名。该用户应该有创建和修改客户端描述符(client specifications)的权限， 还应该有检出代码以及给代码打上标签的权限。

Perforce用户对应的口令。如果Perforce没有使用基于口令的安全机制，那么这里口令可以为空。

设置客户文本文件的行结束符。目前可设置的值如下：

该属性为可选属性。如果没有指定，那么默认值为"local"

P4可执行文件所在的路径。如果在系统的路径下找不到cvs的可执行文件，就会在 这里设置的目录下找。

在Luntbuild准备从VCS检出代码前，需要确保最近一次检入操作距离现在的最短时间(单位为秒)，在这段时间不能有新的检入操作。 这样是为了避免有其他用户正在做检入的过程中Luntbuild做检出的操作，从而导致捡出代码的不一致性。 该属性为可选属性，如果为空，Luntbuild就会立刻检出代码，并执行构建，而不会检测当前VCS中是否有正在进行的检入操作。

Subversion的“根”url，例如："svn://buildmachine.foobar.com/"或者"file:///c:/svn_repository" 或者"svn://buildmachine.foobar.com/myproject/othersubdirectory"，等等。 其他的例如标签的目录，分支的目录，模块等等都是相对于该“根”url的。

指定在上述根url下用于存放主分支代码(trunk)的目录。该目录是根url的相对目录。 如果在根url下没有定义任何trunk目录，那么该属性的值为空值。

指定在上述根url下用于存放分支代码的目录。该目录是根url的相对目录。 如果不设置该属性，那么Luntbuild将采用默认值，即"branches"。

指定在上述根url下用于存放标签的目录。该目录是根url的相对目录。 如果不设置该属性，那么Luntbuild将采用默认值，即"tags"。

登录Subversion的用户名。

登录Subversion的用户的口令。

svn可执行文件所在的路径。如果在系统的路径下找不到svn的可执行文件，就会在 这里设置的目录下找。

在Luntbuild准备从VCS检出代码前，需要确保最近一次检入操作距离现在的最短时间(单位为秒)，在这段时间不能有新的检入操作。 这样是为了避免有其他用户正在做检入的过程中Luntbuild做检出的操作，从而导致捡出代码的不一致性。 该属性为可选属性，如果为空，Luntbuild就会立刻检出代码，并执行构建，而不会检测当前VCS中是否有正在进行的检入操作。

在此指定Clearcase视图存储位置的名字，其值将作为创建Clearcase视图的stgloc选项的值。

在此指定项目vob的标签，例如\pvob1

如果"Clearcase view stgloc name" 属性的值为空，那么本属性的值就必须设置。 如果指定了本属性的值，其值作为创建Clearcase视图的-vws选项的值，并且会代替原来使用的-stgloc选项。

在此指定UCM流的名字。

指定在UCM流内部要构建的基线。如果要指定多个基线，那么中间用空格分开。 下面的值具有特殊的意义：

当"What to build"属性的值为"latest"时，本属性的值有效。 Luntbuild用该属性来决定自上一次创建后资料库是否发生了改变。该属性包括了多种条目，每个条目的格式为 "<path>[:<branch>]" 其中<path>是VOB下的路径，该值对于上述的config spec是可见的。对于该目录下的任何子目录， Luntbuild会检查clearcase服务器端内容是否发生了变化。 如果<branch>指定了，那么Luntbuild将会检查指定的分支里的内容是否发生了变化。 多个条目可以通过";"符号或者多行来区分。

在通过Luntbuild来创建当前项目有关的clearcase的快照视图的时候，您可以有选择性的指定mkview sub命令的扩展选项。 目前可以指定选项限定为-tmode, -ptime, 和 -cachesize。例如，您可以指定"-tmode insert_cr"，这样可以使用Windows 的行结束文本模式。

在此指定clearcase工具可执行文件所在路径，如果这些可执行文件不在系统路径下，就应该在此指定其所在的目录。

在Luntbuild准备从VCS检出代码前，需要确保最近一次检入操作距离现在的最短时间(单位为秒)，在这段时间不能有新的检入操作。 这样是为了避免有其他用户正在做检入的过程中Luntbuild做检出的操作，从而导致捡出代码的不一致性。 该属性为可选属性，如果为空，Luntbuild就会立刻检出代码，并执行构建，而不会检测当前VCS中是否有正在进行的检入操作。

该目录是srcsafe.ini文件所在目录。例如：\\machine1\directory1 这个路径名要么用主机名要么用主机的ip地址，而且要确保运行应用服务器或者servlet容器的帐号事先已经登录 到这台机器上，否则在构建时Luntbuild会汇报一个“No VSS database found”的错误。

登录该VSS的用户名。

上面指定的用户的口令。

指定VSS的history命令的日期时间格式。该属性为可选属性，如果该属性的值为空，那么Luntbuild将使用 默认值"M/dd/yy;h:mm:ssa"。 默认值只适合使用US的英文操作系统。 对于其他的使用英语的国家，例如英国，澳大利亚，加拿大，VSS使用的时间格式为(假设VSS的本地语言已经设置为相应的值)：

		'd/M/yy;H:mm'
        

如果Luntbuild运行的操作系统为非英文的操作系统，可以通过以下方法决定使用的日期时间格式：

打开安装在您的构建服务器上的VSS，选择一个现有的VSS数据库，然后查看里面的项目和文件。 在文件列表框里面有几栏，其中一栏是"Date-Time"。可以使用这个位置相应的"datetime format"(日期时间格式)。 例如，如果其中一个的值为 "04-07-18 20:19"，那么相应的"datetime format"(日期时间格式)为 "yy-MM-dd;HH:mm" 注意在日期和时间之间的semicolon(分号)一定要指定。 在这里鼓励大家将该属性设置为"yy-MM-dd;HH:mm:ss"，这样可以提高精确度。 例如，如果VSS里面的日期时间为"7/18/04 8:19p"，那么相应的"datetime format"(日期时间格式) 为"M/dd/yy;h:mma"。 这个时候如果设置为 "M/dd/yy;h:mm:ssa"，那么可以增加准确性。

下面是从JDK文档中节选的部分格式化字符的信息：

详情参考 http://java.sun.com/j2se/1.4.2/docs/api/java/text/SimpleDateFormat.html

在此指定ss.exe文件所在的路径，如果ss.exe文件不在系统路径下面，Luntbuild就会使用这个属性的值作为寻找该ss.exe 文件的目录。

在Luntbuild准备从VCS检出代码前，需要确保最近一次检入操作距离现在的最短时间(单位为秒)，在这段时间不能有新的检入操作。 这样是为了避免有其他用户正在做检入的过程中Luntbuild做检出的操作，从而导致捡出代码的不一致性。 该属性为可选属性，如果为空，Luntbuild就会立刻检出代码，并执行构建，而不会检测当前VCS中是否有正在进行的检入操作。

StarTeam项目的位置，格式<servername>:<portnum>/<projectname>， 其中<servername>是StarTeam服务器名字，<portnum>是服务器使用的端口号，默认值49201。 <projectname>是运行在StarTeam服务器上的StarTeam的项目名。

登录StarTeam服务器的用户名。

登录StarTeam服务器的口令。

该属性可选的值如下：

all: 所有ASCII码文件将其行结束符调整为和检出的客户机的行结束符一致。

no: 检出的文件的行结束符以服务器为准。

该属性为可选属性。如果没有指定，默认值为yes。

在Luntbuild准备从VCS检出代码前，需要确保最近一次检入操作距离现在的最短时间(单位为秒)，在这段时间不能有新的检入操作。 这样是为了避免有其他用户正在做检入的过程中Luntbuild做检出的操作，从而导致捡出代码的不一致性。 该属性为可选属性，如果为空，Luntbuild就会立刻检出代码，并执行构建，而不会检测当前VCS中是否有正在进行的检入操作。

标签在AccuRev里面是用于同步的事务编号。在此指定您希望基于哪个事务编号进行构建。

用于检出代码 Accurev储存位置。

构建模块的回溯流的名字。 The backing stream should be able to have streams created from it by the build user.

指定同回溯流关联的构建流名称 (如果该构建流 存在，它将被自动创建)。 基于这个流，一个相关的引用树将会被创建(树的名称为流的名称加上"_reference"后缀)。

指定从CVS代码库中获取代码的路径，例如：testcvs/src

指定前面的源路径的分支。该选项是可选的。如果没有设置相应的值，那么将把主分支作为默认值。

指定前面的源路径的标签。该选项也是可选的。 如果指定了该值，那么该值将优先于分支的值。如果没有设置相应的值，就会检出上述指定分支里面的最新代码。

指定Perforce存储位置的路径，例如"//depot/testperforce/...".

指定前面的存储位置路径上的标签。该属性是可选的。 如果为空，那么将会检出该存储路径上最新的版本。

指定客户端的路径，例如"//myclient/testperforce/...".

即Subversion代码库中的路径，例如"testsvn", "testsvn/web", 或者 "/testsvn"。 当"branch"(分支) 或者 "label"(标签)属性指定的时候，本路径会映射到svn代码库的另一个路径。

指定以上源路径的分支。该属性为可选项，如果不设置，那么将使用默认值trunk。

指定以上源路径的标签。该属性为可选的。如果设置了该属性，其优先级高于分支。如果不设置，就采用指定分支的head version。

该属性为可选的。目标路径相对于项目的工作目录，如果设置了相应的值，那么从subversion代码库中获取的代码将保存在该目录下。 否则将会在项目的工作目录下创建一个以源路径命名的目录，从subversion获取的代码将保存在该目录下。

Luntbuild从ulr"svn://localhost/trunk/testsvn/web"下检出代码， 并保存在"<project work directory>/testsvn/web"下面。

Luntbuild从ulr "svn://localhost/branches/simplified-chinese/testsvn/web"下检出代码， 并保存在"<project work directory>/testsvn/web"下面。

Luntbuild从ulr "svn://localhost/tags/v1_0/testsvn/web"下检出代码， 并保存在"<project work directory>/testsvn/web"下面。

Luntbuild从ulr "svn://localhost/tags/v1_0/testsvn/web" 下检出代码， 并保存在"<project work directory>/testsvn/web/simplified-chinese"下面。

在此指定在VSS代码库中的路径，例如"testvss", 或者"/testvss".

在此指定上面设置的源路径上的标签，该属性为可选的，如果为空，就使用最新的版本。

指定相对于项目工作目录的目标目录，从源目录下获取的代码就保存在这个目录下。 该属性为可选的，如果该属性为空，Luntbuild会在项目工作目录下建一个和源目录的目录结构一致的目录， 并将检出的代码保存在这个目录下。

在此指定StarTeam视图。该属性为可选属性。如果为空，Luntbuild使用当前的StarTeam项目的根view。

在此指定相对于StarTeam视图的路径。"/"代表根路径。

指定以上StarTeam视图的标签。该属性为可选属性。如果为空，就以指定视图上的最新代码为准。

指定相对于项目工作目录的目标目录，从源目录下获取的代码就保存在这个目录下。 该属性为可选的，如果该属性为空，Luntbuild会在项目工作目录下建一个和源目录的目录结构一致的目录， 并将检出的代码保存在这个目录下。

提供一个用于标识该builder的名称，该名称以后可以修改。

指定运行Ant的命令(通常是ant.bat或者ant的shell文件及其所在的目录) 例如：/path/to/ant 包含在${...}里面的字符串被当作是OGNL表达式，而且在构建前被替换成实际值。 每个OGNL表达式都需要有一个对应的JAVA根对象来对表达式求值(通过反射机制)，这里的根对象就是当前的Builder对象。

您可以修改Ant命令以添加命令行选项和属性，例如-Ddebug=_debug.

Ant的构建脚本文件(buildfile)所在的路径，如果该目录非绝对路径，Luntbuild认为该目录是相对项目工作目录的。

指定需要构建的目标，使用空格来分隔不同的目标(包括空格符的目标名需要用引号括起来，这样是为了避免被当成是多个目标来处理)。 如果没有指定目标，那么将使用ant构建文件的默认目标。 同样地，您可以使用OGNL表达式(${...})来传递变量，该变量作为构建的目标名。 例如，您可以使用${build.schedule.name}变量，该变量的作用是可以根据不同的构建计划使用不同的构建目标。 每个OGNL表达式都需要有一个对应的JAVA根对象来对表达式求值(通过反射机制)，这里的根对象就是当前的Builder对象。

在此定义需要传递给ant构建脚本的属性，例如：

每一行只能设置一个变量。这里支持使用OGNL表达式格式，即${...}。 每个OGNL表达式都需要有一个对应的JAVA根对象来对表达式求值(通过反射机制)，这里的根对象就是当前的Builder对象。

设置运行builder的环境变量，例如：

每一行只能设置一个变量。可以在变量里插入OGNL表达式(即${...})。 每个OGNL表达式都需要有一个对应的JAVA根对象来对表达式求值(通过反射机制)，这里的根对象就是当前的Builder对象。

构建成功条件式是一个用来判断当前项目是否成功构建的OGNL表达式 每个OGNL表达式都需要有一个对应的JAVA根对象来对表达式求值(通过反射机制)，这里的根对象就是当前的Builder对象。 如果不设置该属性，那么会使用默认值————result==0 and logContainsLine("BUILD SUCCESSFUL")。 当这个表达式的值为true的时候，就认为本次构建是成功的。 下面的一些例子演示了OGNL表达式的格式。

builder的标识名，设置后可以修改。

在此指定构建命令。例如：/path/to/command.bat "${build.version}" "${build.artifactsDir}"。 ${...}所包括的部分被当作是OGNL表达式来处理，在构建前会被实际值代替。 每个OGNL表达式都需要有一个对应的JAVA根对象来对表达式求值(通过反射机制)，这里的根对象就是当前的Builder对象。

用于运行构建命令的目录。如果该目录非绝对路径，Luntbuild认为该目录是相对项目工作目录的。

在构建前需要先设置环境变量，例如：

MYAPP_HOME=${build.schedule.workingDir}

SCHEDULE_NAME=${build.schedule.name}

每行只能指定一个环境变量。OGNL表达式可以嵌入在变量的值里面，OGNL表达式需要用${...}括起来。 每个OGNL表达式都需要有一个对应的JAVA根对象来对表达式求值(通过反射机制)，这里的根对象就是当前的Builder对象。

构建成功条件式是一个用来判断当前项目是否成功构建的OGNL表达式 每个OGNL表达式都需要有一个对应的JAVA根对象来对表达式求值(通过反射机制)，这里的根对象就是当前的Builder对象。 如果不设置该属性，那么会使用默认值————result==0 and logContainsLine("BUILD SUCCESSFUL")。 当这个表达式的值为true的时候，就认为本次构建是成功的。

提供一个用于标识该builder的名称，该名称以后可以修改。

指定运行Maven的命令(一般来说是maven.bat，或者maven的shell脚本)。 例如：/path/to/maven。 ${...}中间的部分是OGNL表达式，在命令执行前会计算出该表达式的值。 每个OGNL表达式都需要有一个对应的JAVA根对象来对表达式求值(通过反射机制)，这里的根对象就是当前的Builder对象。

        
		<project>
		...
		<!--Use value of variable "buildVersion" as current version, this variable is defined in Luntbuild's Maven
		builder configuration page-->
		<currentVersion>${buildVersion}</currentVersion>
		...
		</project>
        
			

指定要在哪个目录下运行Maven。如果该目录非绝对路径，Luntbuild认为该目录是相对项目工作目录的。

指定要构建的目标。如果要指定多个目标，请用空格来分开多个目标(带空格的目标应该使用引号括起来，否则会被当作是多个目标来处理。) 在目标名字里面可以使用${...}，${...}中间的部分会被当作是OGNL表达式来处理。 例如，您可以使用${build.schedule.name}，该表达式可以根据不同的目标使用不同的构建计划。 每个OGNL表达式都需要有一个对应的JAVA根对象来对表达式求值(通过反射机制)，这里的根对象就是当前的Builder对象。

定义传递给maven构建脚本的属性值。例如：

每一行只能设置一个变量。也可以在变量中使用OGNL表达式，OGNL表达式需要用${...}括起来。 每个OGNL表达式都需要有一个对应的JAVA根对象来对表达式求值(通过反射机制)，这里的根对象就是当前的Builder对象。

在这里设置构建的时候要使用的环境变量。例如：

MYAPP_HOME=${build.schedule.workingDir}

SCHEDULE_NAME=${build.schedule.name}

每一行只能设置一个变量。也可以在变量中使用OGNL表达式，OGNL表达式需要用${...}括起来。 每个OGNL表达式都需要有一个对应的JAVA根对象来对表达式求值(通过反射机制)，这里的根对象就是当前的Builder对象。

构建成功条件式是一个用来判断当前项目是否成功构建的OGNL表达式 每个OGNL表达式都需要有一个对应的JAVA根对象来对表达式求值(通过反射机制)，这里的根对象就是当前的Builder对象。 如果不设置该属性，那么会使用默认值————result==0 和 logContainsLine("BUILD SUCCESSFUL")。 当这个表达式的值为true的时候，就认为本次构建是成功的。

拥有该角色的用户代表了root用户。拥有“站点管理员”角色的用户可以访问所有的Luntbuild的功能，没有任何限制。下面是"站点管理员"有权执行的所有任务：

拥有该角色的用户具有项目管理的所有功能。下面是"项目管理员"有权执行的所有任务：

拥有该角色的用户只能管理项目构建有关的任务。下面是"项目构建者"有权执行的所有任务：

这个角色是最受限制的角色，下面是"项目参与者"有权执行的所有任务：