ワークロードクラスタのアップグレード

このトピックでは、Tanzu Kubernetes Grid (TKG) ワークロードクラスタをアップグレードする方法について説明します。スタンドアローン管理クラスタを使用する TKG の場合は、まずワークロードクラスタを管理する管理クラスタをアップグレードする必要があります。

重要

vSphere 8 でスーパーバイザーを使用して展開したワークロードクラスタをアップグレードする場合は、『Tanzu CLI を使用した TKG 2.3 ワークロードクラスタの作成と管理』の「スーパーバイザーによって展開されたクラスタのアップグレード（vSphere 8 のみ）」を参照してください。

ローカルに保存された仮想マシンテンプレートを使用する Edge ワークロードクラスタをアップグレードするには、「ローカル仮想マシンテンプレートを使用した Edge クラスタのアップグレード」を参照してください。

カスタムクラスタマニフェストから作成したワークロードクラスタをアップグレードするには、「カスタムクラスタのアップグレード」を参照してください。

スタンドアローン管理クラスタとワークロードクラスタは、クライアント証明書を使用してクライアントを認証します。これらの証明書は 1 年間有効です。更新するには、少なくとも年 1 回クラスタをアップグレードします。

前提条件

「Tanzu Kubernetes Grid のアップグレード」の手順を完了していること。
スタンドアローン管理クラスタを使用する TKG を実行している場合は、「スタンドアローン管理クラスタのアップグレード」の手順を完了していること。

インフラストラクチャの前提条件

重要
Tanzu Kubernetes Grid v2.4.x は、AWS および Azure での既存の TKG ワークロードクラスタのアップグレードをサポートする TKG の最後のバージョンです。AWS および Azure で TKG ワークロードクラスタをアップグレードする機能は、Tanzu Kubernetes Grid v2.5 リリースで削除される予定です。

以降、VMware では、Tanzu Mission Control を使用してネイティブの AWS EKS クラスタと Azure AKS クラスタを作成することをお勧めします。ただし、AWS および Azure 上の既存の TKG ワークロードクラスタのアップグレードは、TKG v2.4.x までのすべての TKG リリースで引き続き完全にサポートされます。

詳細については、『VMware Tanzu Kubernetes Grid v2.4 Release Notes』の「AWS および Azure での TKG 管理クラスタとワークロードクラスタの廃止」を参照してください。

vSphere: vSphere で実行されているクラスタをアップグレードする場合は、お使いの Tanzu Kubernetes Grid のバージョンに対応したデフォルト以外のバージョンの Kubernetes にクラスタをアップグレードする前に、仮想マシンテンプレートとして適切な基本イメージテンプレート OVA が vSphere で使用可能である必要があります。OVA ファイルを vSphere にインポートする方法については、「クラスタのアップグレードの準備」の [vSphere] タブを参照してください。
AWS: Amazon Web Services (AWS) で実行されているクラスタをアップグレードする場合、サポート対象の Kubernetes バージョンを含む Amazon Linux 2 Amazon Machine Images (AMI) は、サポートされているすべての AWS リージョンのすべての AWS ユーザーに対して、公開されており使用可能です。Tanzu Kubernetes Grid は、アップグレード中に指定した Kubernetes バージョンに対して適切な AMI を自動的に使用します。
Azure: Azure で実行されているクラスタをアップグレードする場合は、「クラスタのアップグレードの準備」の [Azure] タブの手順を完了していることを確認します。

手順

アップグレードプロセスでは、ワークロードクラスタのすべての制御プレーンノードとワーカーノード内の Kubernetes のバージョンがアップグレードされます。

