tanzu.vmware.com から kubernetes.vmware.com への Tanzu パッケージの移行
search cancel

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

book

Article ID: 428145

calendar_today

Updated On:

Products

Tanzu Kubernetes Runtime

Issue/Introduction

免責事項：これは英文の記事「Migrating Tanzu Packages from tanzu.vmware.com to kubernetes.vmware.com」の日本語訳です。記事はベストエフォートで翻訳を進めているため、ローカライズ化コンテンツは最新情報ではない可能性があります。最新情報は英語版の記事で参照してください。

Contour、Cert-Manager、Cluster Autoscaler などのコアパッケージの新しいバージョンは、従来の tanzu.vmware.com ドメインではなく、kubernetes.vmware.com ドメイン配下でビルドされるようになりました。本記事では、このドメイン移行への対応方法およびアップグレードプロセス中に発生しやすい一般的なエラーの解決方法についてご案内します。

 

kubernetes.vmware.com domain への移行はリブランディングの一環であり、Tanzu CLI によるパッケージの識別および関連付けの方法が変更されます。これらの新しいバージョンを管理するには、ローカルマシン上の Package Plugin を更新し、新しい命名規則に対応させる必要があります。

Resolution

要件

  • パッケージが新しい名称 <package-name>.kubernetes.vmware.com にリブランディングされたため、tanzu CLI の package プラグインは v3.4.0 以降 を使用していることを確認してください。kubernetes.vmware.com。
  • 通常、package プラグインは VKS のバージョンに基づいてクライアントへ自動同期されます。そのため、VKS が 3.3.x 以前の場合は、package プラグインを手動で更新してください。

インストール

  • Broadcom Support Portal にログインします。「My Downloads」セクションから Tanzu CLI を選択し、ご利用の OS（Linux、macOS、または Windows）に対応した tanzu バージョン（例：1.5.3）を選択します。
    • ドキュメントに従って、パッケージを解凍し、実行可能にします。
      • tar -xvf tanzu-cli-linux-amd64.tar.gz
      • sudo install tanzu-cli-linux_amd64 /usr/local/bin/tanzu
    • tanzu のバージョンを確認します。
      • tanzu version
        version: v1.5.3
    • インターネット接続環境にて、package プラグインを検索およびインストールします。
      • tanzu plugin search
      • tanzu plugin install package --version v3.5.0
    • エアギャップ環境でプラグインをインストールする場合
      • tar ファイルとしてダウンロードし、プライベートリポジトリへアップロードします。
      • 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/
    • プラグインが利用可能であることを確認します。
      • tanzu plugin list
      • 出力は以下のように、package プラグインが表示されるはずです。
        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
  • <package-name>.kubernetes.vmware.com を使用して、パッケージのアップグレードを実施します。
    • ワークロード／ゲストクラスタのコンテキストに切り替え、インストール済みパッケージを一覧表示します。 tanzu package installed list -A
    • 使用中のリポジトリを確認します。 tanzu package repository list -A
    • パッケージのバージョン要件に応じて特定のリポジトリを使用するため、ドキュメントに従ってリポジトリを更新します。
    • クラスタ内で利用可能なパッケージを一覧表示します。tanzu package available list -A
      • サンプル出力は以下のようになります。
        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
    • 特定のクラスタパッケージを一覧表示するには、以下を使用します。

      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

    • 以下の例のように、既存のパッケージを kubernetes.vmware.com を使用する形に更新します。

      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

    • 更新完了後、パッケージは新しい kubernetes.vmware.com ドメインへ正常に移行されます。
 

Additional Information

Standard package repo docs
Tanzu cli docs
VKS packages

Powered by Wolken Software