Bamboo 3.4 : Disabling or Deleting an Agent

Bamboo allows you to disable or delete an agent, to prevent that agent from running any further builds.

  • Disabling an agent lets you keep the agent in Bamboo, but stops it from running builds.
    (info) If you need to prevent Bamboo from building any Plans at all (e.g. while you re-index Bamboo), you can disable all agents. By doing so, all builds will wait in the queue until you re-enable the agents.
  • Deleting an agent removes it from Bamboo altogether. If you need to use the agent again in future, you will need to recreate it (see Creating a Local Agent and Creating a Remote Agent for more information).

Note that you can also delete/disable individual Plans and/or their Jobs. This prevents the Plan(s) and/or their Jobs from being submitted to the build queue. See Disabling or Deleting a Plan and Disabling or Deleting a Job.

Disabling an Agent

To disable an agent:

  1. Click the 'Administration' link in the top navigation bar.
  2. Click the 'Agents' link in the left navigation column to display the Agents screen, which lists all agents that currently exist in your Bamboo system. The Status column indicates which agents are currently enabled/disabled.
  3. Locate the relevant agents you wish to disable and select their check boxes in the left-most column of the table.
  4. Click the 'Disable' button above the table.

Deleting an Agent

To delete an agent:

  1. Click the 'Administration' link in the top navigation bar.
  2. Click the 'Agents' link in the left navigation column to display the Agents screen, which lists all agents that currently exist in your Bamboo system.
  3. Locate the relevant agents you wish to delete and select their check boxes in the left-most column of the table.
  4. Click the 'Delete' button above the table.

Screenshot above: Agent — Delete or Disable

Notes

Related Topics

Disabling or Deleting a Plan
Disabling or Deleting a Job
Creating a Local Agent
Creating a Remote Agent