Build Configuration

Skip to end of metadata
Go to start of metadata
You are viewing documentation of TeamCity 4.x, which is not the most recent released version of TeamCity. Please refer to the listing to choose another version.
Search

Searching TeamCity 4.x Documentation

Table of Contents

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 home page and modify its settings in the editing page.

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 automatic build triggers 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:

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 charts
  • 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.



See Also:

Labels:

build build Delete
configuration configuration Delete
pause pause Delete
activate activate Delete
state state Delete
status status Delete
Enter labels to add to this page:
Wait Image 
Looking for a label? Just start typing.