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