Viewing a Bamboo agent's details
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)
- Ephemeral agents are a short-lived remote agents that start on-demand inside a Kubernetes cluster to carry out a single build or deployment before being shut down.
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:
- In the upper-right corner of the screen, selectAdministration> Overview.
- From the sidebar, under Build resources, select Agents.
- Select the name of the desired agent. The agent's page will be displayed.
Select one of the following tabs to see the corresponding details for the agent:
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:
- In the upper-right corner of the screen, selectAdministration> Overview.
- From the sidebar, under Build resources, select Agent matrix.
Editing an agent's name or description
To edit an agent's name or description:
- In the upper-right corner of the screen, selectAdministration> Overview.
- From the sidebar, under Build resources, select Agents.
- Next to an agent, select Edit details.
- Update the details for the agent.
- Select Save.