Configuring agents
A Bamboo agent is a service that can run job builds. There are the following types of Bamboo agents:
- 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.
Each remote agent runs in its own process (that is, has its own JVM) and has a defined set of capabilities. The latter means that an agent can only run builds for jobs whose requirements match the agent's capabilities.
For information about elastic or ephemeral agents, see:
Creating a new agent
To create a new agent, see Creating a remote agent.
Configuring an agent's capabilities
A capability is a feature of an agent. A capability can be defined on an agent for:
- an executable (e.g. Maven)
- a JDK
- a Version Control System client application (e.g. Git)
- a custom capability. This is a key-value property which defines a particular characteristic of an agent (e.g. 'operating.system=WindowsXP' or 'fast.builds=true').
Capabilities typically define the path to an executable that has already been installed, and must be defined in Bamboo before Bamboo or its agents can make use of those.
Capabilities can be defined specifically for an agent, or they can be shared between all remote agents. Note that the value of an agent-specific capability overrides the value of a shared capability of the same name (if one exists).
To configure an existing agent's capabilities, see:
- Configuring capabilities through the Bamboo web interface
- Configuring remote agent capabilities using bamboo-capabilities.properties
Disabling or deleting an agent
To disable or delete an agent, see Disabling or deleting an agent.