Build Agent

Skip to end of metadata
Go to start of metadata
You are viewing documentation of TeamCity 4.x, which is not the most recent released version of TeamCity. Please refer to the listing to choose another version.
Search

Searching TeamCity 4.x Documentation

Table of Contents

A TeamCity Build Agent is a piece of software that actually executes a build process. It is installed and configured separately from the TeamCity server. An agent can be installed on the same computer as the server or on a different machine (the latter is a preferred setup for server performance reasons).

TeamCity server monitors all the connected agents and assigns queued builds to the agents based on compatibility requirements.

To create a build, TeamCity tries to select the fastest agent based on the history of builds of a build configuration which ran on the particular agent. As the available build runners depend on environment where agent is running, TeamCity chooses an agent having required a build runner.

In TeamCity, a build agent can have following statuses:

Status Description
Connected/ Disconnected An agent is connected if it is registered on the TeamCity server and responds to server commands, otherwise it is disconnected. This status is determined automatically.
Authorized/ Unauthorized Agents are manually authorized via the web UI. Only authorized build agents can run builds. The number of simultaneously authorized agents cannot exceed the number of agent licenses in your license pool. When an agent is unauthorized, a license is freed and a different build agent can be authorized. Purchase additional licenses to expand the number of agents that can concurrently run builds. When a new agent is registered on the server for the first time, it is unauthorized by default and requires manual authorization to run the builds.
If a build agent is installed and running on the same computer as TeamCity build server, it is authorized automatically.
Enabled/ Disabled Agents are manually enabled/disabled via the web UI. The TeamCity server only distributes builds to agents that are enabled.
Agent disabling does not affect (stop) the build which is currently running on the agent.

Disabled agents can still run builds, however they must be assigned to them manually. This feature is generally used to temporarily remove agents from the build grid when they consistently have problems during the build process.

All agents connected to the server must have unique agent name.

Only users with certain roles can manage agents. See Role and Permission for more information.

For a build agent configuration please refer to Build Agent Configuration section.



See Also:

Labels:

build build Delete
agent agent Delete
authorized authorized Delete
unauthorized unauthorized Delete
enabled enabled Delete
connected connected Delete
disconnected disconnected Delete
disabled disabled Delete
license license Delete
Enter labels to add to this page:
Wait Image 
Looking for a label? Just start typing.