Bamboo 4.4 : Configuring a shared custom capability

Custom capabilities can be used to control which jobs will be built by a particular agent. For example, if the builds for a particular job should only run in a Windows environment, you could create a custom capability 'operating.system=WindowsXP' for the appropriate agent(s), and specify it as a requirement for this job. (See Configuring a job's requirements.)

Shared capabilities are inherited by all applicable agents, that is, (shared) local server capabilities are inherited by all local agents, and shared remote capabilities are inherited by all remote agents. Note, however, that the value of a shared capability will be overridden by the value of an agent-specific capability of the same name (if one exists).

Configuring a new local server custom capability

Local server capabilities are inherited by all local agents.

To configure a new local server custom capability:

  1. Click Administration in the top navigation bar.
  2. Click Server Capabilities in the left navigation panel (under 'Build Resources').
  3. Locate the 'Add Capability' section at the bottom of the screen (see screenshot below).
  4. Choose Capability Type > Custom.
  5. Specify values for Key and Value.
  6. Click Add.

Configuring a new shared remote custom capability

Shared remote custom capabilities are not shared with elastic agents.

To configure a new shared remote custom capability:

  1. Click Administration in the top navigation bar.
  2. Click Agents in the left navigation panel (under 'Build Resources').
  3. Locate the 'Remote Agents' section.
  4. Click Shared Remote Capabilities.
  5. Locate the 'Add Capability' section at the bottom of the screen (see screenshot below).
  6. Choose Capability Type > Custom.
  7. Specify values for Key and Value.
  8. Click Add.

Screenshot: Adding a shared custom capability