使用可能な管理クラスタのインタラクティブなリストを表示し、アップグレードするクラスタを管理する管理クラスタを選択するには、tanzu context use コマンドを実行します。
```
tanzu context use
```
ワークロードクラスタを一覧表示するには、次のコマンドを実行します。
```
tanzu cluster list --include-management-cluster -A
```
--include-management-cluster -A オプションを指定した tanzu cluster list コマンドにより、管理クラスタで実行されている Kubernetes のバージョンと、管理するすべてのクラスタが表示されます。この例では、管理クラスタはすでに v1.26.8 にアップグレードされているのに、ワークロードクラスタでは古いバージョンの Kubernetes が実行されています。
```
NAME                 NAMESPACE   STATUS    CONTROLPLANE  WORKERS  KUBERNETES         ROLES       PLAN  TKR
k8s-1-24-14-cluster  default     running   1/1           1/1      v1.24.14+vmware.1  <none>      dev   v1.24.14---vmware.1-tkg.1
k8s-1-25-10-cluster  default     running   1/1           1/1      1.25.10+vmware.1   <none>      dev   1.25.10---vmware.1-tkg.1
mgmt-cluster         tkg-system  running   1/1           1/1      v1.26.8+vmware.1   management  dev   v1.26.8---vmware.1-tkg.1
```
管理クラスタによって使用可能になっている Kubernetes のバージョンを確認するには、tanzu kubernetes-release get コマンドを実行します。
```
tanzu kubernetes-release get
```
出力には、クラスタの展開に使用できる Kubernetes のすべてのバージョンが一覧表示されます。また、次の注意事項があります。
- COMPATIBLE：現在の管理クラスタは、この Tanzu Kubernetes リリース (tkr) でワークロードクラスタを展開できます。
- UPDATES AVAILABLE：この tkr は、Kubernetes バージョンラインの最新のものではありません。この tkr バージョンを実行しているワークロードクラスタは、新しいバージョンにアップグレードできます。
例：
```
NAME                              VERSION                         COMPATIBLE  ACTIVE  UPDATES AVAILABLE
v1.24.17---vmware.1-tiny.2-tkg.1  v1.24.17+vmware.1-tiny.2-tkg.1  True        True
v1.24.17---vmware.2-tkg.1         v1.24.17+vmware.2-tkg.1         True        True
v1.25.13---vmware.1-tiny.2-tkg.1  v1.25.13+vmware.1-tiny.2-tkg.1  True        True
v1.25.13---vmware.2-tkg.1         v1.25.13+vmware.2-tkg.1         True        True
v1.26.8---vmware.1-tiny.2-tkg.1   v1.26.8+vmware.1-tiny.2-tkg.1   True        True
v1.26.8---vmware.2-tkg.1          v1.26.8+vmware.2-tkg.1          True        True
```
古い tkr バージョンを実行しているワークロードクラスタのアップグレード先となる新しい tkr バージョンを検出するには、現在実行している tkr バージョンを指定して tanzu kubernetes-release available-upgrades get コマンドを実行します。
```
tanzu kubernetes-release available-upgrades get v1.25.10---vmware.2-tkg.1
```
このコマンドは、指定されたバージョンを実行しているクラスタのアップグレード先となる使用可能なすべての Kubernetes バージョンを一覧表示します。

また、tanzu cluster available-upgrades get コマンドでクラスタ名を指定することで、特定のワークロードクラスタで使用可能な tkr バージョンを検出することもできます。
```
tanzu cluster available-upgrades get k8s-1-24-14-cluster
```
このコマンドは、指定されたクラスタと互換性のあるすべての Kubernetes バージョンを一覧表示します。

tkr バージョンをアップグレードするときに、マイナーバージョンをスキップすることはできません。たとえば、クラスタを v1.24.x から v1.26.x に直接アップグレードすることはできません。クラスタを v1.26.x にアップグレードする前に、v1.24.x クラスタを v1.25.x にアップグレードする必要があります。
(Azure) クラスタが Azure で実行されている場合は、クラスタをアップグレードする前に AZURE_CLIENT_SECRET 環境変数を設定します。
```
export AZURE_CLIENT_SECRET=YOUR-AZURE-CLIENT-SECRET
```
(vSphere) ノード IP アドレス管理を使用するクラスタでは、アップグレード前に IP アドレスプールに少なくとも 1 つの未割り当ての IP アドレスが必要です。
1. クラスタがノード IP アドレス管理を使用しているかどうかを確認するには、クラスタオブジェクトの spec.topology.variables network 設定で addressesFromPools を探します。
```
kubectl -n NAMESPACE get cluster CLUSTER-NAME -o json | jq '.spec.topology.variables[] | select(.name=="network")'
```
  ここで、CLUSTER-NAME および NAMESPACE は、ワークロードクラスタの名前と管理クラスタの名前空間です。例：
```
kubectl -n default get cluster my-work-cluster -o json | jq '.spec.topology.variables[] | select(.name=="network")'
{
  "name": "network",
  "value": {
    "addressesFromPools": [
      {
        "apiGroup": "ipam.cluster.x-k8s.io",
        "kind": "InClusterIPPool",
        "name": "mgmt-cluster-nimbus"
      }
    ],
    "ipv6Primary": false
  }
} 
```
2. クラスタの IP アドレスプールに未使用のアドレスがあることを確認するには、プール内の合計数を次のコマンドによって出力される現在割り当てられている数と比較します。
```
kubectl -n NAMESPACE get ipaddress | grep POOL-NAME | wc -l
```
tanzu cluster upgrade CLUSTER-NAME コマンドを実行し、y と入力して確認します。確認手順をスキップするには、--yes オプションを指定します。

このリリースの Tanzu Kubernetes Grid のデフォルトの Kubernetes バージョンにクラスタをアップグレードするには、オプションの設定なしで tanzu cluster upgrade コマンドを実行します。このリリースでは、デフォルトのバージョンは v1.26.8 です。例：
```
tanzu cluster upgrade k8s-1-25-7-cluster
```
クラスタが default 名前空間で実行されていない場合は、--namespace オプションを指定します。
```
tanzu cluster upgrade CLUSTER-NAME --namespace NAMESPACE-NAME
```
アップグレードが完了する前にタイムアウトした場合は、デフォルトの 30 分よりも大きい値を指定した --timeout オプションを指定して、tanzu cluster upgrade を再度実行します。
```
tanzu cluster upgrade CLUSTER-NAME --timeout 45m0s
```
重要
Azure での操作は、他のプラットフォームでの場合よりも時間がかかる場合があります。Azure 上のクラスタをアップグレードする場合は、エラーを回避するために --timeout オプションを定期的に設定してください。

