This documentation is archived and is not being maintained.

Working with Build Definitions in Team Foundation Build

This topic describes how to create and modify build definitions in Team Foundation Build.

Team Foundation Build uses build definitions to manage the conditions under which a single solution or a set of solutions will be built. You can use the Build Definition dialog box to create and modify build definitions. You have the following configuration options:

  • Workspace

    Use this setting to map the source control location of the files you want to build on the build agent. Each path is mapped to a relative location beneath a root build directory on the build agent.

  • Project File

    Either use this setting to browse to an existing TFSBuild.proj file in source control or use it to create a new one to be associated with the build definition. If two or more build definitions share a TFSBuild.proj file, customizing it effects each build definition.

    If you create a new TFSBuild.proj file you can specify which files to build, whether to run tests or code coverage, and which configuration or platform to build.

  • Retention Policy

    Use this setting to specify the retention policy for failed, stopped, partially-successful, or fully-successful builds.

  • Build Defaults

    Use this setting to specify the build agent, the computer on which the build runs, and the shared folder where the built files are stored.

  • Trigger

    Use this setting to specify:

    • Whether your build definition should run on demand

    • Whether your build definition should run continuously on each check-in

    • Whether each check-in should add a build to the queue to be run as soon as an agent is free

How to: Create a Build Definition

Describes the steps used to create and configure a new build definition for Team Foundation Build.

How to: Run Continuous Builds

Describes how to configure Team Foundation Build to run continuous builds.

How to: Configure the Builds Check-in Policy for Continuous Builds

Explains how to define the Builds check-in policy for your team project.

How to: Configure Tests with Build Definitions

Explains how to modify build definitions and projects to take advantage of the testing capabilities in Team Foundation Build.

Testing Web Sites and Web Services in a Team Environment

Provides additional information about working with tests in Team Foundation Build.

How to: Establish Permissions for Team Foundation Build Agent

Describes how to establish permissions for the Team Foundation build agent to run builds.

How to: Edit a Build Definition

Explains how to edit a build definition.

How to: Update Build Definitions on Branched Team Projects

Explains how to edit build definitions in a newly established branch so they build correctly.

How to: Delete a Build Definition

Describes how to delete a build definition that is no longer needed.

How to: Stop an In-Progress Build

Describes how to stop a build that is already in progress.

How to: Delete a Completed Build

Describes how to use the Build Explorer user interface to delete a completed build.

Walkthrough: Creating and Building a C++ Project in Team Foundation Build

Describes how to create and build a C++ project with Team Foundation Build.

Running Builds in Team Foundation Build

Lists topics that describe how to run builds in Team Foundation Build, including standard, local, and scheduled builds.

Understanding the Team Foundation Build Explorer

Explains the functionality of the Build Explorer and lists topics that describe how to view, interpret, and modify build definition status and build reports generated by a build definition in Team Foundation Build.

Team Foundation Build Walkthroughs

Lists walkthroughs that explore creating team foundation build definitions, running build definitions, and viewing build reports.

Administering Team Foundation Build

Lists topics for administrators of Team Foundation Build.