Manage Your Build System
After you have configured your build system to meet your needs, you can monitor and manage it in several ways. Before you read this topic, you should first read Understanding a Team Foundation Build System.
To manage a build machine
When you click the Team Foundation Build node, information about the build machine appears in the content pane, including the name of its endpoint and the account under which Team Foundation Build Service is running. You can use the Team Foundation Build node to manage your build machine. The following table lists and explains some of the actions you can take.
Disable or Enable a Build Controller or Build Agent
You can disable and enable build controllers and build agents. This capability can help you tune or temporarily modify the way your build system works.
For example, you suspect that a build machine may be running too many build agents because builds are being processed too slowly. You can disable some build agents and assess how this affects performance. You can then later re-enable one or more build agents as necessary.
Note:-
If you disable a build agent that is running a build, the build agent will complete the build and then be unavailable after that build is completed.
Note:-
If you disable a build agent that is running a build, the build agent will complete the build and then be unavailable after that build is completed.
To disable or enable a build controller or build agent from a client machine
To disable or enable a build controller or build agent from the build machine
- Log on to the build machine that hosts the build controller or build agent that you want to modify.
- Click Start, click All Programs, click Microsoft Team Foundation Server 2010, and then click Team Foundation Administration Console.
- In the tree pane, expand the name of the server, and then click the Team Foundation Build node.
- Immediately under the name of the build controller or the build agent, click either the Disable link or the Enable link.
Restart a Build Controller or Build Agent
You can restart build controllers and build agents. When you restart a build agent, the build that it is processing is aborted. When you restart a build controller, all its running builds are aborted, including builds that its build agents are processing.
- build agent performs (such as compilation or running tests), you can restart the build agent.
- build controller performs (such as labeling files in version control), then you can restart the build controller.
To restart a build controller or build agent
- Log on to the build machine that hosts the build controller or build agent that you want to modify.
- Click Start, click All Programs, click Microsoft Team Foundation Server 2010, and then click Team Foundation Administration Console.
- In the tree pane, expand the name of the server, and then click the Team Foundation Build node.
- Immediately under the name of the build controller or the build agent, click Restart.
Modify the Properties of a Build Controller or Build Agent
You can use the Build Controller Properties dialog box or the Build Agent Properties dialog box to manage build controllers and build agents. You can display these dialog boxes on a client computer that is running Visual Studio or on the build machine by using the Team Foundation Administration Console.
In the Build Controller Properties and Build Agent Properties dialog boxes, you can view or change the display name and the description, in addition to other properties that affect how the build controller or build agent functions. For more information, see one of the following topics:
To display the properties dialog box on a client machine
To display the properties dialog box on the build machine
- Log on to the build machine that hosts the build controller or build agent that you want to modify.
- Click Start, click All Programs, click Microsoft Team Foundation Server 2010, and then click Team Foundation Administration Console.
- In the tree pane, expand the name of the server, and then click the Team Foundation Build node.
- Immediately under the name of the build controller or the build agent, click Properties.
Remove a Build Controller or Build Agent
When you no longer need a build controller or build agent, you can remove it.
To remove a build controller or build agent from a client machine
To remove a build controller or build agent from a build machine
- Log on to the build machine that hosts the build controller or build agent that you want to remove.
- Click Start, click All Programs, click Microsoft Team Foundation Server 2010, and then click Team Foundation Administration Console.
- In the tree pane, expand the name of the server, and then click the Team Foundation Build node.
No comments:
Post a Comment