Compass Version1.1

TOC

Build Configurations

Each build plan consists of two parts. The build steps that are executed and a build configuration. On the build editor page, the build steps are listed first and the next section after the build steps is the build configuration and it looks like this:

The build configuration has 6 options which are detailed in the following table:

Build Plan Configuration Option	Description
Files to save	The 'Files to save' option lets the build plan creator specify which files are to be saved with every run of this build plan. The value for files can be a list of files and/or directory paths, separated by semi-colons (e.g., "lib/output.lib;bin"). The paths are relative from the root directory of the build. When a build succeeds, Output files can be downloaded from the build results screen.
Compress saved output files	With the 'Compress saved output files' box checked, the output files specified in the 'Files to save' list will be compressed using the site-wide setting for compression type (zip, tar.gz, tar.bz)
Configurations	The 'Configurations' option is a list of configurations available for this project. Every time a build is scheduled and run, Compass will attempt to run the build plan on every configuration specified here.
Build incrementally	When the 'Build incrementally' box is checked, Compass will retain the same directory structure and files from run to run. In the details section of each step in the build plan you can specify if the step should be executed on only the first run, only subsequent runs, or on every run. Incremental builds help reduce the load on the repository server, reduce the amount of time builds take to execute in Compass, and reduce overall network traffic.
Delete intermediate build files	Compass will delete the build directory after a build completes as long as the 'Delete intermediate build files' checkbox is checked. This should only be disabled temporarily to debug failing builds.
Action for missing build clients	The 'Action for missing build clients' option allows build plan creators to select the action to be taken if no build client is available when a build is scheduled. There are 3 options: 1) Cancel build immediately - when a build client is not available for a given configurations, if this option is selected the build will immediately be reported as failed and be marked as aborted in the build results view. 2) Cancel after 15 minutes - same result as with the first option, except that Compass will wait 15 minutes instead of aborting the build 15 minutes to see if a client connects to the server. 3) Wait for Client - this option will make Compass wait forever for a client with the given configuration to connect.