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.
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).
To configure a new local server Builder 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 below the list (see screenshot below).
- Select 'Builder' from the 'Capability Type' dropdown.
- Select the appropriate type of Builder from the 'Type' drop-down list.
- In the 'Label' field, type the name that wish to appear in the 'Builder' 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 JDK and Path you have specified are valid. If they are not, re-enter the values and then click the 'Add' button again.
To configure a new shared remote 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 the 'Shared Remote Capabilities' link in the top right of the 'Remote Agents' section.
- The 'Shared Remote Capabilities' screen will be displayed, showing a list of all shared remote capabilities currently defined in your Bamboo system.
- Locate the 'Add Capability' section below the list (see screenshot below).
- Select 'Builder' from the 'Capability Type' dropdown.
- Select the appropriate type of Builder from the 'Type' drop-down list.
- In the 'Label' field, type the name that wish to appear in the 'Builder' 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'