Bamboo 3.4 : Renaming 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.

Renaming an Agent-Specific Capability

To rename an agent-specific capability:

  1. Navigate to the desired agent, as described in 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 'View' corresponding to the agent-specific capability you wish to rename.
  4. The 'View Capability' page will display. Click the 'Rename Capability' link.
  5. The 'Rename Capability' page will display. Update the 'Key' and click 'Rename Capability'.

Renaming a Local Server Capability

To rename 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 'View' corresponding to the agent-specific capability you wish to rename.
  5. The 'View Capability' page will display. Click the 'Rename Capability' link.
  6. The 'Rename Capability' page will display. Update the 'Key' and click 'Rename Capability'.

Renaming a Shared Remote Capability

To rename 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. The 'Agents' page will display, showing lists of all Local Agents and Remote Agents in your Bamboo system.
  4. Click the 'Shared Remote Capabilities' link in the top right of the 'Remote Agents' section.
  5. The 'Shared Remote Capabilities' screen will display, showing a list of all shared remote capabilities currently defined in your Bamboo system.
  6. Click the 'View' corresponding to the agent-specific capability you wish to rename.
  7. The 'View Capability' page will display. Click the 'Rename Capability' link.
  8. The 'Rename Capability' page will display. Update the 'Key' and click 'Rename Capability'.

Screenshot above: Renaming a custom capability

Attachments: