Build Agent
A build agent is a computer capable of running a build. Each build agent possesses a number of predefined parameters that make it compatible for creating certain builds. Build agents are joined into a build grid.
In TeamCity build agents can be authorized/unauthorized, enabled/disabled, and connected/disconnected.
| Status |
Description |
| Connected |
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 |
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 an agent is connected to the server for the first time is unauthorized 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 |
Agents are manually enabled/disabled via the web UI. The TeamCity server only distributes builds to agents that are enabled. 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. |
When a new agent is registered on the server for the first time, it will be unauthorized by default.
All agents connected to the server must have unique agent name.
Only users with certain roles can manage agents. See Permission for more information.
See also: