Detach a cluster from your VMware Tanzu Mission Control organization.

When you attach a cluster, Tanzu Mission Control installs cluster agent extensions on the cluster and registers the cluster with the Tanzu Mission Control cluster agent service. For more information, see What Happens When You Attach a Cluster in VMware Tanzu Mission Control Concepts.

Similarly, when you detach a cluster, Tanzu Mission Control tells the cluster agent extensions to uninstall themselves, and then removes the cluster from the cluster agent registry for your organization.

Prerequisites

Before you start this procedure, log in to the Tanzu Mission Control console and make sure you have the appropriate permissions.
  • To detach a cluster, you must be associated with the clustergroup.edit role for the cluster group.
  • You must be associated with the cluster.admin role for the cluster.

Procedure

  1. In the left navigation pane of the Tanzu Mission Control console, click Cluster groups.
  2. On the Cluster groups page, click the cluster group that contains the cluster you want to detach, and then click the cluster.
  3. On the cluster detail page, click Actions and then choose Detach from the dropdown.
  4. In the confirmation dialog, enter the name of the cluster and then click Detach.

Results

When you click Detach, Tanzu Mission Control tells the cluster agent extensions that are installed in the cluster to uninstall themselves, and then de-registers the cluster from your organization. This process takes a few minutes. While Tanzu Mission Control is waiting for notification that the cluster agent extensions have completed their uninstall, the cluster appears with the Deleting status in the Tanzu Mission Control console.

If for some reason Tanzu Mission Control cannot communicate with the cluster for an extended period of time, the cluster can remain in the Deleting status. If you have a cluster in this condition, you can optionally force the detach of the cluster, as described in Remove a Cluster from Your Organization.

What to do next

See Manage Detached Cluster Resources for information about handling resources after detaching a cluster.