このページは Cloud Translation API によって翻訳されました。

ノードプールをアップグレードする

このページでは、VMware 上の Google Distributed Cloud（ソフトウェアのみ）で作成されたユーザークラスタで、コントロールプレーンとノードプールを個別にアップグレードする方法について説明します。このページは、基盤となる技術インフラストラクチャのライフサイクルを管理する IT 管理者と運用担当者を対象としています。 Google Cloud のコンテンツで使用されている一般的なロールとタスクの例の詳細については、一般的な GKE ユーザーのロールとタスクをご覧ください。このドキュメントを読む前に、次のページに記載されている Google Distributed Cloud のアップグレードの計画と実行についてよく理解しておいてください。

制限事項

コントロールプレーンとは別にノードプールをアップグレードする場合、次の制限があります。

この機能は、Ubuntu ノードプールと COS ノードプールではサポートされていますが、Windows ノードプールではサポートされていません。
この機能は、高度でないクラスタを高度なクラスタにアップグレードする場合には使用できません。高度でないクラスタは、1.33 で高度なクラスタに自動的にアップグレードされます。
バージョン 1.31: この機能は高度なクラスタでは使用できません。
バージョン 1.32 以降: この機能は高度なクラスタで使用できます。

コントロールプレーンとノードプールを個別にアップグレードする理由

クラスタのバージョンが 1.16 以降の場合は、ノードプールをアップグレードするときにマイナーバージョンをスキップできます。バージョンスキップアップグレードを行うと、ノードプールの 2 つのバージョンを順番にアップグレードする場合に比べて、所要時間が半分に短縮されます。また、バージョンスキップアップグレードを使用すると、サポート対象のバージョンを維持するために必要なアップグレードの間隔を長くできます。アップグレードの回数を減らすと、ワークロードの中断と検証時間が短縮されます。詳細については、ノードプールのアップグレードでバージョンをスキップするをご覧ください。
状況によっては、ユーザークラスタ内のすべてのノードプールではなく、一部のノードプールをアップグレードすることをおすすめします。例:
- 最初に、コントロールプレーンと、トラフィックが少ないノードプールまたは重要度の低いワークロードを実行するノードプールをアップグレードします。ワークロードが新しいバージョンで正しく実行されることを確認したら、最終的にすべてのノードプールがアップグレードされるまで、追加のノードプールをアップグレードします。
- クラスタのアップグレードに 1 つの大きなメンテナンスの時間枠を設定するのではなく、複数のメンテナンスの時間枠でクラスタをアップグレードできます。メンテナンスの時間枠を見積もる方法については、所要時間を見積もり、メンテナンスの時間枠を計画するをご覧ください。

始める前に

バージョン 1.29 以降では、サーバーサイドのプリフライトチェックがデフォルトで有効になっています。ファイアウォールルールを確認し、必要に応じて変更してください。
バージョン 1.28 以降にアップグレードするには、kubernetesmetadata.googleapis.com を有効にして、logging-monitoring サービスアカウントに kubernetesmetadata.publisher IAM ロールを付与する必要があります。詳細については、Google API と IAM の要件をご覧ください。
クラスタの現在のバージョンがバージョン 1.14 以降であることを確認します。

コントロールプレーンと選択したノードプールをアップグレードする

ワーカーノードプールとは別にユーザークラスタのコントロールプレーンをアップグレードするには、gkectl、Google Cloud CLI、または Terraform を使用します。Terraform を使用してアップグレードできるのは、Terraform を使用して作成したユーザークラスタだけです。

`gkectl`

次のプレースホルダ変数に、ソースバージョンとターゲットバージョンを定義します。バージョンはすべて、1.16.11-gke.25 など、x.y.z-gke.N 形式の完全なバージョン番号にする必要があります。

バージョン	説明
`SOURCE_VERSION`	現在のクラスタバージョン。
`TARGET_VERSION`	ターゲットバージョンを選択します。ターゲットマイナーバージョンから推奨されるパッチを選択します。

管理ワークステーションをターゲットバージョンにアップグレードします。アップグレードが正常に完了したことを示すメッセージが表示されるまで待ちます。
対応する OS イメージを vSphere にインポートします。
```
gkectl prepare \
  --bundle-path /var/lib/gke/bundles/gke-onprem-vsphere-TARGET_VERSION.tgz \
  --kubeconfig ADMIN_CLUSTER_KUBECONFIG
```
ADMIN_CLUSTER_KUBECONFIG は、管理クラスタの kubeconfig ファイルのパスに置き換えます。
ユーザークラスタの構成ファイルを次のように変更します。
- gkeOnPremVersion フィールドをターゲットバージョン TARGET_VERSION に設定します。
- アップグレードするノードプールごとに、nodePools.nodePool[i].gkeOnPremVersion フィールドを空の文字列に設定します。
  - バージョン 1.28 以降では、nodePools.nodePool[i].updateStrategy.rollingUpdate.maxSurge フィールドを 1 より大きい整数値に設定することで、ノードプールのアップグレードを高速化できます。maxSurge を使用してノードをアップグレードすると、単一ノードのアップグレードにかかる時間と同じ時間で複数のノードをアップグレードできます。
- アップグレードしないノードプールごとに、nodePools.nodePool[i].gkeOnPremVersion をソースバージョン（SOURCE_VERSION）に設定します。
次の例は、ユーザークラスタ構成ファイルの一部を示しています。コントロールプレーンと pool-1 が TARGET_VERSION にアップグレードされるように指定していますが、pool-2 は SOURCE_VERSION のままです。
```
gkeOnPremVersion: TARGET_VERSION
...
nodePools:
- name: pool-1
  gkeOnPremVersion: ""
  ...
- name: pool-2
  gkeOnPremVersion: SOURCE_VERSION
  ...
```
コントロールプレーンと選択したノードプールをアップグレードします。
```
gkectl upgrade cluster \
  --kubeconfig ADMIN_CLUSTER_KUBECONFIG \
  --config USER_CLUSTER_CONFIG_FILE
```
USER_CLUSTER_CONFIG は、ユーザークラスタ構成ファイルのパスに置き換えます。

追加のノードプールをアップグレードする

前の例で、pool-1 ですべてが正常に動作しており、pool-2 をアップグレードする場合について考えてみましょう。

ユーザークラスタの構成ファイルで、pool-2 の下の gkeOnPremVersion を空の文字列に設定します。

gkeOnPremVersion: TARGET_VERSION
...
nodePools:
- name: pool-1
  gkeOnPremVersion: ""
  ...
- name: pool-2
  gkeOnPremVersion: ""
  ...

gkectl update cluster を実行して変更を適用します。

gkectl update cluster --kubeconfig ADMIN_CLUSTER_KUBECONFIG \
  --config USER_CLUSTER_CONFIG

gcloud CLI

ユーザークラスタをアップグレードするには、管理クラスタにいくつかの変更を加える必要があります。gcloud container vmware clusters upgrade コマンドは、自動的に次の処理を行います。

管理クラスタを GKE On-Prem API に登録します（まだ登録されていない場合）。
コンポーネントのバンドルをダウンロードして管理クラスタにデプロイします。コンポーネントのバージョンが、アップグレードに指定したバージョンと一致します。これらのコンポーネントを使用すると、管理クラスタがそのバージョンのユーザークラスタを管理できるようになります。

コントロールプレーンをアップグレードする

ユーザークラスタのコントロールプレーンを次の手順でアップグレードします。

Google Cloud CLI のコンポーネントを更新します。
```
gcloud components update
```
クラスタのアップグレードポリシーを変更します。
```
gcloud container vmware clusters update USER_CLUSTER_NAME \
  --project=PROJECT_ID \
  --location=REGION \
  --upgrade-policy control-plane-only=True
```
次のように置き換えます。
- USER_CLUSTER_NAME: アップグレードするユーザークラスタの名前。
- PROJECT_ID: ユーザークラスタがメンバーであるフリートホストプロジェクトの ID。これは、クラスタの作成時に指定したプロジェクトです。gkectl を使用してクラスタを作成した場合、これはクラスタ構成ファイルの gkeConnect.projectID フィールドのプロジェクト ID です。
- REGION: GKE On-Prem API が実行され、メタデータが保存される Google Cloud リージョン。GKE On-Prem API クライアントを使用してクラスタを作成した場合、これはクラスタの作成時に選択したリージョンです。gkectl を使用してクラスタを作成した場合、これは GKE On-Prem API にクラスタを登録したときに指定したリージョンです。
クラスタのコントロールプレーンをアップグレードします。
```
gcloud container vmware clusters upgrade USER_CLUSTER_NAME \
  --project=PROJECT_ID \
  --location=REGION \
  --version=TARGET_VERSION
```
TARGET_VERSION は、アップグレードするバージョンに置き換えます。ターゲットマイナーバージョンから推奨されるパッチを選択します。

このコマンドからの出力は、次のようになります。
```
Waiting for operation [projects/example-project-12345/locations/us-west1/operations/operation-1679543737105-5f7893fd5bae9-942b3f97-75e59179] to complete.
```
この出力例では、operation-1679543737105-5f7893fd5bae9-942b3f97-75e59179 という文字列は長時間実行オペレーションの OPERATION_ID です。オペレーションのステータスを確認するには、別のターミナルウィンドウで次のコマンドを実行します。
```
gcloud container vmware operations describe OPERATION_ID \
  --project=PROJECT_ID \
  --location=REGION
```

ノードプールをアップグレードする

ユーザークラスタのコントロールプレーンをアップグレードした後、ノードプールを次の手順でアップグレードします。

ユーザークラスタのノードプールのリストを取得します。

gcloud container vmware node-pools list
  --cluster=USER_CLUSTER_NAME  \
  --project=PROJECT_ID \
  --location=REGION

アップグレードするノードプールごとに、次のコマンドを実行します。

gcloud container vmware node-pools update NODE_POOL_NAME \
  --cluster=USER_CLUSTER_NAME  \
  --project=PROJECT_ID \
  --location=REGION \
  --version=TARGET_VERSION

Terraform

Google Cloud CLI のコンポーネントを更新します。
```
gcloud components update
```
まだ行っていない場合は、GKE On-Prem API に管理クラスタを登録します。クラスタが GKE On-Prem API に登録された後は、この手順を繰り返す必要はありません。
新しいバージョンのコンポーネントをダウンロードして、管理クラスタにデプロイします。
```
gcloud vmware admin-clusters update ADMIN_CLUSTER_NAME \
  --project=PROJECT_ID \
  --location=REGION \
  --required-platform-version=TARGET_VERSION
```
次のように置き換えます。
- USER_CLUSTER_NAME: アップグレードするユーザークラスタの名前。
- PROJECT_ID: ユーザークラスタがメンバーであるフリートホストプロジェクトの ID。これは、クラスタの作成時に指定したプロジェクトです。gkectl を使用してクラスタを作成した場合、これはクラスタ構成ファイルの gkeConnect.projectID フィールドのプロジェクト ID です。
- REGION: GKE On-Prem API が実行され、メタデータが保存される Google Cloud リージョン。GKE On-Prem API クライアントを使用してクラスタを作成した場合、これはクラスタの作成時に選択したリージョンです。gkectl を使用してクラスタを作成した場合、これは GKE On-Prem API にクラスタを登録したときに指定したリージョンです。
- TARGET_VERSION: アップグレードするバージョン。ターゲットマイナーバージョンから推奨されるパッチを選択します。
このコマンドは、--required-platform-version で指定したバージョンのコンポーネントを管理クラスタにダウンロードし、そのコンポーネントをデプロイします。これらのコンポーネントを使用すると、管理クラスタがそのバージョンのユーザークラスタを管理できるようになります。
ユーザークラスタの作成に使用した main.tf ファイルで、クラスタリソースの on_prem_version を新しいバージョンに変更します。
コントロールプレーンのみがアップグレードされるように、クラスタリソースに次のコードを追加します。
```
upgrade_policy {
  control_plane_only = true
}
```
Terraform プランを初期化して作成します。
```
terraform init
```
Google Cloudプロバイダなどの必要なライブラリがインストールされます。
構成を確認し、必要に応じて変更を加えます。
```
terraform plan
```
Terraform プランを適用して、ユーザークラスタを作成します。
```
terraform apply
```

ノードプールをアップグレードする

ユーザークラスタのコントロールプレーンをアップグレードした後、次の手順でノードプールをアップグレードします。

アップグレードする各ノードプールのリソースの main.tf に、次の行を追加します。

on_prem_version = "TARGET_VERSION"

例:

resource "google_gkeonprem_vmware_node_pool" "nodepool-basic" {
name = "my-nodepool"
location = "us-west1"
vmware_cluster = google_gkeonprem_vmware_cluster.default-basic.name
config {
  replicas = 3
  image_type = "ubuntu_containerd"
  enable_load_balancer = true
}
on_prem_version = "1.16.0-gke.0"
}

Terraform プランを初期化して作成します。
```
terraform init
```
構成を確認し、必要に応じて変更を加えます。
```
terraform plan
```
Terraform プランを適用して、ユーザークラスタを作成します。
```
terraform apply
```

トラブルシューティング

ノードプールのアップグレード後に問題が発生した場合は、前のバージョンにロールバックできます。詳細については、アップグレード後にノードプールをロールバックするをご覧ください。

ノードプールをアップグレードする

制限事項

コントロール プレーンとノードプールを個別にアップグレードする理由

始める前に

コントロール プレーンと選択したノードプールをアップグレードする

gkectl

追加のノードプールをアップグレードする

gcloud CLI

コントロール プレーンをアップグレードする

ノードプールをアップグレードする

Terraform

ノードプールをアップグレードする

トラブルシューティング

コントロールプレーンとノードプールを個別にアップグレードする理由

コントロールプレーンと選択したノードプールをアップグレードする

`gkectl`

コントロールプレーンをアップグレードする