Defining a new custom capability

Custom capabilities can be used to control which jobs will be built by a particular agent, since agent capabilities are required to match job requirements. 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.)

You can define a custom capability that is:

(info) Note that the value of an agent-specific capability overrides the value of a shared capability of the same name (if one exists).

On this page:

 

Defining an agent-specific custom capability

To define a new agent-specific custom capability:

  1. Navigate to the desired agent.
  2. Click Add capability in the top right of the 'Agent-Specific Capabilities' section.
  3. Choose Capability type > Custom.
  4. Specify values for Key and Value.
  5. Click Add.

Defining a local server custom capability

Local server capabilities are inherited by all local agents.

To define a new local server custom capability:

  1. Click the  icon in the Bamboo header and choose Overview.
  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.

Defining a shared remote custom capability

Shared remote custom capabilities are not shared with elastic agents.

To define a new shared remote custom capability:

  1. Click the  icon in the Bamboo header and choose Overview.
  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.
Last modified on Oct 13, 2017

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.