IaaS アカウント内の複数のベース仮想マシンイメージにアップグレード先の Kubernetes と同じバージョンがある場合は、「アップグレード先の OS を選択」の説明に従って、--os-name とその他のオプションを含め、ターゲット OS を指定できます。
```
tanzu cluster upgrade CLUSTER-NAME --os-name ubuntu
```
vSphere では、アップグレード先の OVA テンプレートの選択の説明に従って、--vsphere-vm-template-name オプションを使用してクラスタノードのターゲット OVA テンプレートを指定できます。
```
tanzu cluster upgrade CLUSTER-NAME --vsphere-vm-template-name "/dc0/vm/tanzu/ubuntu-2004-kube-v1.29.9-vmware.1"
```
tkr のマイナーバージョンをスキップすることはできないため、デフォルトバージョンより 2 つ上のマイナーバージョンのクラスタをアップグレードしようとすると、アップグレードコマンドは失敗します。たとえば、v1.24.x から v1.26.x に直接アップグレードすることはできません。このリリースの Tanzu Kubernetes Grid のデフォルト以外の Kubernetes バージョンにクラスタをアップグレードするには、上記の tanzu kubernetes-release get によって一覧表示されている、選択したバージョンの NAME を使用して --tkr オプションを指定します。たとえば、クラスタ k8s-1-24-14-cluster を v1.24.14 から v1.25.13 もアップグレードするには
```
tanzu cluster upgrade k8s-1-24-14-cluster --tkr v1.25.13---vmware.1-tkg.1
```
アップグレードが完了したら、tanzu cluster list コマンドを実行して、ワークロードクラスタがアップグレードされていることを確認します。
```
tanzu cluster list --include-management-cluster -A
```
管理者の kubeconfig を再生成します。
```
tanzu cluster kubeconfig get CLUSTER-NAME --admin
```
ここで、CLUSTER-NAME はワークロードクラスタの名前です。

重要
アップグレード後に kubeconfig を更新しない場合、有効期限が切れるとクラスタにアクセスできなくなります。
LDAP または OIDC ID プロバイダを使用している場合は、kubectl を使用して、クラスタに対して認証できることを確認します。例：
```
kubectl get pods -A --kubeconfig my-cluster-credentials
```
ワークロードクラスタで実行されている、Contour、Fluent Bit、Prometheus などの CLI で管理されるパッケージをアップグレードします。CLI で管理されるパッケージのアップグレードの詳細については、「Update a Package」を参照してください。

重要
ワークロードクラスタに Prometheus がインストールされていて、ワークロードクラスタを Kubernetes v1.25 にアップグレードする場合は、Prometheus をバージョン 2.37.0+vmware.3-tkg.1 以降にアップグレードする必要があります。Prometheus パッケージの以前のバージョン（バージョン 2.37.0+vmware.1-tkg.1 など）は、Kubernetes 1.25 と互換性がありません。

ローカル仮想マシンテンプレートを使用した Edge クラスタのアップグレード

tanzu cluster upgrade コマンドを使用して、ローカル仮想マシンテンプレートを持つ Edge ワークロードクラスタの Kubernetes バージョンをアップグレードすることはできません。詳細については上記の「ローカル仮想マシンテンプレートの指定」を参照してください。

代わりに、Edge ワークロードクラスタの Kubernetes バージョンを次のようにアップグレードします。

新しい仮想マシンテンプレートをローカル vCenter Server にアップロードし、そのインベントリパス（/dc0/vm/ubuntu-2004-kube-v1.26.8+vmware.1-tkg.1 など）を記録します。
アップグレードする Cluster オブジェクトのマニフェストを編集します。
```
kubectl edit cluster CLUSTER-NAME
```
ここで、CLUSTER-NAME はクラスタの名前です。
spec.topology で、以下を更新します。
- 新しい Kubernetes バージョンを反映するように version を設定します。
- クラスタ全体または個々のマシンの展開で更新するすべての vcenter.template の値を、新しいローカルテンプレートのインベントリパスに設定します。
保存して終了し、新しい Cluster オブジェクト設定を適用します。

次の手順

引き続き Tanzu CLI を使用してクラスタを管理できるようになりました。詳細については、『Tanzu CLI を使用した TKG 2.3 ワークロードクラスタの作成と管理』を参照してください。

ワークロード クラスタのアップグレード

前提条件

インフラストラクチャの前提条件

手順

ローカル仮想マシン テンプレートを使用した Edge クラスタのアップグレード

次の手順

ワークロードクラスタのアップグレード

ローカル仮想マシンテンプレートを使用した Edge クラスタのアップグレード