A Bamboo agent is a service that can run job builds. There are the following types of Bamboo agents:
local agents run as part of the Bamboo server.
- remote agents run on computers, other than the Bamboo server, that run the remote agent tool.
- elastic agents run in the Amazon Elastic Compute Cloud (EC2).
Local agents run in the Bamboo server's process, i.e. in the same JVM as the server. Each remote agent runs in its own process, i.e. has its own JVM.
Each agent has a defined set of capabilities and can only run builds for jobs whose requirements match the agent's capabilities.
On this page:
Viewing an agent's details
To view an agent's details:
- Click the icon in the Bamboo header and choose Overview.
- Click Agents in the left panel to display the 'Agents' page, which lists all local and remote agents that currently exist in your Bamboo system.
- Click the name of the desired agent. The agent's page will be displayed.
Click one of the following tabs to see corresponding details for the agent:
Tab Description Capabilities Displays a list of all agent-specific and shared capabilities'. The capabilities in each of those sections are grouped into the following subsections: - Custom — custom capabilities.
- Executable — executable capabilities.
- JDK — JDK capabilities.
- Perforce, Mercurial, Git — VCS capability.
You'll only see a subsection if a capability of that type is defined in Bamboo. To define a new capability, see Configuring capabilities.
Executable jobs Displays a list of jobs, arranged by plan, that the agent can build. System properties Displays information about the agent. Audit logs Displays a record of changes that have been made to the agent.
Viewing the agents that can build jobs
To view which agents can build which jobs:
- Click the icon in the Bamboo header and choose Overview.
- Click Agent Matrix in the left navigation panel.
Editing an agent's name or description
To edit an agent's name or description:
- Navigate to the desired agent, as described above.
- Click Edit Details.
- Update the details for the agent.
- Click Save.