Branch Remote Run Trigger
The branch remote run trigger automatically starts a new personal build each time TeamCity detects changes in particular branches of the VCS roots of the build configuration. Finished personal builds are listed in the build history, but only for the users who initiated them.
At the moment, the branch remote run trigger supports only Git and Mercurial VCSs.
For non-personal builds off branches, see Working with Feature Branches. When a branch specification is configured for a VCS root, the branch remote run trigger only processes branches not matched by the specification.
A trigger monitors branches with names that match specific patterns.
Default patterns are:
for Git repositories:
for Mercurial repositories:
These branches are regular version control branches and TeamCity does not manage them (that is if you no longer need the branch, you would need to delete the branch using regular version control methods).
By default, TeamCity triggers a personal build for the user detected in the last commit of the branch. You might also specify a TeamCity user in the name of the branch. To do that, use a placeholder
TEAMCITY_USERNAME in the pattern and your TeamCity username in the name of the branch. For example, the pattern
remote-run/TEAMCITY_USERNAME/* will match a branch
remote-run/joe/my_feature and start a personal build for the TeamCity user
joe (if such user exists).
To be able to trigger, a build branch should have at least one new commit comparing to the main branch.
Example: Run a personal build from a command line
With the default pattern (
git branch -r command will list your personal branches. If you want to hide them, change the pattern to
refs/remote-run/* and push your changes to branches like
refs/remote-run/my_feature. In this case your branches are not listed by the above command, although you can see them anyway using
git ls-remote <url_of_git_repository>.
If your build configuration has more than one VCS root which support branch remote run, and you push changes to all of them, TeamCity will start one personal build with changes per each VCS root.