This documentation relates to an earlier version of Bamboo.
View

Unknown macro: {spacejump}

or visit the current documentation home.


A capability is a feature of an agent. A capability can be a:

  • builder (e.g. Maven)
  • JDK
  • custom capability (a key-value property which defines a particular characteristic of an agent, e.g. 'operating.system=WindowsXP' or 'fast.builds=true')
  • Perforce (location of the P4 client application, if Perforce is being used as the source repository)

Capabilities can be defined specifically for an agent, or they can be shared between either all local agents or 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).

How capabilities are used:

A requirement is an agent capability required by a build plan.

Together, capabilities and requirements control which agents can execute builds for particular plans. Each plan can only be built by agents whose capabilities meet the plan's requirements.

Matching can be specified as either a regular expression or an exact match. See Specifying a Plan's Capability Requirements.

To view an agent's capabilities,

  1. Click the  'Administration' link in the top navigation bar.
  2. Click the 'Agents' link in the left navigation column.
  3. The 'Agents' page will be displayed, showing lists of all Local Agents and Remote Agents in your Bamboo system. Click the name of the agent in which you are interested.
  4. The 'Agent' page will be displayed (see screenshot below), showing a list of all shared capabilities and agent-specific capabilities (if any exist) that apply to this agent in the 'Capabilities' tab. The capabilities will be grouped under the 'Agent-Specific Capabilities' and 'Shared Capabilities' sections, as follows:
  • 'Builder' — builder capabilities. This sub-section will only display, if you have builder capabilities defined.
  • 'JDK' — JDK capabilities. This sub-section will only display, if you have JDK capabilities defined.
  • 'Custom' — custom capabilities. This sub-section will only display, if you have custom capabilities defined.
  • 'Perforce' — perforce capability. This sub-section will only display, if you have a Perforce capability defined.

(info) To define a new capability, see Configuring Capabilities.


Screenshot: 'Agent Capabilities'



Log a request with our support team.



Raise an issue for our developers.



See answers from the community.



Tweet, blog and update our documentation.

Except where otherwise noted, content in this space is licensed under a Creative Commons Attribution 2.5 Australia License.