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

フリート

フリートベースのロールアウト シーケンスを作成するには、まずクラスタをフリートにグループ化する必要があります。フリートベースのロールアウト シーケンスの例に示すように、テスト、ステージング、本番環境などのデプロイ環境ごとにクラスタを編成できます。

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

チーム

チームベースのロールアウト シーケンスを作成するには、クラスタをチームスコープにグループ化する必要があります。これを行うには、まず、スコープベースのロールアウト シーケンスの例に示すように、テスト、ステージング、本番環境などのデプロイ環境ごとにクラスタをフリートに編成します。その後、クラスタをさまざまなチームのクラスタのスコープにさらに細分化できます。

1. シーケンスの各クラスタについて、クラスタをフリートに登録します。このクラスタのチームスコープを作成するプロジェクトのフリートにクラスタを登録する必要があります。クラスタを別のホスト プロジェクトのフリートに登録する場合は、プロジェクト間の登録に必要な権限が設定されていることを確認してください。

2. 2～3 個のチームスコープを作成して、クラスタを整理します。各スコープを、チームの各フリートのホスト プロジェクトに作成します。ロールアウト シーケンスには最大 3 つのチームスコープを設定できます。

   フラグの全一覧については、gcloud container fleet scopes create のリファレンスをご覧ください。ロールアウト シーケンスを作成する手順で、これらのフラグを create コマンドで使用できます。

3. 各クラスタをスコープに追加します。

フリート - 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. 省略可: ロールアウト シーケンスで 3 つのフリートが必要な場合は、シーケンスの 3 番目のフリートのアップストリーム フリートを設定します。

   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 に置き換えます。

フリート - コンソール

1. Google Cloud コンソールの [ロールアウトの順序付け] ページに移動します。

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

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

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

   1. [フリート 1] セクションで、シーケンスの最初のフリートを選択します。
   2. [アップストリーム フリートのソーク時間] セクションで、[日]、[時間]、[分] の各フィールドを使用して、最初のフリートのソーク時間を設定します。
   3. [フリート 2] セクションで、シーケンス内の 2 番目のフリートを選択します。
   4. [作成] をクリックします。

4. 省略可: このロールアウト シーケンスで 3 つのフリートを使用する場合は、次の追加手順を実施します。

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

フリート - 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 に置き換えます。

チーム - gcloud

これらのプロパティは、チームスコープを作成または更新するときに設定できます。次の手順では gcloud container fleet scopes update コマンドを使用しますが、gcloud container fleet scopes create コマンドを使用してチームスコープを作成するときに、同じプロパティを設定できます。

これらの各コマンドで、次のように置き換えます。

• 変数を、それぞれのチームスコープの名前またはチームスコープのフリート ホスト プロジェクト ID に置き換えます。
• SOAK_TIME は、更新するチーム スコープのソーク時間に置き換えます。

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

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

   gcloud container fleet scopes update projects/FIRST_SCOPE_PROJECT_ID/locations/global/scopes/FIRST_SCOPE_NAME \
       --default-upgrade-soaking=SOAK_TIME \
       --project=FIRST_SCOPE_PROJECT_ID
   

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

   gcloud container fleet scopes update projects/SECOND_SCOPE_PROJECT_ID/locations/global/scopes/SECOND_SCOPE_NAME \
       --upstream-scope=projects/FIRST_SCOPE_PROJECT_ID/locations/global/scopes/FIRST_SCOPE_NAME \
       --default-upgrade-soaking=SOAK_TIME \
       --project=SECOND_SCOPE_PROJECT_ID
   

3. 省略可: ロールアウトのシーケンスで 3 つのチームスコープを使用する場合は、シーケンスの 3 番目のスコープにアップストリーム スコープを設定します。

   gcloud container fleet scopes update projects/THIRD_SCOPE_PROJECT_ID/locations/global/scopes/THIRD_SCOPE_NAME \
       --upstream-scope=projects/SECOND_SCOPE_PROJECT/locations/global/scopes/SECOND_SCOPE_NAME \
       --default-upgrade-soaking=SOAK_TIME \
       --project=THIRD_SCOPE_PROJECT_ID
   

フリート

フリートベースのロールアウト シーケンスのステータスを確認します。

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

FLEET_PROJECT_ID は、シーケンスの任意のフリートのホスト プロジェクトのプロジェクト ID に置き換えます。

フラグの全一覧については、gcloud container fleet clusterupgrade describe のリファレンスをご覧ください。

チーム

チームベースのロールアウト シーケンスのステータスを確認します。

gcloud container fleet scopes describe SCOPE_NAME \
    --show-linked-cluster-upgrade
    --project=SCOPE_PROJECT_ID

SCOPE_NAME はロールアウト シーケンスの任意のスコープ名に置き換え、SCOPE_PROJECT_ID はこのチームスコープのプロジェクト ID に置き換えます。

フラグの全一覧については、gcloud container fleet scopes describe のリファレンスをご覧ください。

gcloud

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

フリート - コンソール

1. Google Cloud コンソールの [ロールアウトの順序付け] ページに移動します。

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

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

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

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

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

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

フリート - 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"
    }
  }

チーム - gcloud

このコマンドは、チームスコープのフリートのホスト プロジェクトで実行します。SCOPE_NAME は、特定のバージョンのバージョン ロールアウトに使用されるソーク時間をオーバーライドするチームスコープの名前に置き換えます。

チームスコープのソーク時間を変更します。

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

フリート - gcloud

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

次のような操作を行うことができます。

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

フリート - コンソール

1. Google Cloud コンソールの [ロールアウトの順序付け] ページに移動します。

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

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

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

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

次のような操作を行うことができます。

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

チーム - gcloud

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

次のような操作を行うことができます。

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

フリートからチーム

クラスタをフリートベースのロールアウト シーケンスからチームベースのロールアウト シーケンスに変更するには、次の手順を行います。

1. 各フリートのすべてのクラスタにメンテナンスの除外を構成し、構成の変更中にアップグレードが実施されないようにします。
2. フリート ホスト プロジェクトで GKE Enterprise が有効になっていることを確認します。
3. 各フリートで、フリート内のクラスタのグループを分割する 1 つ以上のチームスコープを作成します。
4. 各フリートの一致するチームスコープ間に 1 つ以上のロールアウト シーケンスを作成します。
5. クラスタを新しいチームスコープに追加します。
6. この変更に構成したメンテナンスの除外を削除します。

チームからフリート

クラスタをチームベースのロールアウト シーケンスからフリートベースのロールアウト シーケンスに変更するには、次の手順を行います。

1. 各フリートのすべてのクラスタにメンテナンスの除外を構成し、構成の変更中にアップグレードが実施されないようにします。
2. フリート間のロールアウト シーケンスを作成します。
3. クラスタをチームスコープから削除します。これで、これらのクラスタは、前のステップでロールアウト シーケンスに参加したスコープのそれぞれのフリートにのみ登録されます。
4. チームスコープを削除します。
5. この変更に構成したメンテナンスの除外を削除します。

フリート - gcloud

ロールアウト シーケンスの 2 番目のフリートと 3 番目のフリートのフリート ホスト プロジェクトで次のコマンドを実行します。

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

フリート - コンソール

1. Google Cloud コンソールの [ロールアウトの順序付け] ページに移動します。

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

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

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

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

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

6. 2 番目のフリートに対して、前の 3 つの手順を繰り返します。

チーム - gcloud

ロールアウト シーケンスの 2 番目のスコープと 3 番目のチームスコープのフリート ホスト プロジェクトで次のコマンドを実行します。

gcloud container fleet scopes update SCOPE_NAME --reset-upstream-scope

SCOPE_NAME は、それぞれ 2 番目と 3 番目のスコープの名前に置き換えます。