Once you have configured a new builder capability in your Bamboo system, its label (e.g. 'Ant') will appear in the 'Builder' drop-down list on the 'Build Resources' tab when you configure a build plan (see Specifying a Plan's Builder). The builder that you select when you configure a plan will be used for every build that is executed for that plan. That is, the plan can only be built by agents which have a builder capability whose label is specified in the plan's 'Builder' field.
An agent-specific capability is a capability that 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 Builder 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 Builder 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 'Builder'.
- Select the appropriate 'Type' from the drop-down list.
- In the 'Label' field, type the name that you want to be displayed in the 'Builders' drop-down list when a plan is configured.
- In the 'Path' field, type the appropriate path. This will vary depending on the 'Type' you selected in the previous step; relevant instructions will be shown below the 'Type'.
- Click the 'Add' button. This will verify whether the Builder and Path you have specified are valid. If they are not, re-enter the values and then click the 'Add' button again.
Screenshot: 'Add Capability — Builder'
