Installing Tanzu Kubernetes Grid Integrated Edition on vSphere

Note: As of v1.8, Enterprise PKS has been renamed to VMware Tanzu Kubernetes Grid Integrated Edition. Some screenshots in this documentation do not yet reflect the change.

Page last updated:

This topic describes options for installing Tanzu Kubernetes Grid Integrated Edition on vSphere.

Overview

You can install Tanzu Kubernetes Grid Integrated Edition (TKGI) on vSphere in three ways, depending on whether you use the TKGI Management Console, and which container networking overlay you use:

Where possible, VMware recommends using the management console to install Tanzu Kubernetes Grid Integrated Edition on vSphere. For more information, see When Should I Use Tanzu Kubernetes Grid Integrated Edition Management Console?, below.

When Should I Use Tanzu Kubernetes Grid Integrated Edition Management Console?

Tanzu Kubernetes Grid Integrated Edition Management Console greatly simplifies the process of deploying Tanzu Kubernetes Grid Integrated Edition, especially in less complex environments. However, if you require more flexibility in in configuring your deployment, especially in complex NSX-T Data Center deployments, it might be more appropriate to perform the installation manually. For information about the supported topologies for a manual installation, see NSX-T Deployment Topologies for TKGI.

Before using Tanzu Kubernetes Grid Integrated Edition Management Console to deploy Tanzu Kubernetes Grid Integrated Edition, consider the following factors:

  • If you want to deploy Tanzu Kubernetes Grid Integrated Edition Management Console to a No-NAT topology with an NSX-T Data Center logical switch, you must perform a BYOT deployment.
  • Deployments to a Multi-Tier-0 topology are supported in BYOT deployments only and require additional configuration. For information about the additional configuration required, see Tanzu Kubernetes Grid Integrated Edition Management Console Cannot Retrieve Cluster Data in a Multi-Tier0 Topology in Troubleshooting Tanzu Kubernetes Grid Integrated Edition Management Console.
  • Deployments to a No-NAT topology with a vSphere Standard Switch or a vSphere Distributed Switch are not supported in any case.
  • Multi-Foundation deployments are not supported in any case.

How users deploy Tanzu Kubernetes Grid Integrated Edition often depends on whether they already have a custom installation of the Ops Manager tool, which TKGI uses:

  • Users on vSphere who do not have a custom Ops Manager installation may prefer the management console.
  • Users who already have Ops Manager installed for other uses, for example to run VMware Tanzu Application Service for VMs, may prefer to install TKGI manually.

Please send any feedback you have to pks-feedback@pivotal.io.