This topic explains Tanzu Kubernetes releases (TKrs), and how Tanzu Kubernetes Grid uses them to deploy clusters running specific Kubernetes versions on cluster nodes with different operating systems.

See Deploy Tanzu Kubernetes Clusters with Different Kubernetes Versions for how to manage TKrs and use them to deploy clusters.

Tanzu Kubernetes Releases

Tanzu Kubernetes Grid manages Kubernetes versions and updates the versions that it can run by using custom resources definition (CRD) objects called Tanzu Kubernetes releases (TKrs).

A TKr controller periodically polls a public registry for new Kubernetes version BoM files. When it detects a new version, it downloads the BoM and creates a corresponding TKr. The controller then saves the new BoM and TKr in the management cluster, as a ConfigMap and custom resource, respectively.

The tanzu CLI queries the management cluster to list available Kubernetes versions. When the CLI needs to create a new cluster, it downloads the TKr and BoM, uses the TKr to create the cluster, and saves the BoM to the local ~/.config/tanzu/tkg/bom directory.

Tanzu Kubernetes Releases and Antrea Versions

TKrs include a version of Antrea that is compatible with its version of Kubernetes.

All TKrs with the same minor version of Kubernetes share the same minor version of Antrea, but their patch version numbers may vary. For example, a TKr with Kubernetes v1.21.2 has Antrea v0.13.3, and other TKrs with Kubernetes versions 1.20.x may contain different Antrea patch versions numbered as 0.11.y, but not 0.12.y.

To check the Antrea version of a TKr:

  1. Find the BoM file on your local machine corresponds to the TKr, for example ~/.config/tanzu/tkg/bom/tkr-bom-v1.21.2.yaml.

  2. In the BoM file, check the version listed for components.antrea.version.

Tanzu Kubernetes Release Availability on Azure

VMware publishes TKrs to all Microsoft Azure regions within the AzurePublicCloud and AzureUSGovernment cloud environments.

Target Operating Systems

The following table shows the operating systems for cluster nodes that Tanzu Kubernetes releases support:

vSphere AWS Azure
Distributed with TKG Ubuntu 20.04
Photon OS 3
Ubuntu 20.04
Amazon Linux 2
Ubuntu 20.04
Ubuntu 18.04
Custom Image (see Build Machine Images) Ubuntu 20.04
Ubuntu 18.04
RHEL 7
Photon OS 3
Ubuntu 20.04
Ubuntu 18.04
Amazon Linux 2
Ubuntu 20.04
Ubuntu 18.04

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