Viewing your Builder Capabilities

Viewing and Configuring Builder Capabilities

To view and configure the Builder capabilities defined in Bamboo:

1. Click the 'Administration' link in the top navigation bar.
2. Click the 'Builders' link in the left navigation column. The Builders page will be displayed, showing the list of all the Builder capabilities defined in your Bamboo system.
   • To view a specific builder capability, click the specific builder's tab on the left. This will show you the agents and Jobs related to this builder capability, with which you can perform the following actions:
     • View more details about an agent with this builder capability — To do this, click the linked name of the agent in the Agent column. This will show you the complete list of capabilities and Jobs associated with that agent.
     • Edit the builder path of an agent with this builder capability — To do this, click the 'Edit' link in the Operations column for the agent you wish to configure.
     • Remove this builder capability from an agent — To do this, click the 'Delete' link in the Operations column for the agent that currently possesses this builder capability.
       Be aware that you can only remove a builder capability from all local agents, not from individual local agents. See the note below for more information.
     • View details about (and configure) an elastic image with this builder capability — To do this, click the linked name of the elastic image in the Elastic Image Configuration column.
     • Edit the configuration of a Job which relies on/requires this builder capability — To do this, click the linked name of the Job in the Plan column.
     • If you are currently viewing a Maven 2.x builder capability, you can configure repository isolation for it by clicking the 'Edit Capability Configuration' link. Please refer to Configuring Repository Isolation for Maven Builders for more information.
   • To add a new builder as a local server capability, click the 'Add builder to server capabilities' link at the bottom of the page to navigate to the Server Capabilities page.

Screenshot: 'Builders'

Notes

• Bamboo's automatic detection of builders — When you install the Bamboo server application or the Bamboo Remote Agent application on another machine, either of these applications will automatically look for existing builders installed on the same machine (based on a combination of the machine's environment variables and other conditions). A 'builder capability' will be created for each builder that that either of these Bamboo applications find.
  
  The environment variables and conditions that Bamboo uses to automatically detect and create builder capabilities are listed below. With the exception of the 'Command' builder, the paths for each automatically detected builder are based on the path 'string' values found within these environment variables.
  • Ant — the ANT_HOME environment variable
  • Maven (1) — the MAVEN_HOME environment variable
  • Maven 2.x — M2_HOME or MAVEN2_HOME environment variable
  • Grails — GRAILS_HOME environment variable
  • Command — the existence of the /bin/bash file
  • PHPUnit — the existence of the phpunit file anywhere within the machine's PATH environment variable value
• Local agents and builder capabilities — Since Bamboo automatically looks for builders installed on the same machine and creates a 'builder capability' for each builder installation it finds, all existing and subsequent local agents that you create will possess these builder capabilities. Hence, when you access the 'Builders' page and view these builder capabilities, all local agents will be grouped together in the 'All local agents' category and you will only be able to remove these builder capabilities from all local agents, not from individual local agents.

Related Topics

Configuring Capabilities