Configure QuickBuild repository

QuickBuild repository is used to check out artifacts from other QuickBuild configurations (may resides in a different build machine). Here is the list of properties for this repository:

Remote QuickBuild URL

Specify servlet URL for the QuickBuild system you want to retrieve artifacts from. For example, "http://another-server:8080/app.do". If not specified, it will default to current QuickBuild system.

Configuration

Specify configuration of the above QuickBuild system, for example: "root.project1.release". This configuration and the following build property will uniquely identify the build where you want to retrieve artifacts from.

Build

Specify version of the build from which you want to retrieve artifacts from, for example: "myproduct-1.0.0". If not specified, latest build will be assumed. Meaning of some special build version is listed as below:

<latest build>

Triggers destination configuration and then check out artifacts from latest build from specified configuration.

<last build>

Check out artifacts from last build of specified configuration. Last build is the latest build that has been finished.

<last successful build>

Check out artifacts from last successful build of specified configuration.

User to login

Specify user name to login to the specified QuickBuild system. It should have the permission to view the above configuration. If you are trying to retrieve artifacts of the latest build, you should have build permission for that configuration, because it will be triggered to generate a new build if necessary. If this property is not specified, anonymous user will be assumed.

Password

Specify password of the above user.

Quiet period

Number of seconds current repository should be quiet (without checkins) before QuickBuild decides to check out the code from this repository for a build. This is used to avoid checking out code in the middle of some other checkins. This property is optional. When set as 0, quiet period will not be used before checking out code to build.

Login mapping

Choose login mapping for this repository. Login mapping is used to map repository login to QuickBuild user. It can be configured at "login mappings" tab of the configuration.

Modules

Here are list of properties should be configured in order to define a QuickBuild module:

Source path

Specify source path to retrieve artifacts from. This path is relative to artifacts directory of specified build above. So "." will refer to the artifacts directory itself.

File name patterns

Specify file name patterns of artifacts to retrieve, for example: *.zip, ${build.version}*.zip, ${build.version}.*. Multiple patterns can be specified as long as they are seperated by spaces(Of course, a single pattern includes spaces should be quoted). If left empty, all files will be retrieved.

Retrieve recursively

Whether or not to retrieve matched artifacts recursively under specified source path.

Destination path

Specify the directory relative to the checkouts directory of current configuration, where the matching artifacts under the specified source path should be retrieved to. If left empty, retrieved code will be put into directory defined by the source path relative to the checkouts directory.