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 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:

Navigate to:

Build Configuration settings page
Current status field of the Overview tab of the Build Configuration Home Page

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

On the Actions drop-down list, choose Pause build configuration.
Enter optional comment in the dialog and click Pause.

Build Configuration ID

Each build configuration has an internal unique identifier which you may need when constructing TeamCity URLs or editing TeamCity configuration manually.

Automatically assigned IDs use bt<NUMBER> format.

To determine the internal ID of a build configuration:

Navigate to the build configuration home page and in page URL, find the buildTypeID=btXXX parameter (see picture below). The btXXX value is the value you search for.

See Also:

Concepts: Build Trigger | Build Configuration Status
UI Reference: Create/Edit Build Configuration | Build Configuration Home Page

Build Configuration

Build Configuration State

Build Configuration ID

Labels: