Build Configuration
Build Configuration represents a sequence of builds of the same "type", set of settings used to create a build. Examples of build configurations are build distribution, run integration tests, build release distribution, nightly build, deploy to QA.
You can explore details of a build configuration on its home page and modify its settings on the Creating and Editing Build Configurations. In this section:
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 Configuring 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 Viewing Your Changes page.
To pause or activate a build configuration do one of the following:
On the Build Configuration settings page click the Pause/Activate button.
Navigate to the Build Configuration Home Page, click Actions on the toolbar and select Pause build configuration/Activate build configuration from the drop-down.
Build Configuration Status
In general, build configuration status reflects the status of its last finished build.
Personal Build do not affect the build configuration state.
You can view the build configuration status on the Projects page or Project Home Page, when the details are collapsed.
Icon | Description |
|---|---|
| The last build executed successfully. |
| The last build with this build configuration executed with errors or one of the currently running builds is failing. The build configuration status will change to "failed" when there's at least one currently running and failing build, even if the last finished build was successful. |
| Indicates that someone has started investigating the problem, or already fixed it. (see Investigating Build Problems). |
no icon | There were no finished builds for this configuration, status is unknown. |
| The build configuration is paused; no builds are triggered for it. Click on the link next to the status to view by whom it was paused, and activate configuration, if needed. |
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=btXXXparameter (see picture below). ThebtXXXvalue is the value you search for.
