Configuring Finish Build Trigger

The Finish build trigger triggers a build of the current build configuration when a build of the selected build configuration is finished. If the Trigger after successful build only checkbox is enabled, a build is triggered only after a successful build of the selected configuration.

To monitor builds in other build configurations and trigger a build if these builds change, please see this option of the Schedule build trigger.

In most of the cases the Finish Build Trigger should be used with snapshot dependencies, i.e. the current build configuration where the trigger is defined should have a direct or an indirect snapshot dependency on the build configuration selected in the trigger. If there is no snapshot dependency, the following limitations exist:

it is likely that a build of the build configuration being triggered will not have the same revisions as the finished build even if both configurations have the same VCS settings
if a build configuration with the Finish Build Trigger has an artifact dependency on the last finished build of the build configuration specified in the trigger settings, there is no guarantee that artifacts of a build which caused build triggering will be used, because, while the triggered build sits in the build queue, another build may finish
the build triggered by the Finish Build Trigger will always be triggered in the default branch even if the finished build has some other branch

All these limitations do not apply if a build configuration with "Finish build trigger" has a snapshot dependency on the selected build configuration. In this case the trigger will run build on the same revisions and will attach the build to the chain. It will also use consistent artifacts if they are produced by dependencies.

Branch Filter

If the build configuration selected in the Finish Build Trigger uses Feature branches, you can enable the branch filter to limit the branches where finished builds will trigger new builds of the current configuration.

The Branch filter setting limits a set of logical branch names according to specified rules. Branch filter has the following format:

+:logical branch name
-:logical branch name

Where logical branch name is a part of branch name matched by branch specification (i.e. displayed for a build in TeamCity UI), see Working With Feature Branches. Wildcard character ('*') can also be used.

Examples: Only default branch is accepted:

+:<default>

All branches except default are accepted:

+:*
-:<default>

Only branches with with feature- prefix are accepted:

+:feature-*

By default, the branch filter in the Finish Build Trigger is set to accept only the default branch (+:<default>), which is also the equivalent of the empty branch filter.

Last modified: 20 April 2023