Remove a management cluster¶

This section describes how to remove a management cluster. You can also use the following instruction to remove unsupported regional clusters, if any.

To remove a management or regional cluster:

Verify that you have successfully removed all managed clusters that run on top of the management or regional cluster to be removed. For details, see the corresponding Delete a managed cluster section depending on your cloud provider in Create and operate managed clusters.
If you enabled custom host names on an existing management or regional cluster as described in Configure host names for cluster machines, and the cluster contains hosts with non-custom names, manually delete such hosts to prevent cleanup failure.
Log in to a local machine where your management cluster kubeconfig is located and where kubectl is installed.

Note

The management cluster kubeconfig is created during the last stage of the management cluster bootstrap.

Note

To remove a regional cluster, you also need access to the regional cluster kubeconfig that was created during the last stage of the regional cluster bootstrap.
Verify that the bootstrap directory is updated.

Select from the following options:
- For clusters deployed using Container Cloud 2.11.0 or later:
```
./container-cloud bootstrap download --management-kubeconfig <pathToMgmtKubeconfig> \
--target-dir <pathToBootstrapDirectory>
```
- For clusters deployed using the Container Cloud release earlier than 2.11.0 or if you deleted the kaas-bootstrap folder, download and run the Container Cloud bootstrap script:
```
wget https://binary.mirantis.com/releases/get_container_cloud.sh

chmod 0755 get_container_cloud.sh

./get_container_cloud.sh
```

If you are removing the regional cluster, run the following script. Otherwise, skip this step.

REGIONAL_CLUSTER_NAME=<regionalClusterName> \
REGIONAL_KUBECONFIG=<pathToRegionalClusterKubeconfig> \
KUBECONFIG=<mgmtClusterKubeconfig> \
bootstrap.sh destroy_regional

Remove the management cluster:
```
bootstrap.sh cleanup
```

Note

Removing a management or regional cluster using the Container Cloud web UI is not supported.