| VMware Tanzu Kubernetes Grid Service 3 Check for additions and updates to these release notes. |
TKG Service 3.0
Release Snapshot
TKG Service 3.0 is generally available for use with vSphere 8 Update 3.
| Name |
Release Date |
|---|---|
| TKG Service 3.0 |
6/25/2024 |
What's New
Prior to vSphere 8.0 Update 3, TKG Service components responsible for the lifecycle of TKG clusters were delivered as part of vCenter releases. Starting with the vSphere 8.0 Update 3 release, TKG Service components are decoupled from vCenter and packaged as a Supervisor service which can be updated and managed independent of vCenter releases.
With this flexibility, TKG Service releases are delivered two ways: independent and bundled with vCenter. When released independently, you can register and upgrade the TKG Service separate from upgrading vCenter. When bundled with vCenter, after upgrading vCenter the TKG Service is automatically registered for upgrade. Refer to the TKG Service documentation for details.
TKG Service 3.0 is the first release of the decoupled TKG Service. It is available as part of the vSphere 8.0 Update 3 release. The system automatically installs TKG Service 3.0 when you install or upgrade to the vSphere IaaS control plane component versions listed in the table. Once installed, you can upgrade to subsequent TKG Service releases, such as TKG Service 3.1, 3.2, and so on.
| Component |
Required Version |
|---|---|
| vCenter Server |
8.0 Update 3 (8.0.3) |
| vSphere Namespaces |
0.1.9 |
| Supervisor |
1.28.3, 1.27.5, 1.26.8 |
| TKr |
v1.25.7 or later for vSphere 8.x |
Known Issues
TKG Service 3.0 has the following known issues.
-
One of the OSImages might be missing from non-legacy TKr >= v1.28 if vSphere is upgraded from 7.x to 8.x.
Description: If, after upgrading from vSphere 7.x to 8.x, you list available TKrs for vSphere 8.x, you may not see both OSImages. For example, the following command returns only one OSImage when you should see two (must be run from the vSphere Namespace where a TKG cluster is provisioned):
kubectl get osimage -A | grep 1.28Workaround: Delete any non-legacy TKr >=v1.28 and wait for it to be re-created which will happen after approximately 10 minutes. The recreated TKr will have both the Photon and Ubuntu images, and the OSImage Kuberentes resources will also be created for both Photon and Ubuntu.
If you cannot wait for the TKr to be recreated, you can delete the active
vmware-system-tkg-controller-managerpod which will recreate the TKr. -
Supervisor backup taken via TMC with TKG Service 3.0 installed does not restore after 8 hours due to token expiration.
Description: On a TMC-managed cluster, after restoring a Supervisor from backup taken with TKG Service 3.0, the TMC agent is in a CrashLoopBackoff state.
Workaround: Reregister the cluster with TMC.
