Set build triggers

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 wildcards.

For example, you want to include master and most, but not all, of your feature branches.

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

Q&A

Can I automatically build pull requests? How do I protect my Git master branch from code that fails to build?

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 create TFVC gated builds?

Not yet.

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 run your build.

  • Hosted agent pool might be your easiest option if your code is built on Windows and your code is on Visual Studio Team Services.

  • Deploy Windows agents to build Windows, Azure, and other Visual Studio solutions. Windows agents can also build Java and Android apps.

  • Deploy Xplat agents to build Xcode, Android, Java, or other kinds of apps

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

See Scale out and administer your build system: Manage your 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