You can view all of the executable capabilities that have been defined in Bamboo on the 'Executables' page. These include local server capabilities, local agent-specific 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:
Click the
icon and select
Overview.
- Click Executables in the left navigation panel.
- Click a specific executable's tab to see the agents and jobs related to this executable capability.
Screenshot: Executables
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). A '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
or MAVEN2_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's PATH
environment variable value
- Local agents and executable capabilities — Since Bamboo automatically looks for executables installed on the same machine and creates a 'executable capability' for each executable installation it finds, all existing and subsequent local agents that you create will possess these executable capabilities. Hence, when you access the 'Executables' page and view these executable capabilities, all local agents will be grouped together in the 'All local agents' category and you will only be able to remove these executable capabilities from all local agents, not from individual local agents.