[Bamboo Cloud docs]
[Bamboo Knowledge Base]
This page describes how to install the Bamboo Remote Agent manually.
Before you begin:
Note that you can run multiple Bamboo agents on the same machine – you just need to provide a separate home directory for each agent installation.
Read more about enabling and disabling remote agent support here.
On this page:
Important note
Bamboo remote agents are available only for Bamboo Server. They can not be used with Bamboo Cloud because of the functionality restrictions.
bamboo-agent-home
) to serve as the Bamboo agent home for the remote agent.Once installed, run the remote agent by executing the command line obtained above. This command will look something like this:
java -jar atlassian-bamboo-agent-installer-X.X-SNAPSHOT.jar http://bamboo-host-server:8085/bamboo/agentServer/
OR
java -Dbamboo.home=YourPath -jar atlassian-bamboo-agent-installer-X.X-SNAPSHOT.jar http://bamboo-host-server:8085/bamboo/agentServer/
Where X.X represents your Bamboo version number and YourPath represents the bamboo-agent-home folder's path that you created on step 1.
The name of the jar file, for example, atlassian-bamboo-agent-installer-5.4-SNAPSHOT.jar, will vary depending on the version of Bamboo you are running.
You can run the remote agent with a number of additional command line parameters. Configuration options include remote agent data storage, capability detection and logging, suppression of self-signed certificate and running without the Remote Agent Supervisor or with different start-up commands.
See Additional remote agent options for more information.
If you are having issues launching the agent, then take a look at our troubleshooting guide.
All remote agents feature a capability that can be defined. Examples include an executable, such as Maven, a JDK, a DVCS client or a custom capability. They typically define the path to an executable that has already been installed, and must be defined in Bamboo before Bamboo or its agents can make use of them.
Capabilities can be defined specifically for an agent, or shared between all local or all remote agents.
Please see Configuring capabilities for more on defining capabilities.