TeamCity 9.0 Help

History Build

A History Build is a build that starts after a build with more recent changes. That is, a history build is a build that disrupts normal builds flow according to the order of the source revisions.

A build may become a history build in the following situations:

  • If you initiate a build on particular changes manually using the Triggering a Custom Build dialog.

  • If you have a Configuring VCS Triggers with a quiet period set. During this quiet period a different user can start a build with more recent changes. In this case, your automatically triggered build will have an older source revision when it starts, and will be marked as a history build.

  • If there are several builds of the same configuration in the build queue and they have fixed revisions (e.g. they are part of a Build Chain). If someone manually re-orders these builds, the build with fewer changes can be started first.

As the history build does not reflect the current state of the sources, the following restrictions apply to its processing:

  • The status of a history build does not affect the project/build configuration status.

  • A user does not get notifications about history builds unless they subscribed to notifications on all builds in the build configuration.

  • History builds are not shown on the Projects or Build Configuration > Overview page as the last finished build of a configuration.

  • The Investigating and Muting Build Problems option is not available for history builds.

Last modified: 20 April 2023