To install Tanzu Kubernetes Grid, you download the Tanzu Kubernetes Grid installer bundle to your local machine. You then use the Tanzu Kubernetes Grid command line interface (CLI) to deploy the Tanzu Kubernetes Grid management cluster and Tanzu Kubernetes clusters, and use the tools that Tanzu Kubernetes Grid provides to configure the Tanzu Kubernetes Grid instance.

Deploying the Tanzu Kubernetes Grid Management Cluster

You can deploy the Tanzu Kubernetes Grid management cluster in two ways:

  • By starting a local instance of the Tanzu Kubernetes Grid installer interface, which provides a graphical installer to guide you through the deployment process. This is the recommended method.
  • By using CLI commands to deploy the management cluster from a configuration that you provide in a YAML template file.

The Tanzu Kubernetes Grid CLI allows you to provision and manage the Tanzu Kubernetes Grid management cluster on the following platforms:

  • vSphere 6.7u3
  • vSphere 7.0 (see below)
  • Amazon Elastic Compute Cloud (Amazon EC2).

You can provision the management cluster as both a single node configuration for development, and in a highly available, multi-node configuration for production environments.

For information about where to download Tanzu Kubernetes Grid and the initial steps to perform, see Set Up the Bootstrap Environment for Tanzu Kubernetes Grid.

After you have performed the general set up of your bootstrap environment, there are further steps to perform depending on whether you are deploying to vSphere or to Amazon EC2.

Deploying Management Clusters on vSphere 7.0

If you have vSphere 7.0 and the vSphere with Kubernetes feature is enabled, the built-in Supervisor Cluster that vSphere with Kubernetes provides performs the same role as the Tanzu Kubernetes Grid management cluster. You do not need to deploy a management cluster in this case, and the Tanzu Kubernetes Grid installer prevents you from doing so. You can use the Tanzu Kubernetes Grid CLI to connect to the Supervisor Cluster and deploy and manage Tanzu Kubernetes clusters in vSphere 7.0. For more information, see Deploying Tanzu Kubernetes Clusters on vSphere 7.0 below.

If the vSphere with Kubernetes feature is not enabled, deploying a Tanzu Kubernetes Grid management cluster to vSphere 7.0 is possible, but it is not supported. For the best experience of Kubernetes on vSphere 7.0, you should enable the vSphere with Kubernetes feature and use the built-in Supervisor Cluster, rather than a Tanzu Kubernetes Grid management cluster. For information about the vSphere with Kubernetes feature in vSphere 7.0, see vSphere with Kubernetes Configuration and Management in the vSphere 7.0 documentation.

Deploying Tanzu Kubernetes Clusters

After you have deployed and configured the Tanzu Kubernetes Grid management cluster, you use the Tanzu Kubernetes Grid CLI to deploy CNCF conformant Kubernetes clusters and manage their lifecycle.

You can use the Tanzu Kubernetes Grid CLI to deploy Tanzu Kubernetes clusters to the following platforms:

  • vSphere 6.7u3
  • vSphere 7.0 (see below)
  • Amazon EC2

For information about how to deploy Tanzu Kubernetes clusters to your chosen platform, see Deploying Tanzu Kubernetes Clusters and Managing their Lifecycle.

Deploying Tanzu Kubernetes Clusters on vSphere 7.0

You do not need to deploy Tanzu Kubernetes Grid management clusters to vSphere 7.0 when the vSphere with Kubernetes feature is enabled, because you can connect the Tanzu Kubernetes Grid CLI to a vSphere with Kubernetes Supervisor Cluster. You can then use the Tanzu Kubernetes Grid CLI to deploy Tanzu Kubernetes clusters to vSphere with Kubernetes. For information about how to deploy Tanzu Kubernetes clusters to vSphere 7.0, see Use the Tanzu Kubernetes Grid CLI with a vSphere with Kubernetes Supervisor Cluster.

If you have vSphere 7.0 and the vSphere with Kubernetes feature is not enabled, it is possible to deploy a management cluster to vSphere 7.0 and use the Tanzu Kubernetes Grid CLI to deploy Tanzu Kubernetes clusters, in the same way as for vSphere 6.7u3. However, this configuration is not supported.

Configuring the Tanzu Kubernetes Grid Instance

Tanzu Kubernetes Grid provides container images and deployment manifests of additional open source tools that you can use to configure the Tanzu Kubernetes Grid instance in which your Tanzu Kubernetes clusters run. For information about how to set up these tools, see Configuring and Managing the Tanzu Kubernetes Grid Instance.

check-circle-line exclamation-circle-line close-line
Scroll to top icon