Build Configuration

Build Configuration describes a class of builds of a particular type, or a procedure used to create builds. Examples of build configurations are integration builds, release builds, nightly builds, and others.

You can explore details of a build configuration in its Build Configuration Home Page and modify its settings in the Create Edit Build Configuration.

Build Configuration State

A build configuration is characterized with its state which can be paused or active. By default, when created, all configurations are active.

If a build configuration is paused, its Build Trigger are disabled until the configuration is activated. Still, you can start a build of a paused configuration manually or automatically as a part of a build chain. Besides, information on paused build configurations is not displayed on the My Changes page.

To pause or activate a build configuration:

1. Navigate to:

• Create Edit Build Configuration page

• Current status field of the Overview of the Build Configuration Home Page

or click Actions link on the Build Configuration Home Page toolbar.

1. On the Actions drop-down list, choose Pause build configuration.

2. Enter optional comment in the dialog and click Pause.

   

Build Configuration ID

Each build configuration has its unique identifier buildConfigurationID=buildTypeID; the ID has the bt<ID> format.

The ID is mostly used for internal purposes. For example, build history and statistics are stored or cleaned up using buildTypeID but in some cases build configuration ID is needed for such operations as:

• publishing build configuration status via external widget

• configuring custom chart

• configuring dependencies

To determine the buildTypeID value:

• Navigate to the build configuration home page and in page URL, find the buildTypeID=bt<ID> pair of parameters (see picture below). The bt<ID> value is the value you search for.