Azure Kubernetes Fleet Manager を使用して再利用可能な更新戦略を定義する

管理者は、一連のステージとグループを定義することで、フリート管理クラスターへの更新のシーケンスを制御できます。 これらのステージとグループ内で承認と一時停止を行うタイミングを構成できます。 構成全体を更新戦略として保存でき、更新プログラムの実行や自動アップグレードとは別に管理できるため、必要に応じて戦略を再利用できます。

この記事では、グループおよびステージを使用して更新戦略を定義する方法について説明します。

前提条件

• Fleet 更新の概念の概要をお読みください。このガイドで参照する更新実行、ステージ、グループ、戦略について説明しています。

• 1 つ以上のメンバー クラスターを持つフリート リソースが存在する必要があります。 そうでない場合は、クイックスタートに従って Fleet リソースを作成し、Azure Kubernetes Service (AKS) クラスターをメンバーとして参加させます。

• 以下の環境変数を設定します。

  export GROUP=<resource-group>
  export FLEET=<fleet-name>
  export CLUSTERID=<aks-cluster-resource-id>
  export STRATEGY=<strategy-name>
  

• この記事の Azure CLI の手順に従っている場合は、Azure CLI バージョン 2.70.0 以降がインストールされている必要があります。 インストールとアップグレードについては、「Azure CLI のインストール」を参照してください。

• fleet Azure CLI 拡張機能バージョン 1.6.0 以降も必要です。これは、次のコマンドを実行してインストールできます。

  az extension add --name fleet
  

  リリースされている最新バージョンの拡張機能に更新するには、az extension update コマンドを実行します。

  az extension update --name fleet
  

戦略に合わせてクラスターを選択する

更新シーケンスを制御するために、更新戦略の各ステージとグループに含めるクラスターを選択する方法は 2 つあります。

• メンバー ラベル (推奨): 各フリート メンバーにラベルを割り当て、 memberSelector を使用してそれらのラベルでメンバーを選択します。 各メンバーは複数のラベルを持つことができます。
• 更新グループ: 各フリート メンバーに更新グループを割り当て、それらのグループ名に一致するグループを戦略で定義します。 各メンバーは、1 つのグループにのみ属できます。

メンバー セレクターを使用して更新戦略を作成する (プレビュー)

メンバー ラベルは、柔軟性が高いため、更新戦略でクラスターを選択する場合に推奨されるアプローチです。 概念の詳細については、「 メンバー ラベルを使用してクラスターをグループ化する」を参照してください。

メンバー クラスターにラベルを適用する

メンバー クラスターをフリートに追加するときにラベルを適用する

az fleet member create コマンドを使って、フリートメンバーにラベルを適用します。 次の例では、メンバー クラスターに 2 つのラベル ( env=staging と tier=frontend) を適用します。

az fleet member create \
    --resource-group $GROUP \
    --fleet-name $FLEET \
    --name member1 \
    --member-cluster-id $CLUSTERID \
    --labels "env=staging tier=frontend"

既存のフリート メンバーにラベルを適用する

az fleet member update コマンドを使用してフリート メンバーにラベルを適用する

az fleet member update \
 --resource-group $GROUP \
 --fleet-name $FLEET \
 --name member1 \
 --labels "env=staging tier=frontend"

更新戦略を作成する

更新戦略は 1 つ以上のステージで構成され、1 つのステージには、1 つ以上の更新グループを含めることができます。

1. 更新実行のステージとグループを定義する JSON ファイルを作成します。 ステージは、JSON ファイルに表示される順序で順番に実行されます。 グループは各ステージ内で並列に実行されます。 次のサンプル ファイル (example-labels-strategy.json) では、 memberSelector を使用してラベルでクラスターを選択し、オプションの maxConcurrency 設定を含む 2 つのステージを含む戦略を定義します。

   • staging ステージでは、ステージ レベルのmemberSelectorを使用して、ラベルがenv=stagingされているすべてのクラスターを選択し、1 つの暗黙的なグループを作成します。
   • production ステージでは、ステージ レベルのmemberSelectorを使用して、ラベル env=productionを使用してすべてのクラスターを事前フィルター処理し、それぞれ独自のmemberSelectorを持つ 2 つのグループを定義して、tier ラベルでクラスターを選択します。

   グループに memberSelector が設定されている場合、グループの name フィールドは状態レポートとログ記録の表示識別子としてのみ使用され、フリート メンバーの更新グループ ベースの選択には使用されなくなります。

   {
       "stages": [
           {
               "name": "staging",
               "memberSelector": { "byLabel": "env=staging" },
               "maxConcurrency": "1",
               "afterStageWaitInSeconds": 600
           },
           {
               "name": "production",
               "memberSelector": { "byLabel": "env=production" },
               "maxConcurrency": "4",
               "groups": [
                   {
                       "name": "frontend",
                       "memberSelector": { "byLabel": "tier=frontend" },
                       "maxConcurrency": "3"
                   },
                   {
                       "name": "backend",
                       "memberSelector": { "byLabel": "tier=backend" },
                       "maxConcurrency": "3"
                   }
               ]
           }
       ]
   }
   

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

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

更新グループを使用して更新戦略を作成する

クラスターは、単一の更新グループに割り当てることで、更新戦略で選択することもできます。 これらの更新グループをステージに割り当てる更新戦略を定義できます。 更新ステージ内では、更新が各更新グループに並行して適用されます。 更新グループ内では、メンバー クラスターが順番に更新されます。

クラスターを更新グループに割り当てる

フリートにメンバー クラスターを追加するときにグループに割り当てる

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

既存のフリート メンバーを更新グループに割り当てる

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

更新戦略を作成する

更新戦略は 1 つ以上のステージで構成され、1 つのステージには、1 つ以上の更新グループを含めることができます。

次のステップ

更新戦略は、手動による更新実行または自動アップグレード プロファイルの一部として使用できます。 参照:

• 方法: Azure Kubernetes Fleet Manager の更新の実行を使用して、複数のクラスターをアップグレードします。
• 方法: Azure Kubernetes Fleet Manager 更新戦略に承認を追加する。
• 方法: Azure Kubernetes Fleet Manager を使用して複数のクラスターを自動的にアップグレードします。
• マルチクラスターの更新に関する FAQ。