Migrating Tanzu Packages from tanzu.vmware.com to kubernetes.vmware.com
search cancel

Migrating Tanzu Packages from tanzu.vmware.com to kubernetes.vmware.com

book

Article ID: 427369

calendar_today

Updated On:

Products

Tanzu Kubernetes Runtime

Issue/Introduction

Newer versions of core packages (such as Contour, Cert-Manager, and Cluster Autoscaler) are now built under the kubernetes.vmware.com domain rather than the legacy tanzu.vmware.com. This article provides guidance on handling this domain transition and resolving common errors during the upgrade process.

 

The transition to the kubernetes.vmware.com domain is a rebranding effort that changes how the Tanzu CLI identifies and associates packages. To manage these newer versions, the Package Plugin on your local machine must be updated to support the new naming convention.

Resolution

Requirements

  • Make sure you are using tanzu CLI package plug-in 3.4.0 and later as the package is now rebranded to new name <package-name>.kubernetes.vmware.com. 
  • Usually package plug-in is auto-synced to your client based on your VKS version.  So, if your VKS is 3.3.x and earlier version, manually update package plug-in.

Installation

  • Log in to the Broadcom Support Portal. Navigate to Tanzu CLI under my downloads section and select the tanzu version(for eg 1.5.3) for your OS (Linux, macOS, or Windows).
    • Untar the package and make it executable as per docs
      • tar -xvf tanzu-cli-linux-amd64.tar.gz
      • sudo install tanzu-cli-linux_amd64 /usr/local/bin/tanzu
    • Check the tanzu version 
      • tanzu version
        version: v1.5.3
    • Search and install the plugin in the internet env: package
      • tanzu plugin search
      • tanzu plugin install package --version v3.5.0
    • Install the plugin on airgapped env
      • Download to a tar file and upload to the private repo
      • tanzu plugin download-bundle --plugin package:v3.5.0 --to-tar /tmp/plugin_bundle_package_ v3.5.0.gz
      • tanzu plugin upload-bundle --tar /tmp/plugin_bundle_package_v3.5.0.gz --to-repo custom.registry.company.com/tanzu-plugins/
    • Verify the plugin availability
      • tanzu plugin list
      • o/p should look like below having the package plugin
        tanzu plugin list
        NAME                DESCRIPTION                                                 TARGET      INSTALLED  STATUS
        Package  tanzu package management                               kubernetes  v3.5.0     installed
        telemetry           configure cluster-wide settings for vmware tanzu telemetry  global      v1.1.1     installed
  • Proceed to package upgrade by using the <package-name>.kubernetes.vmware.com. 
    • Switch to the workload/guest cluster context and list the packages tanzu package installed list -A
    • To list the repo being used tanzu package repository list -A
    • To update repository follow the docs to use specific repo as per the packages version requirement
    • To list the available packages in the cluster tanzu package available list -A
      • A sample o/p should look like below
        tanzu package available list -A
        NAMESPACE   NAME                                                   DISPLAY-NAME
        tkg-system  ako.kubernetes.vmware.com                              Avi Kubernetes Operator
        tkg-system  cert-manager.kubernetes.vmware.com                     cert-manager
        tkg-system  cluster-autoscaler.kubernetes.vmware.com               Cluster Autoscaler
        tkg-system  contour.kubernetes.vmware.com                          contour
        tkg-system  external-csi-snapshot-webhook.tanzu.vmware.com         external-csi-snapshot-webhook
        tkg-system  external-dns.kubernetes.vmware.com                     external-dns
        tkg-system  fluent-bit.kubernetes.vmware.com                       fluent-bit
        tkg-system  harbor.kubernetes.vmware.com                           harbor
        tkg-system  harbor.tanzu.vmware.com                                harbor
        tkg-system  istio.kubernetes.vmware.com                            istio
        tkg-system  prometheus.kubernetes.vmware.com                       prometheus
        tkg-system  telegraf.kubernetes.vmware.com                         telegraf
        tkg-system  velero.kubernetes.vmware.com                           velero
        tkg-system  vsphere-pv-csi-webhook.kubernetes.vmware.com           vsphere-pv-csi-webhook
    • To list specific cluster package use 

      tanzu package available list <package-name>.kubernetes.vmware.com -n tkg-system

      Example: tanzu package available list cluster-autoscaler.kubernetes.vmware.com -n tkg-system

      NAME                                      VERSION                RELEASED-AT
      cluster-autoscaler.kubernetes.vmware.com  1.31.3+vmware.1-vks.1  2025-08-18 19:37:00 +0530 IST
      cluster-autoscaler.kubernetes.vmware.com  1.32.2+vmware.1-vks.1  2025-08-18 18:57:00 +0530 IST
      cluster-autoscaler.kubernetes.vmware.com  1.33.0+vmware.2-vks.1  2025-08-09 22:24:00 +0530 IST
      cluster-autoscaler.kubernetes.vmware.com  1.34.0+vmware.1-vks.1  2025-09-18 17:08:00 +0530 IST

    • Update a existing package to use kubernetes.vmware.com as below example

      tanzu package installed update cluster-autoscaler --package cluster-autoscaler.kubernetes.vmware.com --version 1.34.0+vmware.1-vks.1 --values-file autoscaler-values.yml --namespace tkg-system

    • After performing the update, the package will successfully transition to the new kubernetes.vmware.com domain.
 

Additional Information

Standard package repo docs
Tanzu cli docs
VKS packages

Japanese version: tanzu.vmware.com から kubernetes.vmware.com への Tanzu パッケージの移行

Powered by Wolken Software