Table of contents
TOC
Collapse the table of content
Expand the table of content

Set build triggers

Last Updated: 8/4/2016

Team Services | TFS 2015 | Previous versions (XAML builds)

Definition edit panel header
Build      Options      Repository      Variables      Triggers      General      Retention      History

On the Triggers tab you specify the events that will trigger the build. You can use the same build definition for both CI and scheduled builds.

Continuous integration (CI)

Select this trigger if you want the build to run whenever someone checks in code.

Note: This trigger is not available if you've selected External Git as your repository.

Batch changes

Select this check box if you have a lot of team members uploading changes often and you want to reduce the number of builds you are running. If you select this option, when a build is running, the system waits until the build is completed and then queues another build of all changes that have not yet been built.

If you are using batched changes, you can also specify a maximum number of concurrent builds per branch.

Git Filters

If your repository is Git, GitHub, or External Git, then you can also specify:

  • The branches where you want to trigger builds. You can use wildcard characters.

  • Path filters to reduce the set of files that you want to trigger a build.

For example, you want to include master and most, but not all, of your feature branches. You also want to exclude files in the tools folder.

ci trigger git branches

TFVC Include

Select the version control paths you want to include and exclude. In most cases, you should make sure that these filters are consistent with your TFVC mappings on the Repository tab.

Subversion polling interval

See Visual Studio Team Services Java: Subversion.

Scheduled

Select the days and times when you want to run the build.

If your repository is Git, GitHub, or External Git, then you can also specify branches to include and exclude. You can use wildcards.

Example: Nightly build of Git repo in multiple time zones

scheduled trigger multiple time zones

Example: Nightly build with different frequencies

scheduled trigger different frequencies

TFVC gated check-in

If your code is in a Team Foundation version control (TFVC) repo, use gated check-in to protect against breaking changes.

Gated check-in trigger

How it affects your developers

When a developers try to check-in, they are prompted to build their changes.

Gated check-in prompt

The system then creates a shelveset and builds it.

For details on the gated check-in experience, see Check in to a folder that is controlled by a gated check-in build process.

Option to run CI builds

By default, CI builds are not run after the gated check-in process is complete and the changes are checked in.

However, if you do want CI builds to run after a gated check-in, select the Run CI triggers for committed changes checkbox. When you do this, the build process does not add ***NO_CI**\* to the changeset description. As a result, CI builds that are affected by the check-in are run.

A few other things to know

  • Make sure the folders you include in your trigger are also included in your mappings on the Repository tab.

  • You can run gated builds on either the hosted pool or a windows agent. You cannot run them on the cross-platform agent.

Q&A

How do I protect my Git codebase from build breaks?

If your code is in a Git repo on Visual Studio Team Services or Team Foundation Server, you can create a branch policy that runs your build. See Improve code quality with branch policies. This option is not available for GitHub repos.

Can I use the CI trigger with an External Git repo?

No

Can I chain builds so that one build triggers another?

Not yet.

Do I need a build agent?

You need at least one agent to run your build. Get an agent.

I can't select a default agent queue and I can't queue my build. How do I fix this?

See Administer queues.

I use Team Foundation Server on-premises and I don't see some of these features. Why not?

Some of these features are available only on Visual Studio Team Services and not yet available on-premises. Some features are available on-premises if you have upgraded to the latest version of TFS.

Where is the Visual Studio 2013 XAML build documentation?

Visual Studio 2013 XAML build documentation

© 2016 Microsoft