Enabling ephemeral agent support
Before you begin
Install the Kubernetes command-line tool, kubectl, on your Bamboo server. Kubectl is not installed by default.
Steps
To enable ephemeral agent support in Bamboo:
- In the upper-right corner of the screen, selectAdministration> Overview.
- From the menu on the Bamboo administration page, under Ephemeral agents, select Configuration.
Under General, select the Enabled checkbox.
In the Path to configuration file field, enter the full path to your Kubernetes configuration file relative to the Bamboo [shared] home directory.
In the Resource label field, enter the label that you want to attach to the resources Bamboo creates and manages in your Kubernetes cluster.
Bamboo can only manage Kubernetes resources identified by the resource label you set here. If you change the resource label later, Bamboo will no longer be able to recognize resources identified by the previous label.
Select Test connection to make sure that the communication between Bamboo and your Kubernetes cluster is working correctly.
Optional: If you want Bamboo to automatically remove pods after ephemeral agents complete their work, enable automatic pod removal.
If the test connection was successful, select Save .
You can now create your first ephemeral agent template and configure its capabilities.
I'm getting a "Connection failed" error
The test connection may fail for a number of reasons. Bamboo will display the exact error message coming from Kubernetes that you can use to troubleshoot the connection with the cluster.
Here’s what you can do in the most common situations:
An error occurred while loading the configuration file — this may happen either due to an incorrectly configured path to the Kubernetes configuration file (there’s a typo in the path or the file does not exist at the specified location) or a syntax error in the file. Verify that the path you specified is correct and that the file is well-formed.
Bamboo can’t connect to the specified IP address or hostname — this can mean that the Kubernetes cluster is unreachable, the specified authentication details are incorrect, or there is an error in the provided IP address or hostname. Verify that the connection and authentication details specified in your Kubernetes configuration file are correct.
If everything looks alright but the problem persists, contact Atlassian Support.