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
Before you begin:
- Shared remote custom capabilities are not shared with elastic agents.
To configure a new local server custom capability:
- Click the 'Administration' link in the top navigation bar.
- Click the 'Server Capabilities' link in the left navigation column. The 'Server Capabilities' screen will be displayed, showing a list of all local server capabilities currently defined in your Bamboo system.
- Locate the 'Add Capability' section at the bottom of the screen (see screenshot below).
- In the 'Capability Type' field, select 'Custom'.
- In the 'Key' field, type the key for your new custom capability.
- In the 'Value' field, type the value of your new custom capability.
- Click the 'Add' button.
Configuring a New Shared Remote Custom Capability
To configure a new shared remote custom capability:
- Click the 'Administration' link in the top navigation bar.
- Click the 'Agents' link in the left navigation column. The 'Agents' page will be displayed, showing lists of all Local Agents and Remote Agents in your Bamboo system.
- Click the 'Shared Remote Capabilities' link in the top right of the 'Remote Agents' section. The 'Shared Remote Capabilities' page will be displayed, showing a list of all shared remote capabilities currently defined in your Bamboo system.
- Locate the 'Add Capability' section at the bottom of the screen (see screenshot below).
- In the 'Capability Type' field, select 'Custom'.
- In the 'Key' field, type the key for your new custom capability.
- In the 'Value' field, type the value of your new custom capability.
- Click the 'Add' button.
Screenshot above: Adding a shared custom capability