Azure Kubernetes Fleet Manager を使用して、複数のクラスターで Kubernetes とノード イメージを更新する

1. Azure portal で、Azure Kubernetes Fleet Manager リソースに移動します。

2. サービス メニューの [設定] で、[複数のクラスターの更新]>[実行の作成] を選びます。

3. 更新実行の名前を入力し、アップグレードの種類で [1 つずつ] を選びます。

   

4. [アップグレードのスコープ] で、次のいずれかのオプションを選びます。

   • コントロール プレーンとノード プールの両方の Kubernetes バージョン
   • クラスターのコントロール プレーンのみの Kubernetes バージョン
   • ノード イメージのバージョンのみ

5. [ノード イメージ] で、次のいずれかのオプションを選びます。

   • [最新のイメージ]: 更新実行内のすべての AKS クラスターを、そのリージョンのそのクラスターで利用できる最新のイメージに更新します。
   • [一貫したイメージ]: 更新実行では、AKS クラスターが複数のリージョンに存在し、それらで利用できる最新のノード イメージが異なる可能性があります (詳しくは、リリース トラッカーに関する記事をご覧ください)。 更新の実行では、一貫性を実現するために、これらすべてのリージョンに共通の最新イメージが選択されます。

   

6. [作成] を選んで更新実行を作成します。

1. az fleet updaterun create コマンドを使い、--upgrade-type と --node-image-selection フラグの値を選んで、更新実行を作成します。 次のコマンドでは、そのリージョンで各クラスターに利用できる最新のノード イメージを使ってコントロール プレーンとノード プールの両方の Kubernetes バージョンをアップグレードする更新実行が作成されます。

   --upgrade-type フラグは、次の値をサポートします。

   • Full は、コントロール プレーンの Kubernetes バージョンとノード プールと共にノード イメージをアップグレードします。
   • ControlPlaneOnly は、クラスターのコントロール プレーンの Kubernetes バージョンのみをアップグレードします。
   • NodeImageOnly は、ノード イメージのみをアップグレードします。

   --node-image-selection フラグは、次の値をサポートします。

   • Latest: 更新実行内のすべての AKS クラスターを、そのリージョンのそのクラスターで利用できる最新のイメージに更新します。
   • Consistent: 更新実行では、AKS クラスターが複数のリージョンに存在し、それらで利用できる最新のノード イメージが異なる可能性があります (詳しくは、リリース トラッカーに関する記事をご覧ください)。 更新の実行では、一貫性を実現するために、これらすべてのリージョンに共通の最新イメージが選択されます。

   az fleet updaterun create --resource-group $GROUP --fleet-name $FLEET --name run-1 --upgrade-type Full --kubernetes-version 1.26.0 --node-image-selection Latest
   

2. az fleet updaterun start コマンドを使って更新実行を始めます。

   az fleet updaterun start --resource-group $GROUP --fleet-name $FLEET --name run-1
   

更新実行を作成する場合、更新実行の範囲を制御できます。 --upgrade-type フラグは、次の値をサポートします。

• ControlPlaneOnly は、クラスターのコントロール プレーンの Kubernetes バージョンのみをアップグレードします。
• Full は、コントロール プレーンの Kubernetes バージョンとノード プールと共にノード イメージをアップグレードします。
• NodeImageOnly は、ノード イメージのみをアップグレードします。

また、--node-image-selection フラグは、次の値をサポートします。

• [Latest] (最新): 更新の実行内のすべての AKS クラスターを、そのリージョンのそのクラスターで使用可能な最新のイメージに更新します。
• [Consistent] (一貫性): 更新の実行では、AKS クラスターが複数のリージョンに存在し、それらのリージョンでは利用可能な最新のノード イメージが異なる可能性があるためです (詳細については、リリース トラッカーを確認してください)。 更新の実行では、一貫性を実現するために、これらすべてのリージョンに共通の最新イメージが選択されます。

更新実行の開始:

更新実行を開始するには、次のコマンドを実行します。

az fleet updaterun start --resource-group $GROUP --fleet-name $FLEET --name <run-name>

1. Azure portal で、Azure Kubernetes Fleet Manager リソースに移動します。

2. サービス メニューの [設定] で、[メンバー クラスター]>[追加] を選びます。

   

3. 追加するクラスターを選んでから、[次へ: 確認と追加] を選びます。

4. クラスターを割り当てる更新グループの名前を入力してから、[追加] を選びます。

• az fleet member create コマンドを使い、--update-group フラグを更新グループの名前に設定して、メンバー クラスターをフリートに追加するときに、メンバー クラスターを更新グループに割り当てます。

  az fleet member create --resource-group $GROUP --fleet-name $FLEET --name member1 --member-cluster-id $AKS_CLUSTER_ID --update-group group-1a
  

1. Azure portal で、Azure Kubernetes Fleet Manager リソースに移動します。

2. サービス メニューの [設定] で、[メンバー クラスター] を選びます。

3. 更新グループに割り当てる 1 つまたは複数のクラスターを選んでから、[更新グループの割り当て] を選びます

   

4. クラスターを割り当てる更新グループの名前を入力してから、[割り当て] を選びます。

   

• az fleet member update コマンドを使い、--update-group フラグを更新グループの名前に設定して、既存のフリート メンバーを更新グループに割り当てます。

  az fleet member update --resource-group $GROUP --fleet-name $FLEET --name member1 --update-group group-1a
  

1. Azure portal で、Azure Kubernetes Fleet Manager リソースに移動します。

2. サービス メニューの [設定] で、[複数のクラスターの更新]>[実行の作成] を選びます。

3. 更新実行の名前を入力してから、更新シーケンスの種類として [ステージ] を選びます。

   

4. [ステージの作成] を選んでから、ステージの名前とステージ間の待ち時間を入力します。

   

5. このステージに含める更新グループを選びます。 更新グループを特定のシーケンスで更新する場合は、その順序を指定することもできます。 完了したら [作成] を選択します。

   

6. [アップグレードのスコープ] で、次のいずれかのオプションを選びます。

   • コントロール プレーンとノード プールの両方の Kubernetes バージョン
   • クラスターのコントロール プレーンのみの Kubernetes バージョン
   • ノード イメージのバージョンのみ

7. [ノード イメージ] で、次のいずれかのオプションを選びます。

   • [最新のイメージ]: 更新実行内のすべての AKS クラスターを、そのリージョンのそのクラスターで利用できる最新のイメージに更新します。
   • [一貫したイメージ]: 更新実行では、AKS クラスターが複数のリージョンに存在し、それらで利用できる最新のノード イメージが異なる可能性があります (詳しくは、リリース トラッカーに関する記事をご覧ください)。 更新の実行では、一貫性を実現するために、これらすべてのリージョンに共通の最新イメージが選択されます。

   

8. [作成] を選んで更新実行を作成します。

   更新実行を作成するたびにステージとその順序を指定すると、繰り返し作業が複雑になる可能性があります。 更新戦略を使用すると、更新実行のためのテンプレートを保存できるため、このプロセスを簡略化できます。 詳細については、更新戦略の作成と使用に関する記事を参照してください。

9. [複数のクラスターの更新] メニューで、更新実行を選んでから、[開始] を選びます。

1. 更新実行のステージとグループを定義する JSON ファイルを作成します。 ステージ ファイル (example-stages.json) からの入力の例を次に示します。

   {
       "stages": [
           {
               "name": "stage1",
               "groups": [
                   {
                       "name": "group-1a"
                   },
                   {
                       "name": "group-1b"
                   },
                   {
                       "name": "group-1c"
                   }
               ],
               "afterStageWaitInSeconds": 3600
           },
           {
               "name": "stage2",
               "groups": [
                   {
                       "name": "group-2a"
                   },
                   {
                       "name": "group-2b"
                   },
                   {
                       "name": "group-2c"
                   }
               ]
           }
       ]
   }
   

2. az fleet updaterun create コマンドを使い、--stages フラグを JSON ファイルの名前に設定し、--upgrade-type と --node-image-selection フラグで選んだ値を指定して、更新実行を作成します。 次のコマンドでは、そのリージョンで各クラスターに利用できる最新のノード イメージを使ってコントロール プレーンとノード プールの両方の Kubernetes バージョンをアップグレードする更新実行が作成されます。

   --upgrade-type フラグは、次の値をサポートします。

   • Full は、コントロール プレーンの Kubernetes バージョンとノード プールと共にノード イメージをアップグレードします。
   • ControlPlaneOnly は、クラスターのコントロール プレーンの Kubernetes バージョンのみをアップグレードします。
   • NodeImageOnly は、ノード イメージのみをアップグレードします。

   --node-image-selection フラグは、次の値をサポートします。

   • Latest: 更新実行内のすべての AKS クラスターを、そのリージョンのそのクラスターで利用できる最新のイメージに更新します。
   • Consistent: 更新実行では、AKS クラスターが複数のリージョンに存在し、それらで利用できる最新のノード イメージが異なる可能性があります (詳しくは、リリース トラッカーに関する記事をご覧ください)。 更新の実行では、一貫性を実現するために、これらすべてのリージョンに共通の最新イメージが選択されます。

   az fleet updaterun create --resource-group $GROUP --fleet-name $FLEET --name run-1 --upgrade-type Full --kubernetes-version 1.26.0 --node-image-selection Latest --stages example-stages.json
   

3. az fleet updaterun start コマンドを使って更新実行を始めます。

   az fleet updaterun start --resource-group $GROUP --fleet-name $FLEET --name run-1
   

1. [複数のクラスターの更新] ページに移動し、[戦略]>[戦略の作成] を選びます。

   

2. 更新戦略の詳細を構成してから、[作成] を選びます。

3. 後で新しい更新実行を作成するときに、その更新戦略を参照します。

   

1. az fleet updatestrategy create コマンドを使い、--stages フラグを JSON ファイルの名前に設定して、新しい更新戦略を作成します。

   az fleet updatestrategy create --resource-group $GROUP --fleet-name $FLEET --name strategy-1 --stages example-stages.json
   

2. az fleet updaterun create コマンドを使い、--update-strategy-name フラグを更新戦略の名前に設定して、更新実行を作成します。

   az fleet updaterun create --resource-group $GROUP --fleet-name $FLEET --name run-5 --update-strategy-name strategy-1 --upgrade-type NodeImageOnly --node-image-selection Consistent
   

• Fleet リソースの [複数のクラスターの更新] ページで、[未開始] または [失敗] の状態の更新実行を [開始] できます。

  

• Fleet リソースの [複数のクラスターの更新] ページで、現在 [実行中] の更新実行を [停止] できます。

  

• [未開始]、[失敗]、または [実行中] 状態の更新実行では、任意の [ステージ] を選んでアップグレードを [スキップ] できます。

  

  同様に、更新グループまたはメンバー クラスター レベルでアップグレードをスキップすることもできます。

• az fleet updaterun start コマンドを使って、未開始または失敗状態の更新実行を開始できます。

  az fleet updaterun start --resource-group $GROUP --fleet-name $FLEET --name <run-name>
  

• az fleet updaterun stop コマンドを使って、現在実行中の更新実行を停止できます。

  az fleet updaterun stop --resource-group $GROUP --fleet-name $FLEET --name <run-name>
  

• az fleet updaterun skip コマンドを使い、--targets フラグで更新ステージまたはグループは指定して、それらをスキップできます。

  az fleet updaterun skip --resource-group $GROUP --fleet-name $FLEET --name <run-name> --targets Group:my-group-name Stage:my-stage-name
  

  詳細については、更新実行状態と実行/ステージ/グループのスキップ動作の概念の概要を参照してください。

自動アップグレード プロファイルを使用して更新実行を自動化する

新しい Kubernetes またはノード イメージのバージョンが使用可能になったときに、複数のメンバー クラスターで更新実行を自動的に実行するには、自動アップグレード プロファイルを使います。

自動アップグレード プロファイルの構成について詳しくは、Azure Kubernetes Fleet Manager を使用した Kubernetes とノード イメージのアップグレードの自動化に関する記事をご覧ください。