Viewing your executable capabilities
You can view all of the executable capabilities that have been defined in Bamboo on the Executables page. These include local server capabilities and remote agent-specific capabilities.
An executable is an external program that Bamboo uses during the build process. Generally, executables compile source code to generate compiled executable files (referred to as artifacts in Bamboo). Ant, Maven, MSBuild or PHPUnit are just some examples of executables that can be used as part of your build process.
New executables can be defined as capabilities in Bamboo. Once an executable has been defined in Bamboo, it can be configured as part of a task.
Viewing and configuring executable capabilities
To view and configure the executable capabilities defined in Bamboo:
- Go to > Build resources > Executables.
- Select a specific executable's tab to see the agents and jobs related to this executable capability.
- View more details about an agent with this executable capability — select 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 executable path of an agent with this capability — select Edit in the Operations column for the agent you wish to configure. See Defining a new executable capability.
- Remove this executable capability from an agent — select Delete in the Operations column for the agent that currently possesses this executable capability.
- View details about (and configure) an elastic image with this executable capability — select the linked name of the elastic image in the Elastic Image Configuration column.
- Configure a job that relies on or requires this executable capability — select the linked name of the job in the Plan column.
- If you are currently viewing a Maven (2.x or later) executable capability, you can configure repository isolation for it by selecting Edit capability configuration. Please refer to Configuring repository isolation for Maven executables for more information.
- To add a new executable as a local server capability, select Add executable to server capabilities to navigate to the Server capabilities page.
Notes
- Bamboo's automatic detection of executables — 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 executables installed on the same machine (based on a combination of the machine's environment variables and other conditions). An executable capability will be created for each executable that either of these Bamboo applications find.
The environment variables and conditions that Bamboo uses to automatically detect and create executable capabilities are listed below. With the exception of the Command executable, the paths for each automatically detected executable are based on the path string values found within these environment variables.- Ant — the
ANT_HOME
environment variable - Maven — the
MAVEN_HOME
environment variable (Maven 1),M2_HOME
orMAVEN2_HOME
environment variable (Maven 2.x) - Grails —
GRAILS_HOME
environment variable - Command — the existence of the
/bin/bash
file - PHPUnit — the existence of the
phpunit
file anywhere within the machine'sPATH
environment variable value
- Ant — the