Environment
-
CloudBees CI (CloudBees Core) on modern cloud platforms - Managed controller
-
CloudBees CI (CloudBees Core) on modern cloud platforms - Operations Center
-
CloudBees Jenkins Enterprise
-
CloudBees Jenkins Enterprise - Managed controller
-
CloudBees Jenkins Enterprise - Operations center
Resolution
When deleting a Managed controller, its storage volume may not be automatically deleted. This depends on how the cluster and the environment are configured. For example, when using Jenkins in Kubernetes, if this Jenkins argument is set -Dcom.cloudbees.masterprovisioning.kubernetes.KubernetesMasterProvisioning.deleteClaim=false
and the Reclaim Policy on the Storage Class is set to Retain
then the volume should still exist after the Managed controller is deleted in the web interface.
Before deleting any Managed controller, we always recommend taking a backup of the cluster just in case something goes wrong.
In order to completely delete a Managed controller, follow these steps:
First, delete the Managed controller from the CloudBees Jenkins Operations Center web interface
-
Find the Managed controller item in the CloudBees Jenkins Operations Center
-
Click the black arrow next to the name and select Manage
-
Click Disconnect and then Delete on the left sidebar
Next, delete the storage volume for the Managed controller. This will require admin access for the platform you are running Jenkins on.
-
If you are running Jenkins on Kubernetes: Run the command
kubectl delete persistentvolumeclaim/jenkins-home-<MASTER_NAME>
(This command will differ slightly based on naming conventions) -
If you are running Jenkins on a different platform, such as AWS or locally on your own server cluster, the process to delete the storage volume will be different. Please consult with your platform administrator on how to delete a storage volume.