Run, Monitor, and Manage Builds

After you have set up your build system and defined your build processes, you are ready use Team Foundation Build to compile your code, run your tests, and perform many other important functions.

In this topic

  • Manage your builds in Team Explorer

  • Manage and queue your build definitions

  • Manage queued, running, and completed builds

  • Manage your build system and security

Manage your builds in Team Explorer

Required Permissions

To perform this procedure, your View builds, View build definition, and View build resources permissions must be set to Allow. For more information, see Team Foundation Server Permissions.

To view the Builds page in Team Explorer

  1. If you're not already connected to the team project that you want to work in, then connect to the team project.

  2. Choose Home iconHome, and then choose Builds IconBuilds.

Team Explorer Builds page

Manage queued, running, and completed builds

Step 1My Builds displays builds that you have manually queued or that have been automatically queued for you, for example, as the result of a gated check-in process, in the past seven days. My Builds shows all queued or running builds in this time frame, as well as the last five completed builds. In this section, you can open the shortcut menu of a build request or a running build and then choose:

  • Open—Displays the build request window for a build request or the build results window for a running or completed build. For a completed build, you can choose Open in Browser to display the build results in your web browser.

  • Set Priority—Modifies the priority of a build request.

  • Postpone—Suspends a build request that you do not want the system to run. You can then choose Resume when you are ready for the build system to run it.

  • Cancel—Cancels a build request or choose Stop to stop a running build.

  • View Changeset—Displays the changesets associated with a build request or a completed build.

  • Edit Build Definition—Opens the build definition so that you can:

    • Modify the build definition.

    • Enable, pause, or disable the build definition.

  • View Controller Queue—Displays all builds that are queued to be processed by the same controller as the selected build in the Build Explorer window.

  • Retain Indefinitely—Overrides the retention policy of the build definition and retains the selected completed build.

  • Delete—Deletes a completed build.

  • Retry BuildQueue the build using the same options and parameters you specified for the completed build.

  • Refresh—Refreshes the Build page.

Manage and queue your build definitions

Step 3All Build Definitions displays all build definitions in the team project to which you are currently connected. You can drag build definitions from this list into Step 2My Favorite Build Definitions to get better visibility and access to the build processes that are most relevant to your work.

In the My Favorite Build Definitions and All Build Definitions sections, you can open the shortcut menu of a build definition and then choose:

  • View Builds—Displays builds of this build definition that were completed today in the Build Explorer window.

  • Queue New Build—Queues a build.

  • Edit Build Definition—Opens the build definition so that you can:

    • Modify the build definition.

    • Enable, pause, or disable the build definition.

  • Open Process File Location—Opens the version control folder that contains the build process template for this build definition in Source Control Explorer. For more information, see Create and Work with a Custom Build Process Template.

  • View Controller Queue—Displays all builds that are queued to be processed by the same controller as the selected build definition in the Build Explorer window.

  • Delete—Deletes the build definition.

Tip

The My Favorite Build Definitions list is shared with the Build Notifications application and is stored on your development client computer, so the list may differ across your various development computers. For more information on the Build Notifications application, see Receive Build Notifications.

Manage your build system and security

You can open the Step 4Actions menu and then choose:

  • Manage Queue—Displays the Build Explorer window. You can also choose View My Builds to display the Build Explorer window filtered to show completed builds you have recently requested or triggered, for example, by checking in a file in a folder encompassed by a Continuous Integration build.

  • Manage Build Controllers—Manages build controllers and agents. For more information about build controllers, see Deploy and Configure Build Agents.

  • Add or Remove Build Quality Values—Modifies the list of build qualities from which your team can select values to manually apply to completed builds.

  • Security—Opens your web browser to manage build-level permissions such as Edit build definition and Manage build queue for the team project collection. For more information, see Team Foundation Server Permissions.