This documentation relates to an earlier version of Bamboo.
View

Unknown macro: {spacejump}

or visit the current documentation home.

Once you have configured a new builder capability in your Bamboo system, its label (e.g. 'Ant') will appear in the Builder dropdown list when you configure a Job's builder (see Specifying a Builder). The builder you select will be used for every one of that Job's builds. That is, the Job can only be built by agents which have a capability whose label is specified in the Job's Builder field.

(info) 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).

(info) Please note, shared remote builder capabilities are not shared with elastic agents.

To configure a new local server Builder capability,

  1. Click the 'Administration' link in the top navigation bar.
  2. Click the 'Server Capabilities' link in the left navigation column to display the Server Capabilities page, which lists all local server capabilities currently defined in your Bamboo system.
  3. In the Add Capability section at the end of this page (see screenshot below), select 'Builder' from the 'Capability Type' dropdown list.
  4. Select the appropriate type of Builder from the 'Type' dropdown list.
  5. In the 'Builder Label' field, type a name/label for the Builder, which Bamboo presents in the 'Builders' dropdown list whenever a Job's builder is configured.
  6. 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'.
  7. 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.

(info) If you want to run multiple Maven agents on your local server, you will need to configure repository isolation for your Maven builders. See Configuring Repository Isolation for Maven Builders for details.

To configure a new shared remote Builder capability,

  1. Click the 'Administration' link in the top navigation bar.
  2. Click the 'Agents' link in the left navigation column to display the Agents page, which lists all Local and Remote Agents that currently exist in your Bamboo system.
  3. In the Remote Agents section, click the 'Shared Remote Capabilities' link at the right. The Shared Remote Capabilities page is displayed, showing a list of all shared remote capabilities currently defined in your Bamboo system.
  4. In the Add Capability section at the end of this page (see screenshot below), select 'Builder' from the 'Capability Type' dropdown list.
  5. Select the appropriate type of Builder from the 'Type' dropdown list.
  6. In the 'Builder Label' field, type a name/label for the Builder, which Bamboo presents in the 'Builders' dropdown list whenever a Job's builder is configured.
  7. 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'.
  8. 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'