Unable to upgrade Kubernetes Service to 3.3.3-embedded with error "The service version is incompatible with the selected Supervisor and cannot be deployed. Choose a different version or resolve the issues with the Supervisor before proceeding".

Products

• VMware vSphere Kubernetes Service

Issue/Introduction

We see the following error when trying to install VKS 3.3.3-embedded.

Environment

vSphere with Tanzu 8.0 U3

Resolution

• Starting with vCenter Server 8.0 Update 3, each vCenter version includes an embedded VMware Kubernetes Service (VKS) package as part of the Supervisor Cluster. When vCenter is upgraded, we see the embedded VKS service on the Supervisor. However, if we try to upgrade, we see the error "The service version is incompatible with the selected Supervisor and cannot be deployed. Choose a different version or resolve the issues with the Supervisor before proceeding".
• Though the embedded VKS service is available, the image for it will be available only after the Supervisor cluster upgrade. The sequence would look like: vCenter upgrade -> Supervisor upgrade -> Embedded VKS Service upgrade
• After this initial upgrade, future VKS upgrades are managed independently of Supervisor upgrades.
• If the Supervisor Cluster is not upgraded after the vCenter upgrade, the embedded VKS 3.3.3 package will not be pulled automatically. In such cases, you must manually download and apply the VKS 3.3.3 YAML file to upgrade VKS asynchronously.

Refer to the document below to manually register a new version of the VKS with vCenter for the purposes of upgrading the VKS asynchronously.

Register a New Version of the VKS