|You are viewing documentation of TeamCity 7.x, which is not the most recently released version of TeamCity. Please refer to the listing to choose another version.|
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).
An Agent typically checks out the source code, downloads artifacts of other builds and runs the build process. Number of agents basically limits the number of parallel builds and environments in which your build processes are run.
TeamCity server monitors all the connected agents and assigns queued builds to the agents based on compatibility requirements.
If there are several idle agents that can run a build TeamCity tries to select the fastest one based on the builds history.
In TeamCity, a build agent can have following statuses:
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.
TeamCity agent is upgraded automatically when necessary. The process involves downloading new agent files from the TeamCity server and restarting the agent on new files. In order to successfully accomplish this, the user under which agent runs should have enough permissions.
Typically, an agent upgrade happens on: