Custom capabilities can be used to control which build plans will be built by a particular agent. For example, if the builds for a particular plan 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 plan.
(See
1.2.4 Specifying a Plan's Capability Requirements.)
An agent-specific capability applies to one agent only. Note that the value of an agent-specific capability will override the value of a shared capability of the same name (if one exists).
To configure a new agent-specific 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 on the name of the agent for which you wish to configure a new Custom capability.
- The 'Agent Capabilities' screen will be displayed, showing a list of shared capabilities and agent-specific capabilities for your chosen agent. Click the 'Add Capability' link in the top-right of the 'Agent-Specific Capabilities' section.
- The 'Add Capability' page will be displayed (see screenshot below).
- Set the 'Capability Type' field to '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: 'Add Capability --- Custom'
