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).

See Configuring Capabilities for more information.

Because each agent can only run builds for Jobs whose requirements are met by the agent's capabilities (see Configuring a Job's Requirements), modifying a capability may mean that some plans can no longer be built.

The instructions on this page do not describe how to rename a capability. If you want to rename a capability, see Renaming a Capability.

On this page:

Editing an Agent-Specific Capability

To edit an agent-specific capability:

  1. Navigate to the desired agent, as described on Viewing an Agent.
  2. The 'Agent Capabilities' screen will be display, showing a list of shared capabilities and agent-specific capabilities for your chosen agent.
  3. Click the 'Edit' corresponding to the agent-specific capability you wish to edit.
  4. The 'Edit Capability' page will display. Depending on what type of capability you are editing, you will be able to modify the following values:
    • If you are editing a Builder capability, you can modify the 'Path' of the builder.
    • If you are editing a JDK capability, you can modify the 'Java Home' of the JDK.
    • If you are editing a Custom capability, you can modify the 'Value' of the capability>
    • If you are editing a Perforce capability, you can modify the 'Perforce Executable' path.

Editing a Local Server Capability

To edit a local server capability:

  1. Click the 'Administration' link in the top navigation bar.
  2. Click the 'Server Capabilities' link in the left navigation column.
  3. The 'Server Capabilities' page will display, showing a list of all local server capabilities currently defined in your Bamboo system.
  4. Click the 'Edit' link corresponding to the capability you wish to edit.
  5. The 'Edit Capability' page will display. Depending on what type of capability you are editing, you will be able to modify the following values:
    • If you are editing a Builder capability, you can modify the 'Path' of the builder.
    • If you are editing a JDK capability, you can modify the 'Java Home' of the JDK.
    • If you are editing a Custom capability, you can modify the 'Value' of the capability.
    • If you are editing a Perforce capability, you can modify the 'Perforce Executable' path.

Editing a Shared Remote Capability

To edit a shared remote capability:

  1. Click the 'Administration' link in the top navigation bar.
  2. Click the 'Agents' link in the left navigation column.
  3. Click the 'Shared Remote Capabilities' link in the top right of the 'Remote Agents' section.
  4. The 'Shared Remote Capabilities' screen will display, showing a list of all shared remote capabilities currently defined in your Bamboo system.
  5. Click the 'Edit' link corresponding to the capability you wish to edit.
  6. The 'Edit Capability' page will display. Depending on what type of capability you are editing, you will be able to modify the following values:
    • If you are editing a Builder capability, you can modify the 'Path' of the builder.
    • If you are editing a JDK capability, you can modify the 'Java Home' of the JDK.
    • If you are editing a Custom capability, you can modify the 'Value' of the capability.
    • If you are editing a Perforce capability, you can modify the 'Perforce Executable' path.

Notes

Related Topics

Configuring Capabilities



Log a request with our support team.



Raise an issue for our developers.



See answers from the community.



Blog and update our documentation.

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