Configuring Build Triggers

Once a build configuration is created, builds can be triggered manually by clicking the Triggering a Custom Build or initiated automatically with the help of Triggers.

A build trigger is a rule which initiates a new build on certain events. The build is put into the Build Queue and is started when there are agents available to run it.

While creating/editing a build configuration, you can configure triggers using the Triggers sections of the Build Configuration Settings page by clicking Add new trigger and specifying the trigger settings. For configuration details on each trigger, refer to the corresponding sections.

For each build configuration the following triggers can be configured:

• Configuring VCS Triggers: the build is triggered when changes are detected in the version control system roots attached to the build configuration.

• Configuring Schedule Triggers: the build is triggered at a specified time.

• Configuring Finish Build Trigger: the build is triggered after a build of the selected configuration is finished.

• Configuring Maven Triggers: the build is triggered if there is a content modification of the specified Maven artifact which is detected by the checksum change.

• Configuring Maven Triggers: the build is triggered if there is a modification of the snapshot dependency content in the remote repository which is detected by the checksum change.

• Retry build trigger: the build is triggered if the previous build failed after specified time delay.

• Branch Remote Run Trigger: personal build is triggered automatically each time TeamCity detects new changes in particular branches of the VCS roots of the build configuration. Supports Git and Mercurial.

• NuGet Dependency Trigger: starts a build if there is a NuGet packages update detected in NuGet repository.

In addition to the triggers defined for the build configuration, you can also trigger a build by an Accessing Server by HTTP, or manually by running a custom build.