How To Deactivate vSphere Kubernetes Grid Service (VKS) Deployment

Products

• VMware vSphere Kubernetes Service

Issue/Introduction

This article explains the steps required to completely delete a Tanzu Kubernetes Grid Service (TKGs) or Workload Control Plane (WCP) deployment from vSphere.

Environment

3.0

Cause

You may want to delete a TKGs or WCP deployment due to environment cleanup, configuration errors, migration, or re-deployment with updated parameters.

Resolution

Follow the steps below in sequential order to fully remove the TKGs/WCP deployment:

1. Delete all Guest (Workload) Clusters. For this step you can check from our documentation all the different ways to do so Delete a TKG Cluster Using Kubectl or Using the Tanzu CLI.

Note: 

• By deleting the cluster you will lose all your workload "Apps" running on the cluster. In case you need these applications after cluster deletion you will need to back them up using velero before deleting the cluster.
• Deactivating Workload Management on this Supervisor will delete all the Kubernetes workloads and also disable NSX configuration from this Supervisor.

2. Delete all Supervisor Namespaces

From the vSphere UI:

• Go to Workload Management > Namespaces
• Select each namespace and click Delete

Ensure that all workloads within the namespaces are removed before deletion.

 

3. Delete the Supervisor Cluster

From the vSphere UI:

• Navigate to Workload Management
• Select the Supervisor Cluster
• Click Deactivate

This will remove the WCP configuration and decommission the Supervisor Cluster VMs.