To use the Tanzu Kubernetes Grid Service v1alpha2 API for provisioning Tanzu Kubernetes clsuters, adhere to the full list of requirements.

Requirements for Using the Tanzu Kubernetes Grid Service v1alpha2 API

The Tanzu Kubernetes Grid Service v1alpha2 API provides a robust set of enhancements for provisioning Tanzu Kubernetes clusters. For more information, see Configuration Parameters for Provisioning Tanzu Kubernetes Clusters Using the Tanzu Kubernetes Grid Service v1alpha2 API.

To take advantage of the new functionality provided by the Tanzu Kubernetes Grid Service v1alpha2 API, your environment must satisfy each of the following requirements.

Requirement Reference
Workload Management is enabled with supported networking, either NSX-T Data Center or native vSphere vDS.
Note: A particular feature may require a specific type of networking. If so this is called out in the topic for that feature.

See Prerequisites for Configuring vSphere with Tanzu on a Cluster.

See Enable Workload Management with NSX-T Data Center Networking.

See Enable Workload Management with vSphere Networking.

The vCenter Server hosting Workload Management is updated to version 7 Update 3 or later.

Refer to the vCenter Server Update and Patch Releases release notes.

For update instructions, see Upgrading the vCenter Server Appliance.

All ESXi hosts supporting the vCenter Server cluster where Workload Management is enabled are updated to version 7 Update 3 or later.

Refer to the ESXi Update and Patch Release Notes.

For update instructions, see Upgrading ESXi Hosts.

vSphere Namespaces is updated to v0.0.11 or later.

For release details, see the vSphere with Tanzu Release Notes.

For update instructions, see Updating the vSphere with Tanzu Environment.

Supervisor Cluster is updated to v1.21.0+vmware.wcp.2 or later.

For release details, see the vSphere with Tanzu Release Notes.

For update instructions, see Update the Supervisor Cluster by Performing a vSphere Namespaces Update.

You must use Tanzu Kubernetes release v1.21.2---vmware.1-tkg.1.ee25d55 or later.

For release details, see List of Tanzu Kubernetes releases.

For instructions on provisioning new clusters, see Example YAML for Provisioning Tanzu Kubernetes Clusters Using the Tanzu Kubernetes Grid Service v1alpha2 API.

For instructions on updating an existing cluster, see Updating a Tanzu Kubernetes Release After the Cluster Spec Is Converted to the Tanzu Kubernetes Grid Service v1alpha2 API.