Tanzu Mission Control (TMC) は、VKS アップデート後に「TKG サービス vSphere のクラスタ クラス テンプレートのレンダリングに失敗しました: 無効な引数: クラスタ オプションにリリースがありません (無効な引数)」というエラーが発生し、新しいクラスタの作成に失敗します。

Products

• VMware vSphere Kubernetes Service
• VMware Tanzu Mission Control

Issue/Introduction

<sup>免責事項：これは英文の記事「Tanzu Mission Control (TMC) Fails to Create New Clusters After VKS Update with Error: " failed to render cluster class template for TKG Service vSphere: invalid argument: no releases in cluster options (invalid argument)”」の日本語訳です。記事はベストエフォートで翻訳を進めているため、ローカライズ化コンテンツは最新情報ではない可能性があります。最新情報は英語版の記事で参照してください。

基盤となる vSphere Kubernetes Service（VKS）環境を正常にアップデートした後、ユーザーは Tanzu Mission Control（TMC）を通じて新しいワークロードクラスタをプロビジョニングできなくなりました。</sup>

^{新規クラスタのデプロイを試行すると、テンプレートのレンダリング段階で失敗し、以下の特定のエラーが表示されます：}

^{API Error: Failed to get management cluster classes: failed to list cluster class: failed to render clusterclass: &{OrgID:##### ManagementClusterName:##### ProvisionerName:##### Name:builtin-generic-v3.x.x}: failed to render cluster class template for TKG Service vSphere: invalid argument: no releases in cluster options (invalid argument)}

Environment

^{TMC SAAS}

^VKS

Cause

^{根本原因は、更新後の VKS 管理クラスタと TMC 連携レイヤー（特に TMC Sync Agent）との間で同期が失敗したことにあります。}

^{1. VKS のアップデート: VKS の更新により、管理クラスタ上の基盤構成および TKR リストが変更されます。}

^{2. 古い Sync Agent: 情報をキャッシュし TMC サービスへ伝達する役割を持つ TMC Sync Agent ポッドが、古いまたは更新前の構成状態を保持したままになります。}

^{3. 障害発生: Agent が更新後の VKS 環境と完全に同期していないため、ClusterClass テンプレートをレンダリングしようとした際に、TMC は利用可能なリリース一覧を空または破損した状態で受け取ってしまい、結果として「no releases in cluster options」エラーが発生します。}

^{4. 管理クラスタ自体は正常に稼働しており、問題は Sync Agent が提供するコミュニケーションブリッジに限定されています。}

Resolution

^{解決策は、Sync Agent ポッドを再起動し、VKS 管理クラスタと TMC サービス間で完全な再同期を強制的に実施することです。}

^{Step 1: 管理 Supervisor クラスタへアクセスする}

^{Tanzu Mission Control に登録されている Supervisor クラスタ環境に、適切な kubeconfig ファイルを使用して kubectl でログインします。}

^{Step 2: Sync Agent ポッドの特定と再起動}

^{Sync Agent のデプロイメントを再起動し、キャッシュをクリアして新しい同期を強制します。}

^{# Sync Agent デプロイメント名を取得（名称は多少異なる場合があります）}

^{kubectl get deployments -n svc-tmc-c#####}

^{# デプロイメントを再起動（'sync-agent' は実際のデプロイメント名・ネームスペースに置き換えてください）}

^{kubectl rollout restart deployment <sync-agent-deployment-name> -n <svc-tmc-c######>}

^{Step 3: 同期ステータスの確認}

^{Sync Agent ポッドが再起動し、TMC が更新された TKR リストを正常に取得するまで、約 5〜10 分待ちます。}

^{Step 4: クラスタ作成の再テスト}

^{Tanzu Mission Control のインターフェースから新しいクラスタのプロビジョニングを再試行します。ClusterClass テンプレートが正常にレンダリングされ、利用可能な Kubernetes リリース一覧が表示されるようになります。}

Additional Information

^{TMC の管理および同期トラブルシューティングに関するドキュメントについては、以下の Broadcom 公式ドキュメントを参照してください：}

^{https://techdocs.broadcom.com/us/en/vmware-tanzu/standalone-components/tanzu-mission-control/saas/tanzu-mission-control-documentation/tanzumc-using-GUID-0A81E446-39F0-44D9-8C73-190307BCDEFB.html}