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)

機能は、エージェント固有として定義することも、すべてのローカル エージェントまたはすべてのリモート エージェント間で共有することもできます。エージェント固有の機能の値は、同じ名前の共有機能 (存在する場合) の値をオーバーライドします。

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.

注意

関連トピック

Configuring Capabilities