Disable Bamboo remote agent without UI

Question

Is there a way to disable/enable bamboo remote agents through a URL or REST API call or is clicking the "Disable" or "Enable" button through the web UI after logging on as an administrator the only way?

What I'm trying to get done is nightly auto-cleanup of the remote agents since they run out of disk space all the time. If we could use another automation mechanism to disable the bamboo remote agent (through some sort of terminal call), cleanup the build-dir directories (alongside with other non-bamboo directories which take up a lot of space) and then re-enable the remote agent after cleanup, it would make our lives a lot easier.\

Thanks

Bob Swift · Answer

You can use disableAgent from Bamboo Command Line Interface (CLI).

Steffen Opel [Utoolity] · Answer

This can be achieved with Edward Webb's excellent Bamboo Agent REST APIs add-on, which, amongst other features, exposes REST endpoints to:

* force enable and disable agents (same as UI but uses tokens)
* request maintenance & disable (ideal for automation, limits impact to total capacity)
* [...]

It specifically addresses your nightly maintenance use case:

Central configuration of rules to determine if, and how many agents may go offline to perform maintenance at once. Combined with simple crontabs this provides a hands-off and automated build agent farm.

As referenced on the add-on listing, the project wiki provides more details and a user guide.