Updated Information

This documentation is updated regularly with new information and fixes as needed.

The table provides the update history of this documentation.

Revision	Description
03 OCT 2024	Added the Provisioning TKG Clusters with Windows Node Pools topic. Add the Using the builtin-generic-v3.2.0 ClusterClass with TKG Service 3.2.0 topic. Added a TanzuKubernetesCluster API deprecation note to Using the TanzuKubernetesCluster v1alpha3 API.
31 JULY 2024	Miscellaneous bug fixes.
25 JUNE 2024	Updates to the documentation to support vSphere 8 Update 3 and TKG Service 3.0, including: Installing and Upgrading the TKG Service Autoscaling TKG Service Clusters Backing Up and Restoring TKG Service Clusters and Workloads Enable the Antrea-NSX Adapter for a TKG Service Cluster Install the NSX Management Proxy Service Installing Standard Packages on TKG Service Clusters Configure MachineHealthCheck for v1beta1 Clusters Cluster v1beta1 API (updates) controlPlaneCertificateRotation (updated) podSecurityStandard (new) v1beta1 Example: Cluster Based on a Custom ClusterClass (vSphere 8 U2 and Later Workflow) (updates) Install and Configure the Velero Plugin for vSphere on a TKG Cluster (updates) Manually Scale a Cluster Using Kubectl (updates)
8 MAR 2024	Updated the CSI snapshot requirements to indicate the minimum versions are vSphere 8.0 Update 2+ with TKr v1.26 and above. See Creating Snapshots in a TKG Service Cluster. Added instructions for backing and restoring TKGS cluster workloads using Velero with CSI snapshot. See Backup and Restore Using Velero with CSI Snapshot. Update the example and verification steps for provisioning a v1beta1 API cluster with an FQDN. See v1beta1 Example: Cluster with FQDN. Updated the description and Kubernetes limitation of the Can View role permission for vSphere Namespaces. See Role Permissions and Bindings. Added explicit instructions for installing the vCenter trusted root CA certificates on a Linux client host. See Download the Trusted Root CA Certificates for vCenter and Install Them on an Ubuntu Client.
29 FEB 2024	Updated the documentation to support the GA release of vSphere 8 U2 P03. Added documentation supporting creating a cluster using an FQDN. See Cluster v1beta1 API and v1beta1 Example: Cluster with FQDN. Updated Supervisor log on commands to indicate that FQDN can be used if enabled. Updated PSA documentation with additional examples. See Configure PSA for TKR 1.25 and Later. Added instructions for installing the NVIDIA Network Operator on a TKGS workload cluster for running vGPU workloads. See Cluster Operator Workflow for Deploying AI/ML Workloads on TKG Service Clusters. Added content for using the VM class creation wizard, specifically for creating a custom VM class for NVIDIA Grip vGPUs. See Deploying AI/ML Workloads on TKG Service Clusters. Updated and Install and Configure the Velero Plugin for vSphere on a TKG Cluster with links to the version compatibility matrix for Velero.
2 FEB 2024	Updated the TKG cluster provisioning documentation to indicate that on vSphere 8 the v1alpha2 API will be auto-converted to the v1alpha3 API. See About TKG Cluster Provisioning.
31 JAN 2024	Miscellaneous bug fixes and edits.
19 JAN 2024	Updated the topic for integrating a TKGS cluster with a private container registry. See Integrate TKG Service Clusters with a Private Container Registry.
18 JAN 2024	Updated Cluster v1beta1 API to clarify that the defaultRegistrySecret variable is reserved for use with the embedded Harbor Registry.
16 JAN 2024	Updated Creating Snapshots in a TKG Service Cluster to indicate that you must use the TKG Standard Package repository version v2023.9.19 or later.
8 JAN 2024	Miscellaneous minor updates.
2 JAN 2024	Miscellaneous minor updates.
20 DEC 2023	Updated Using Kubernetes Releases with TKG Service Clusters with the link to the documentation for building custom TKr images. Miscellaneous minor updates.
6 DEC 2023	Updated TKR Release Notes with new TKG releases. Updated Configure PSA for TKR 1.25 and Later to state that PSA on system namespaces cannot be changed. Updated Understanding the Rolling Update Model for TKG Service Clusters with considerations when using multiple nodepools.
21 NOV 2023	Updated v1alpha3 Example: TKC with Routable Pods Network and v1beta1 Example: Cluster with Routable Pods Network to document that /21 is the minimum size for a routable pods network. Updated Understanding the Rolling Update Model for TKG Service Clusters to clarify when a rolling update may be triggered for vSphere 7 Supervisor updates. Updated Troubleshoot Container Deployment Errors to specify when PSP is needed for TKr.
13 NOV 2023	Updated the documentation to state that a valid config key must consist of alphanumeric characters, '-', '_' or '.' (e.g., 'key.name', or 'KEY_NAME', or 'key-name').
7 NOV 2023	Updated the topic for upgrading the TKr version string. See Update a TKG Cluster by Editing the TKR Version.
16 OCT 2023	Fixed links.
13 OCT 2023	Updated the instructions for scaling a TKG cluster to include examples when using the v1beta1 API. See Manually Scale a Cluster Using Kubectl.
11 OCT 2023	Updated the instructions for connecting to a TKG cluster as an OIDC user using the Tanzu CLI. See Connect to a TKG Cluster as an OIDC User with the Tanzu CLI.
9 OCT 2023	Updated the instructions for associating the Content Library with vSphere Namespaces. See Associate the TKR Content Library with the TKG Service.
3 OCT 2023	Updated the vSphere 8 U2 custom ClusterClass documentation to include the annotation for creating an unmanaged custom ClusterClass. See v1beta1 Example: Cluster Based on a Custom ClusterClass (vSphere 8 U2 and Later Workflow).
21 SEPT 2023	Updated the documentation for the vSphere 8 U2 release features, including: Creating volume snapshots for TKG clusters. See Creating Snapshots in a TKG Service Cluster. Installing packages on TKG clusters. See Installing Standard Packages on TKG Service Clusters. Provisioning custom ClusterClass clusters using the v1beta1 API. See Using the Cluster v1beta1 API. Rolling update considerations for TKG clusters. See Understanding the Rolling Update Model for TKG Service Clusters. Miscellaneous maintenance updates and edits. Note: Be sure to check the release notes for vSphere IaaS control plane and Tanzu Kubernetes releases.
16 AUG 2023	Updating TKG cluster provisioning examples for v1alpha3 TKC with Routable Pods and v1beta1 Cluster with custom ClusterClass. See Provisioning TKG Service Clusters.
15 AUG 2023	Updated the Tanzu package installation documentation. See Installing Standard Packages on TKG Service Clusters. Minor edits and fixes.
10 AUG 2023	Added documentation for pushing Tanzu Package images from the public Harbor registry to a private Harbor registry running as a Supervisor Service. See Using Private Registries with TKG Service Clusters. Minor edits and fixes.
7 AUG 2023	Removed documentation for ExternalTrafficPolicy and LoadBalancerSourceRanges for Service type: LoadBalancer with NSX. These features are not supported.
2 AUG 2023	Added topic for connecting to TKG clusters using the Tanzu CLI and kubectl. See . Minor edits and fixes.
31 JULY 2023	Minor edits and fixes.
27 JULY 2023	Updated the documentation to support TKG 2.2.
21 JULY 2023	Added list of required permissions for administering the content library for Tanzu Kubernetes releases.
12 JULY 2023	Updated the name of the editor and viewer roles to be edit and view. See About Identity and Access Management for TKG Service Clusters.
10 JULY 2023	Added instructions for editing which content library can be used by TKG clusters on Supervisor. See Edit an Existing Content Library. Updated the topic for collecting support bundles for TKG Clusters on Supervisor. See Pull Logs to Troubleshoot TKG Clusters on Supervisor.
7 JULY 2023	Updated the topic explaining the two different cluster types you can provision using TKG 2.0 on Supervisor. See About TKG Cluster Provisioning. Added a topic with considerations for provisioning clusters with custom node volume mounts. See Considerations for Using Node Volume Mounts.
3 JULY 2023	Updated the topic for creating a vSphere IaaS control plane Operators Group and Role. See Create a Dedicated Group and Role for Platform Operators.
30 JUNE 2023	Updated the script for installing Cert Manager. See . Added instructions for registering an instance of Tanzu Mission Control Self-Managed with Supervisor. See Registering Tanzu Mission Control Self-Managed with Supervisor. Updated the VM jump host instruction for vDS environments. See Create a Linux Jump Host VM.
26 JUNE 2023	Updated the list of TKG Cluster APIs with details about which are supported with vSphere 8 Supervisor. See About TKG Cluster Provisioning. Updated the permissions list for creating a dedicated TKG Cluster Operators role. See Create a Dedicated Group and Role for Platform Operators. Updated the command for installing Contour using the Tanzu CLI. See Create the Package Repository.
13 JUNE 2023	Added topic for creating a dedicated TKG Cluster Operators Group and Role. See Create a Dedicated Group and Role for Platform Operators. Updated the topic for creating a v1beta1 Cluster using a routable pod network. See v1beta1 Example: Cluster with Routable Pods Network. Removed the topic for creating a v1alpha3 TKG cluster with a routable pod network due to a known issue. See the release notes for details.
9 JUNE 2023	Added a topic for removing a vSphere Namespace from Supervisor with a prerequisite to first delete any TKG clusters provisioned in that vSphere Namespace. See Remove a vSphere Namespace.
6 JUNE 2023	Added the vSphere IaaS control plane documentation map graphic for navigating the various publications comprising the doc set. See Using TKG Service with vSphere IaaS Control Plane.
5 JUNE 2023	Made editorial changes to various topics in the following sections: Running TKG Service Clusters and Updating TKG Service Clusters. Updated Managing TLS Certificates for TKG Service Clusters with references to the vSphere with Tanzu Certificate Guide and other changes.
1 JUNE 2023	Updated cluster provisioning examples. See Using the TanzuKubernetesCluster v1alpha3 API and Using the Cluster v1beta1 API. Updated cluster scaling examples. See Manually Scale a Cluster Using Kubectl.
26 MAY 2023	Updated the rolling update for TKG clusters topic with additional details. See Understanding the Rolling Update Model for TKG Service Clusters.
23 MAY 2023	Refactored the documentation to use TKG 2.0 instead of TKG 2.
22 MAY 2023	Updated the command for creating a namespaced pod security policy. See Apply Default Pod Security Policy to TKG Service Clusters. Updated the upgrade workflow documentation. See .
12 MAY 2023	Added note stating that you can only provision new TKG 2 clusters on a Supervisor instance that is deployed across three vSphere Zones.
11 MAY 2023	Added topic on persistent volume expansion. See Persistent Volume Expansion for TKG Service Clusters.
9 MAY 2023	Updated the zoned topology graphic to indicate that the pods are deployed across zones in this example. See Reference Architectures for TKG Service Clusters. Updated Using vSphere Namespaces with TKG Service Clusters with additional storage details. Updated Operating TKG Service Clusters with additional details on monitoring persistent storage.
4 MAY 2023	Updated Create the Package Repository to use --package. Updated Configure PSP for TKR 1.24 and Eariler to clarify that PSPs are still required for TKG 2 clusters and that the Pod Security admission controller is not supported. Updated .
1 MAY 2023	Fixed link.
4 APR 2023	Made general updates and enhancements for the vSphere 8 Update 1 release. Updated Using Kubernetes Releases with TKG Service Clusters for the vSphere 8 U1 release, including checking TKR compatibility with Supervisor and with TKG 2, the removal of the -zshippable suffix from the TKR NAME string, and building your own TKR. Updated the Cluster v1beta1 API specification documentation. Updated Integrate TKG Service Clusters with a Private Container Registry with examples. Updated Configure a Text Editor for Kubectl with additional examples for Windows. Updated Backup and Restore TKG Cluster Workloads on Supervisor Using Standalone Velero with Restic with bug fixes.