Configuring Build Triggers
Once a build configuration is created, builds can be triggered manually by clicking the Run button 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: click Add new trigger and specify the trigger settings. For configuration details on each trigger, refer to the corresponding sections. It is possible to disable a configured build trigger temporarily or permanently using the option in the last column of the trigger list.
For each build configuration the following triggers can be configured:
VCS trigger: the build is triggered when changes are detected in the version control system roots attached to the build configuration.
GitHub Checks Webhook Trigger: the build is triggered for every single commit pushed to the source GitHub repository. In addition, posts detailed build result info on a GitHub page without a Commit Status Publisher configured.
Schedule trigger: the build is triggered at a specified time.
Finish build trigger: the build is triggered after a build of the selected configuration is finished.
Maven artifact dependency trigger: the build is triggered if there is a content modification of the specified Maven artifact which is detected by the checksum change.
Maven snapshot dependency trigger: 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 last build failed or failed to start.
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 package update detected in the NuGet repository.
Perforce shelve trigger: starts a build on a change in shelved Perforce files.
You can also manage build triggers using TeamCity REST API.