This page last changed on Mar 27, 2008 by alui.

An agent is a service that runs Bamboo builds. There are two types of agents:

  • local agents run on the Bamboo server. 
  • remote agents run on computers other than the Bamboo server.

(Note: Local agents run in the server's process, i.e. in the same JVM as the server. Each remote agent runs in its own process, i.e. has its own JVM.)


One local agent was automatically created when you installed Bamboo.


To create a new local agent,

  1. Click the  'Administration' link in the top navigation bar.
  2. Click the 'Agents' link in the left navigation column.
  3. This will display the 'Agents' screen, showing lists of all Local Agents and all Remote Agents that currently exist in your Bamboo system. Click the 'Add Local Agent' button.
  4. The 'Add Local Agent' screen will be displayed (see screenshot below).
  5. In the 'Name' field, type the name of the new agent. (Note that this name will be displayed on the Dashboard.)
  6. In the 'Description' field, type a description of the new agent. (This description will only be displayed to administrators.)
  7. Click the 'Add' button.
  8. This will return you to the 'Agents' screen. Your new agent will appear in the 'Local Agents' list.
    Note: new agents are enabled by default.
  9. Your new local agent will inherit all local server capabilities that are defined in your Bamboo system. You can also define agent-specific capabilities (note that these will override shared capabilities) ---  see:

Your new agent will be able to run builds for all plans whose requirements are met by the agent's capabilities (see 1.2.4 Specifying a Plan's Capability Requirements).



Screenshot: 'Add Local Agent'






















Document generated by Confluence on Apr 14, 2008 01:39