クラスタのアップグレードのロールアウトを順序付ける

このドキュメントでは、ロールアウト シーケンスを使用して GKE クラスタのアップグレードを管理する方法について説明します。この機能の仕組みの詳細については、ロールアウト シーケンスを使用したクラスタのアップグレードについてをご覧ください。

始める前に

  • Google Cloud CLI をインストールします。 インストール後、次のコマンドを実行して Google Cloud CLI を初期化します。

    gcloud init

    外部 ID プロバイダ(IdP)を使用している場合は、まず連携 ID を使用して gcloud CLI にログインする必要があります。

  • 既存の Autopilot クラスタまたは Standard クラスタがあることを確認します。新しいクラスタを作成するには、Autopilot クラスタの作成をご覧ください。
  • フリートに必要な API が有効になっていることを確認する。あらゆる種類のロールアウト シーケンスを作成するには、フリート ホスト プロジェクトでこれらの API を有効にする必要があります。
  • Terraform の場合は、google プロバイダのバージョン 5.13.0 以降を使用してください。

必要なロール

ロールアウト シーケンスを作成または変更するには、ロールアウト シーケンス内の各プロジェクトに対する roles/gkehub.editor IAM ロールが付与されている必要があります。フリート編集者(旧 GKE Hub 編集者)ロールには、プロジェクト間でフリート関連のリソースにアクセスして変更するために必要な gkehub.features.create 権限と gkehub.fleet.update 権限が付与されています。このロールには、アップグレード戦略の定義、関連リソースへのアクセスと変更、ロールアウト プロセスの開始と管理に必要な権限が付与されています。

クラスタをフリートに登録または登録解除するには、次のすべての権限が必要です。

さまざまなタスクに必要な最小権限の IAM ロールについては、Gemini アシスタンスを使用して事前定義ロールの候補を取得するをご覧ください。

ロールアウト シーケンスを構成する

このドキュメントでは、フリートで編成されたクラスタのグループを使用して、ロールアウト シーケンスを作成する方法について説明します。

最大 5 つのクラスタのグループのシーケンスを作成できます。1 つのグループ内でクラスタのアップグレードが完了した後のソークテスト時間(最大 30 日)を選択できます。これには Autopilot クラスタと Standard クラスタの両方を含めることができます。

ロールアウト シーケンスを作成するには、クラスタをフリートのグループに編成する必要があります。クラスタの編成方法については、コミュニティ バンクの例をご覧ください。クラスタをグループに編成したら、アップストリーム グループの関係と各グループのソーク時間を定義して、ロールアウト シーケンスを作成します。ロールアウト シーケンスにおいて、アップストリームは前のグループを指し、ダウンストリームは次のグループを指します。

クラスタをグループに編成する

ロールアウト シーケンスでは、すべてのグループ内のすべてのクラスタが同じリリース チャンネルに登録されており、同じマイナー バージョンであることが必要です。これらの要件が満たされておらず、クラスタ間でバージョンの不一致がある場合は、バージョンのロールアウトで問題が発生する可能性があります。詳細については、フリートベースのロールアウトの適格性をご覧ください。

すでにクラスタをフリートに編成している場合は、次の手順をスキップして、ロールアウト シーケンスを作成するに進むことができます。

  1. クラスタをフリートにグループ化します。フリートベースのロールアウト シーケンスの例に示すように、テスト、ステージング、本番環境などのデプロイ環境ごとにクラスタを編成できます。

  2. 選択したグループ化に基づいて、各クラスタをフリートに登録します。

ロールアウト シーケンスを作成する

ロールアウト シーケンスは、最大 5 つの要素を持つリンクされたリストとして編成されます。

ロールアウト シーケンスを作成するときは、クラスタのフリートごとに次のプロパティを設定します。

  • アップストリーム グループ: ダウンストリーム グループの新しいバージョンの対象となるアップストリーム フリート。シーケンスの最初のグループにアップストリーム グループは設定しません。
  • ソーク時間: グループのソーク時間は、アップグレードの完了(または 30 日後のロールアウト)から、ダウンストリーム グループでアップグレードが開始されるまでの時間です。詳細については、ロールアウト シーケンスでのバージョン認定の仕組みをご覧ください。

コンソール

  1. Google Cloud コンソールの [ロールアウト シーケンス] ページに移動します。

    ロールアウト シーケンスに移動

  2. [ロールアウト シーケンスを作成] をクリックします。

  3. [ロールアウト シーケンスを作成] ペインで、シーケンスの最初の 2 つのフリートを選択します。

    1. [フリート 1] セクションで、シーケンスの最初のフリートを選択します。
    2. [アップストリーム フリートのソーク時間] セクションで、[]、[時間]、[] の各フィールドを使用して、最初のフリートのソーク時間を設定します。
    3. [フリート 2] セクションで、シーケンス内の 2 番目のフリートを選択します。
    4. [作成] をクリックします。
  4. 省略可: このロールアウト シーケンスで 3 つ以上のフリートが必要な場合は、次の追加手順を実施します。

    1. [ロールアウト グラフ] で、2 番目のフリートの要素をクリックします。
    2. [ ダウンストリーム フリートを追加] をクリックします。
    3. [アップストリーム フリートのソーク時間] セクションで、[]、[時間]、[] の各フィールドを使用して、2 番目のフリートのソーク時間を設定します。
    4. [シーケンス内の次のフリート] セクションで、シーケンス内の 3 番目のフリートを選択します。
    5. [保存] をクリックします。
    6. 4 番目または 5 番目のフリートを追加する場合は、前の手順を繰り返します。

gcloud

次の手順では gcloud container fleet clusterupgrade update コマンドを使用しますが、gcloud container fleet clusterupgrade create コマンドでも同じプロパティを設定できます。

次の各コマンドで、SOAK_TIME は更新するフリーとのソーク時間に置き換えます。

ロールアウト シーケンスを作成します。

  1. シーケンスの最初のフリートのソーク時間を設定します。

    gcloud container fleet clusterupgrade update \
        --default-upgrade-soaking=SOAK_TIME \
        --project=FIRST_FLEET_PROJECT_ID
    

    FIRST_FLEET_PROJECT_ID は、フリート ホスト プロジェクトのプロジェクト ID に置き換えます。

  2. シーケンスの 2 番目のフリートのアップストリーム フリートとソーク時間を設定します。

    gcloud container fleet clusterupgrade update \
        --upstream-fleet=FIRST_FLEET_PROJECT_ID \
        --default-upgrade-soaking=SOAK_TIME \
        --project=SECOND_FLEET_PROJECT_ID
    

    FIRST_FLEET_PROJECT_ID は、最初のフリートのホスト プロジェクトのプロジェクト ID に置き換え、SECOND_FLEET_PROJECT_ID は、フリートのホスト プロジェクトのプロジェクト ID に置き換えます。

  3. 省略可: ロールアウト シーケンスで 2 つ以上のフリートが必要な場合は、シーケンス内の次のフリートのアップストリーム フリートを設定します。

    次のコマンドでは、シーケンスの 3 番目のフリートのアップストリーム フリートを設定できます。4 番目または 5 番目のフリートを追加する場合は、この手順を繰り返します。同じパターンに従って、変数をそれぞれのフリート ホスト プロジェクト(前のフリートと次のフリート)のプロジェクト ID に置き換えます。

    シーケンス内の次のフリートのアップストリーム フリートを設定します。

    gcloud container fleet clusterupgrade update \
        --upstream-fleet=SECOND_FLEET_PROJECT_ID \
        --default-upgrade-soaking=SOAK_TIME \
        --project=THIRD_FLEET_PROJECT_ID
    

    SECOND_FLEET_PROJECT_ID は、2 番目のフリートのホスト プロジェクトのプロジェクト ID に置き換え、THIRD_FLEET_PROJECT_ID は、フリートのホスト プロジェクトのプロジェクト ID に置き換えます。

Terraform

このセクションでは、Terraform を使用してフリートベースのシーケンスを作成する方法について説明します。このリソースを使用してシーケンスを更新することもできます。詳細については、google_gke_hub_feature のリファレンス ドキュメントをご覧ください。

次の各コマンドで、SOAK_TIME は更新するフリーとのソーク時間に置き換えます。

ロールアウト シーケンスを作成します。

  1. Terraform 構成に次のブロックを追加して、シーケンスの最初のフリートのソーク時間を設定します。

    resource "google_gke_hub_feature" "feature" {
      name = "clusterupgrade"
      location = "global"
      spec {
        clusterupgrade {
          upstream_fleets = []
          post_conditions {
            soaking = "SOAK_TIME"
          }
        }
      }
      project = "FIRST_FLEET_PROJECT_ID"
    }
    

    FIRST_FLEET_PROJECT_ID は、フリート ホスト プロジェクトのプロジェクト ID に置き換えます。

  2. 次のブロックを Terraform 構成に追加して、シーケンスの 2 番目のフリートのアップストリーム フリートとソーク時間を設定します。

    resource "google_gke_hub_feature" "feature" {
      name = "clusterupgrade"
      location = "global"
      spec {
        clusterupgrade {
          upstream_fleets = ["FIRST_FLEET_PROJECT_ID"]
          post_conditions {
            soaking = "SOAK_TIME"
          }
        }
      }
      project = "SECOND_FLEET_PROJECT_ID"
    }
    

    FIRST_FLEET_PROJECT_ID は、最初のフリートのホスト プロジェクトのプロジェクト ID に置き換え、SECOND_FLEET_PROJECT_ID は、フリートのホスト プロジェクトのプロジェクト ID に置き換えます。

  3. 省略可: ロールアウト シーケンスで 3 つのフリートが必要な場合は、Terraform 構成に次のブロックを追加して、シーケンス内のフリートにアップストリーム フリートを設定します。

    resource "google_gke_hub_feature" "feature" {
      name = "clusterupgrade"
      location = "global"
      spec {
        clusterupgrade {
          upstream_fleets = ["SECOND_FLEET_PROJECT_ID"]
          post_conditions {
            soaking = "SOAK_TIME"
          }
        }
      }
      project = "THIRD_FLEET_PROJECT_ID"
    }
    

    SECOND_FLEET_PROJECT_ID は、2 番目のフリートのホスト プロジェクトのプロジェクト ID に置き換え、THIRD_FLEET_PROJECT_ID は、フリートのホスト プロジェクトのプロジェクト ID に置き換えます。

    4 番目または 5 番目のフリートを追加する場合は、この手順を繰り返します。

ロールアウト シーケンスのステータスを確認する

ロールアウト シーケンスのステータスは、次のいずれかの方法で確認できます。

  • Google Cloud コンソールで、ロールアウト シーケンスの視覚的表現をモニタリングします(プレビュー版)。
  • gcloud CLI または GKE Hub API を使用して、ロールアウト シーケンスのステータスを確認します。

上記のいずれかの方法でロールアウト シーケンスを表示するには、各フリート ホスト プロジェクトに roles/gkehub.viewer IAM ロールが付与されていることを確認します。特に、シーケンスに異なるプロジェクトのフリートが含まれている場合は、この点を確認してください。プロジェクトに必要な権限がない場合は、シーケンスのステータスを確認するときにエラーが発生します。

Google Cloud コンソールでロールアウト シーケンスをモニタリングする

  1. Google Cloud コンソールの [ロールアウト シーケンス] ページに移動します。

    ロールアウト シーケンスに移動

  2. [ロールアウト シーケンスのモニタリング] セクションでシーケンスを表示します。ロールアウト順序が表示されない場合は、別のロールアウト シーケンスに切り替えるか、まだ作成していない場合はロールアウト シーケンスを作成します。

コンソールを使用してロールアウト シーケンスをモニタリングする方法

このページでは、プロジェクトのフリートと関連付けられているロールアウト シーケンスを確認できます。ロールアウト シーケンスの進行状況を確認するには、次の操作を行います。

  • ロールアウト シーケンス全体、または個々のフリートとフリート内のクラスタのステータス、フリート間のソーク時間を表示します。シーケンスの構成を確認する必要がある場合は、アクティブなアップグレードがないシーケンスも表示できます。
  • アップグレード タイプ(コントロール プレーンまたはノードのアップグレード)と特定のバージョン(1.31.6-gke.500 など)でフィルタリングします。

GKE がシーケンス内のすべてのクラスタをアップグレードする際、ロールアウト シーケンス全体を視覚的にモニタリングできます。これにより、本番環境クラスタをアップグレードする前に、環境全体で新しいバージョンを検証できます。モニタリング中に、gcloud CLI を使用してロールアウト シーケンスを管理し、必要に応じて変更を加えることができます。

別のロールアウト シーケンスに切り替える

Google Cloud コンソールのアクティブなプロジェクトがロールアウト シーケンスに登録されているフリートのフリート ホスト プロジェクトである場合、このページにはロールアウト シーケンスが表示されます。

別のロールアウト シーケンスを表示するには、ページ上部のプロジェクト選択ツールから、別のロールアウト シーケンスに関連付けられているフリート ホスト プロジェクトを選択します。

gcloud CLI を使用する

ロールアウト シーケンス、シーケンス内のフリート、フリート内の個々のクラスタのステータスを確認できます。

  • フリートベースのロールアウト シーケンスのステータスを確認するには、次のコマンドを実行します。

    gcloud container fleet clusterupgrade describe \
        --show-linked-cluster-upgrade --project=FLEET_PROJECT_ID
    

    FLEET_PROJECT_ID は、シーケンス内の任意のフリートのホスト プロジェクトのプロジェクト ID に置き換えます。フラグの全一覧については、gcloud container fleet clusterupgrade describe のリファレンスをご覧ください。

  • シーケンス内の 1 つのフリートのステータスのみを確認するには、上記のコマンドで --show-linked-cluster-upgrade フラグを --show-cluster-upgrade フラグに置き換えます。

  • フリート内の個々のクラスタのステータスを確認するには、フリート ホスト プロジェクトで次のコマンドを実行して、membershipStates セクションを表示します。

    gcloud container fleet features describe clusterupgrade
    

次のセクションでは、結果の出力のステータス情報について説明します。

ロールアウト シーケンスのステータス情報

バージョンのロールアウトのステータスをチェックすると、各グループとグループ内のクラスタの進捗状況を確認できます。

クラスタまたはグループの想定されるステータスについては、次の表をご覧ください。

ステータス 単一クラスタの場合 フリートの場合
INELIGIBLE(不適格) このクラスタはこのアップグレードの対象ではありません このグループ内の 1 つ以上のクラスタはこのアップグレードの対象外です。
保留中 クラスタ、またはその Standard ノードプールの一部、または Autopilot クラスタ内のノードのグループで、アップグレードが保留中です。 グループ内のどのクラスタでもアップグレードが開始されていません。
IN_PROGRESS クラスタでアップグレードが進行中です。 アップグレードが少なくとも 1 つのクラスタで開始されていますが、一部のクラスタで完了していません。
SOAKING(ソーク処理中) アップグレードはクラスタで完了し、ソーク処理がまだ完了していません。 アップグレードはすべてのクラスタで終了し、ソーキングはまだ完了していません。
FORCED_SOAKING(強制ソーク処理中) アップグレードに最長アップグレード時間(30 日間)を超える期間を要していたため、アップグレードを強制的にソークフェーズに移行しました。アップグレードはクラスタ内で続行できます。 アップグレードに最長アップグレード時間(30 日間)を超える期間を要していたため、アップグレードを強制的にソークフェーズに移行しました。アップグレードはクラスタ内で続行できます。
完了 アップグレードは「完了」として扱われます。つまり、このクラスタではアップグレードにおけるソーク処理が完了しています。 アップグレードは「完了」として扱われ、ダウンストリーム グループで使用できます。つまり、アップグレードにおけるソーク処理が完了しています。

これらのコマンドの出力では、clusterUpgrade(s).spec 属性と clusterUpgrade(s).state 属性に、ソーク処理時間、クラスタのアップグレード オーバーライド、アップグレード ステータスなど、クラスタのアップグレードに関する追加情報が含まれます。

ロールアウト シーケンスを管理する

以下の各セクションで説明するように、ロールアウト シーケンスを使用してクラスタの自動アップグレードを制御する方法はいくつかあります。

グループのソーク時間を変更する

グループのデフォルトのソーク時間や、そのグループが特定のバージョンにアップグレードするソーク時間を変更できます。最長で 30 日です。

デフォルトのソーク時間を更新する

デフォルトのソーク時間を更新するには、 Google Cloud コンソール(プレビュー版)または gcloud CLI を使用します。

コンソール

  1. Google Cloud コンソールの [ロールアウト シーケンス] ページに移動します。

    ロールアウト シーケンスに移動

  2. [ロールアウト シーケンスのモニタリング] セクションでシーケンスを表示します。ロールアウト順序が表示されない場合は、別のロールアウト シーケンスに切り替えるか、まだ作成していない場合はロールアウト シーケンスを作成します。

  3. [ロールアウト グラフ] で、ソーク時間を更新するフリートの要素の後の [ソーク時間] 要素をクリックします。

  4. [ソーク時間を編集] をクリックします。

  5. [新しいソーク時間を設定] セクションで、[]、[時間]、[] の各フィールドを使用して、新しいソーク時間を入力します。

  6. 設定を保存するには、[保存] をクリックします。

gcloud

グループのデフォルトのソーク時間を変更するには、ロールアウト シーケンスを作成するの手順の gcloud CLI コマンドを使用して、アップストリーム グループを設定するフラグを省略します。

デフォルトのソーク時間をオーバーライドする

特定のバージョン ロールアウトのソーク時間を、グループのデフォルトのソーク時間とは異なるものに変更できます。たとえば、すでに新しいバージョンを認定しており、次のグループでアップグレードを開始する準備ができている場合、ソーク時間を 0 に設定できます。また、デフォルトのソーク時間を長くして特定のバージョンを認定する場合にも使用できます。

ソーク時間はグループ単位で設定されるため、このシーケンスの他のグループのソーク時間をオーバーライドする場合は、同じコマンドを使用して、フリート名を置き換えて更新します。

このセクションの手順では、次の変数を置き換えます。

  • SOAK_TIME: デフォルト以外で使用するソーク時間(例: 1 つのバージョンのロールアウトのソーク時間をスキップする場合は「0d」)。
  • UPGRADE_NAME: アップグレードのタイプ。コントロール プレーンのアップグレードの場合は k8s_control_plane、ノードのアップグレードの場合は k8s_node です。
  • VERSION: バージョン(1.25.2-gke.400 など)がこのグループにロールアウトされた後、デフォルトのソーク時間をオーバーライドする GKE バージョン。

gcloud

特定のバージョンのバージョン ロールアウトに使用されるソーク時間をオーバーライドするフリートのホスト プロジェクトで、次のコマンドを実行します。

gcloud container fleet clusterupgrade update
    --add-upgrade-soaking-override=SOAK_TIME \
    --upgrade-selector=name=UPGRADE_NAME,version=VERSION

Terraform

Terraform 構成の clusterupgrade ブロック内に次の gke_upgrades_overrides ブロックを追加して、特定のバージョンのバージョン ロールアウトに使用されるソーク時間をオーバーライドします。

gke_upgrade_overrides {
    upgrade {
      name = "UPGRADE_NAME"
      version = "VERSION"
    }
    post_conditions {
      soaking = "SOAK_TIME"
    }
  }

ロールアウト シーケンスでグループを更新する

既存のロールアウト シーケンスを更新して、シーケンス内のグループを追加、削除、並べ替えることができます。これらの変更を行うには、グループ間の関連付けを更新します。

これらの手順は、 Google Cloud コンソール(プレビュー版)または gcloud CLI で実行できます。

コンソール

  1. Google Cloud コンソールの [ロールアウト シーケンス] ページに移動します。

    ロールアウト シーケンスに移動

  2. [ロールアウト シーケンスのモニタリング] セクションでシーケンスを表示します。ロールアウト順序が表示されない場合は、別のロールアウト シーケンスに切り替えるか、まだ作成していない場合はロールアウト シーケンスを作成します。

  3. [ロールアウト グラフ] で、既存のフリートのエレメントを順番にクリックします。これらの要素をクリックすると、次の操作のいずれかを行って変更できます。

    • [ ダウンストリーム フリートを追加] をクリックします。
    • [ アップストリーム フリートを追加] をクリックします。
    • [フリートを削除] をクリックします。

次のような操作を行えます。

  • シーケンスの最後のフリートにダウンストリーム フリートを追加して、ロールアウト シーケンスの最後に別のフリートを追加します。
  • シーケンスの最初のフリートにアップストリーム フリートを追加して、ロールアウト シーケンスの先頭に別のフリートを追加します。
  • フリートを削除してから、別のアップストリームまたはダウンストリーム フリートと組み合わせてフリートを追加し直すことで、ロールアウト シーケンスでフリートの順序を変更します。
  • ロールアウト シーケンスの最初のフリートを削除します。
  • ロールアウト シーケンスの最後のフリートを削除します。
  • ロールアウト シーケンスの最初のフリートまたは最後のフリートを削除した後、ロールアウト シーケンスの中央のフリートを取り除きます。

gcloud

アップストリーム フリートを追加または変更するには、--upstream-fleet フラグを指定して gcloud container fleet clusterupgrade update コマンドを使用します。アップストリーム フリートを削除するには、--reset-upstream-fleet フラグを使用します。

次のような操作を行えます。

  • シーケンスの最初のフリートにアップストリーム フリートを追加して、ロールアウト シーケンスの先頭に別のフリートを追加します。
  • アップストリーム フリートの関連付けを変更して、ロールアウト シーケンス内のフリートの順序を変更します。
  • 2 番目のフリートのアップストリーム フリートを削除して、ロールアウト シーケンスの最初のフリートを削除します。

グループのバージョン ロールアウトの完了を遅らせる

スコープがクラスタへの新しいバージョンのロールアウトを完了することを一時的に防止する必要がある場合は、メンテナンスの除外をターゲット バージョンにアップグレードされていないクラスタに追加できます。これにより、グループがソーク時間またはダウンストリーム グループに進むのを、最長 30 日間停止できます。30 日後にグループのソーク処理が開始されます。

そのグループのソーク時間を 30 日に変更することもできます。これにより、次のグループに進む前に、ロールアウト シーケンスの待機時間を最大化できます。

次のグループでアップグレードの開始をさらに遅らせる必要がある場合は、次のグループのクラスタにメンテナンスの除外を使用します。

シーケンスを削除する

シーケンスを削除するには、最初のグループを除く各グループのアップストリームの関連付けを削除します。最初のグループにはアップストリーム グループがありません。

これらの手順は、 Google Cloud コンソール(プレビュー版)または gcloud CLI で実行できます。

コンソール

  1. Google Cloud コンソールの [ロールアウト シーケンス] ページに移動します。

    ロールアウト シーケンスに移動

  2. [ロールアウト シーケンスのモニタリング] セクションでシーケンスを表示します。ロールアウト順序が表示されない場合は、別のロールアウト シーケンスに切り替えるか、まだ作成していない場合はロールアウト シーケンスを作成します。

  3. [ロールアウト グラフ] で、最後のフリートの要素をクリックします。

  4. [フリートを削除] をクリックします。

  5. フリートを削除するには、[削除] をクリックします。

  6. 最初のフリートだけが残るようになるまで、前の 3 つの手順を繰り返します。

gcloud

ロールアウト シーケンスの各フリート(最初のフリートを除く)のフリート ホスト プロジェクトで、次のコマンドを実行します。

gcloud container fleet clusterupgrade update --reset-upstream-fleet

トラブルシューティング

ロールアウトの適格性に関するトラブルシューティング

ロールアウト シーケンス内のすべてのクラスタでアップグレード ターゲットが同じでない場合、GKE はクラスタのアップグレードを続行できない可能性があります。アップストリーム グループがダウンストリーム グループに渡す 1 つのアップグレード ターゲットに認定されない場合、自動アップグレードを続行できません。アップストリーム グループ内のクラスタがダウンストリーム グループのクラスタに対して無効なアップグレード ターゲットになった場合も、自動アップグレードを続行できません。

ロールアウト シーケンスにロールアウトの適格性の問題があるかどうかを確認するには、ロールアウト シーケンスのステータスを確認します。グループが適格でない場合は、手順に沿ってグループ内の個々のクラスタのステータスを確認します。

クラスタのアップグレードをすぐに進めるには、部分的に適格なロールアウトを進めるの手順に沿って INELIGIBLE ステータスのクラスタを削除します。

グループ内の適格性を修正する

グループ内で、クラスタが以前のバージョンであるために不適格である場合(たとえば、グループ内のほとんどのクラスタが 1.23 から 1.24 にアップグレードされ、クラスタがバージョン 1.22 である場合)、手動でクラスタを 1.24 にアップグレードし、バージョンの不一致を解決します。

グループ内で、GKE は自動アップグレードのターゲットよりも新しいバージョンのクラスタを無視します。これらのクラスタでは、アップグレードがダウンストリーム グループに進むのを妨げません。

グループ間の適格性を修正する

グループ間で、ダウンストリーム グループが新しいバージョンであるアップグレード ターゲットで不一致がある場合(たとえば、アップストリーム グループが 1.23 から 1.24 にアップグレードされ、ダウンストリーム グループのクラスタが 1.25 の場合)、アップストリーム グループ内のクラスタを 1.25 に手動でアップグレードして、アップグレードを確実に続行します。

グループ間で、ダウンストリーム グループが以前のバージョンであるアップグレード ターゲットで不一致がある場合(たとえば、アップストリーム グループが 1.24 から 1.25 にアップグレードされ、ダウンストリーム グループのクラスタが 1.23 の場合)、ダウンストリーム グループ内のクラスタを 1.24 または 1.25 に手動でアップグレードして、アップグレードを確実に続行します。GKE がアップストリーム グループをダウンストリーム グループが有効なバージョンにアップグレードした場合、GKE はダウンストリーム グループのクラスタをそのアップグレード ターゲットにアップグレードします。この場合、シーケンスのブロックを解除するためにクラスタを手動でアップグレードする必要はありません。詳細については、アップストリーム グループがダウンストリーム グループの複数のアップグレード ターゲットを認定したをご覧ください。

部分的に適格なロールアウトを進める

ロールアウトの適格性の問題(グループ内のバージョンの不一致など)により、グループ内のクラスタのアップグレードが完了しない場合は、グループのアップグレード ターゲットに適格でないクラスタをグループから削除して、バージョンのロールアウトを完了し、ソーク時間を開始するか、ロールアウト シーケンスの次のグループに進むことができます。また、他の理由(たとえば、このクラスタの使用状況がグループ内の他のクラスタに関連していない場合)のために、グループからクラスタを削除することもできます。

フリートからクラスタの登録を解除するの手順に沿って操作します。

グループのバージョンのロールアウトが完了しない原因となっているクラスタをすべて削除すると、グループのバージョンのロールアウトが完了します。バージョンのロールアウトのステータスを確認するの手順に沿って、これを確認します。

次のステップ