Bamboo 4.4 : Configuring a new executable capability

An executable is a program external to Bamboo used to automate processes. 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.

At least one executable was automatically configured when you installed Bamboo. You can configure more by defining capabilities for the new executables (i.e. executable capabilities). Bamboo supports the following types of executables:

  • Ant
  • Maven
  • Grails
  • NAnt
  • devenv.com
  • msbuild.exe
  • PHPUnit
  • Custom command (e.g. 'make')
  • Script

The executables listed above are supported out-of-the-box. If you need to use a different executable, a number of third-party plugin modules are available (e.g. NoseXUnit). You can also create your own executable plugin (see the Bamboo Plugin Guide for details).

You can define a new executable capability for:

If an agent has its own specific executable capability, the value will override the value of a shared executable capability of the same name (if one exists).

Once you have configured a new executable capability in your Bamboo system, its label (e.g. 'Ant') will appear in the Executable list when you configure the executable for a task (see Configuring tasks). The executable you select will be used every time the task is executed during a build. That is, the task can only be run by agents which have a capability that matches the executable specified in the task's Executable list.

Notes

  • Pre-configured executables— The executable that was automatically configured when you installed Bamboo depends on the system environment variables (e.g. 'ANT_HOME=/opt/java/ant') that were present on the machine that Bamboo was installed on.
    • On the Bamboo server, environment variables that were present during installation were saved as local server capabilities in Bamboo.
    • On remote agents, environment variables that were present during installation were saved as agent-specific capabilities in Bamboo.
  • msbuild.exe — You will need to install the .NET framework SDK and reference the default path for msbuild.exe, (e.g. C:\Windows\Microsoft.NET\Framework*64*\v2.0.50727), to use this executable.
  • PHPUnit — You will need to install PHPUnit and reference the path to your PHP command-line interpreter, (e.g. /usr/bin/phpunit on Ubuntu), to use this executable.

Attachments: