Bamboo 3.4 : Editing a Capability

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

  • an executable (e.g. Maven)
  • a JDK
  • a custom capability (a key-value property which defines a particular characteristic of an agent, e.g. 'operating.system=WindowsXP' or 'fast.builds=true')
  • a Version Control System client application (e.g. Git, if Git 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.

Editing an Agent-Specific Capability

To edit an agent-specific capability:

  1. Navigate to the desired agent, as described on Viewing an Agent.
  2. Click Edit for a capability.
  3. Depending on what type of capability you are editing, you will be able to modify the following values:
    • If you are editing an Executable capability, you can modify Path for the executable.
    • If you are editing a JDK capability, you can modify Java Home for the JDK.
    • If you are editing a Custom capability, you can modify Value for the capability.
    • If you are editing a Version Control capability, you can modify Path for the capability.

Editing a Local Server Capability

To edit a local server capability:

  1. Click Administration in the top navigation bar.
  2. Click the Server Capabilities in the left navigation panel.
  3. Click Edit for the capability.
  4. Depending on what type of capability you are editing, you will be able to modify the following values:
    • If you are editing an Executable capability, you can modify Path for the executable.
    • If you are editing a JDK capability, you can modify Java Home for the JDK.
    • If you are editing a Custom capability, you can modify Value for the capability.
    • If you are editing a Version Control capability, you can modify Path for the capability.

Editing a Shared Remote Capability

To edit a shared remote capability:

  1. Click Administration in the top navigation bar.
  2. Click Agents in the left navigation panel.
  3. Click Shared Remote Capabilities in the top right of the 'Remote Agents' section.
  4. Click Edit for the capability.
  5. Depending on what type of capability you are editing, you will be able to modify the following values:
    • If you are editing an Executable capability, you can modify Path for the executable.
    • If you are editing a JDK capability, you can modify Java Home for the JDK.
    • If you are editing a Custom capability, you can modify Value for the capability.
    • If you are editing a Version Control capability, you can modify Path for the capability.

Notes

Related Topics

Configuring Capabilities