次の方法で共有

Azure Kubernetes Application Network メンバーのアップグレードを構成する (プレビュー)

Important

AKS のプレビュー機能は、セルフサービスのオプトイン単位で利用できます。 プレビューは、"現状有姿のまま" および "利用可能な限度" で提供され、サービス レベル アグリーメントおよび限定保証から除外されるものとします。 AKS プレビューは、ベストエフォート ベースでカスタマー サポートによって部分的にカバーされます。 そのため、これらの機能は運用環境での使用を目的としていません。 詳細については、次のサポート記事を参照してください。

Azure Kubernetes Application Network では、マイナー バージョンのアップグレードをメンバーに適用する方法を柔軟に制御できます。 Azure Kubernetes Application Network リソースに登録されている各メンバー クラスターでは、必要な制御レベルに応じて、 セルフマネージド (SelfManaged) または フル マネージド (FullyManaged) の 2 つのアップグレード モードのいずれかを使用できます。 これらのモードはメンバー レベルで動作するため、アップグレードをクラスターごとに手動で実行するか、自動で実行するかを選択できます。

この記事では、これらのアップグレード モードの違い、Azure Kubernetes Application Network メンバー用にそれらを構成する方法、およびアップグレードを管理する際に留意すべき重要な考慮事項について説明します。

アップグレード モードに関する一般的な考慮事項

Azure Kubernetes Application Network メンバーのアップグレード モードを構成する場合は、次の制限事項と考慮事項に注意してください。

  • Azure Kubernetes Application Network のアップグレード モードは、Azure Kubernetes Application Network コンポーネントのマイナー バージョン にのみ 適用されます。 Kubernetes のバージョンやノード イメージの更新など、クラスター レベルのアップグレードを制御したり、影響を与えたり することはありません 。
  • パッチ更新プログラムは、モードに関係なく、常に自動的に適用されます。
  • 参加プロセス中に、各メンバーのアップグレード モードを選択します。 選択したモードは、Azure Kubernetes Application Network リソースから削除されるまで、そのメンバーに対して有効なままです。 最初にメンバーを削除して Azure Kubernetes Application Network リソースに再参加しないと、メンバーのアップグレード モードを変更することはできません。
  • メンバー参加中にアップグレード モードを指定しない場合、既定では SelfManaged になります。

自己管理モード

SelfManaged モードでは、アップグレードのタイミングをインストールして制御する Azure Kubernetes Application Network のマイナー バージョンを指定します。 このモードは、自動更新に依存するのではなく、マイナー アップグレード プロセスを手動で管理するシナリオを対象としています。 このモードでは、--versionが指定されていない場合、デフォルトでN-1番目の使用可能なバージョンが選択されます。 メンバー参加中にアップグレード モードが指定されていない場合も、このモードが既定です。

自己管理モードに関する考慮事項

SelfManaged モードを使用する場合は、次の点に注意してください。

  • アップグレードは、連続するマイナー バージョン間でのみ許可されます (マイナー バージョン N から N+1など)。 バージョンのスキップ ( 1.1 から 1.3 へのアップグレードなど) はサポートされていません。
  • 以前に同じクラスターにインストールされている場合は、直前のバージョン (N-1) にのみロールバックできます。 他の以前のバージョンへのロールバックはサポートされていません。
  • 複数の連続するロールバックはサポートされていません。 最大 1 つのバージョンをロールバックできます。

自己管理モードで登録し、メンバー参加中にバージョンを選択する

  • SelfManaged モードに登録し、az appnet member join パラメーターと--upgrade-mode SelfManaged パラメーターを目的のバージョンに設定した --version コマンドを使用して、メンバー参加中にバージョンを明示的に選択します。

    az appnet member join \
    --resource-group $APPNET_RG \
    --appnet-name $APPNET_NAME \
    --member-name $APPNET_MEMBER_NAME \
    --member-resource-id /subscriptions/$SUBSCRIPTION/resourcegroups/$AKS_RG/providers/Microsoft.ContainerService/managedClusters/$CLUSTER_NAME \
    --upgrade-mode SelfManaged \
    --version $VERSION

現在のバージョンを確認する

  • az appnet member show コマンドを使用してメンバーに現在インストールされているバージョンを確認し、出力で Version プロパティを参照します。

    az appnet member show --member-name $APPNET_MEMBER_NAME --appnet-name $APPNET_NAME --resource-group $APPNET_RG

利用可能なアップグレード バージョンを確認する

  • az appnet list-versions コマンドを使用して、--location パラメーターを対象のリージョンに設定して、リージョン内の各モードと Kubernetes バージョンで使用できるバージョンを確認します。 出力で、 AvailableUpgrades 列を参照して、使用可能なバージョンを確認します。

    az appnet list-versions --location $LOCATION -o table

アップグレードを開始する

  • az appnet member update パラメーターをアップグレードする目的のバージョンに設定して、--version コマンドを使用してアップグレードを開始します。

    az appnet member update --resource-group $APPNET_RG --appnet-name $APPNET_NAME --member-name $APPNET_MEMBER_NAME --version $VERSION

以前のバージョンにロールバックする

  • az appnet member update コマンドを使用して、--version パラメーターをロールバックする目的のバージョンに設定して、以前にインストールしたバージョンにロールバックします。 直前のバージョン (N-1) へのロールバックのみがサポートされることに注意してください。

    az appnet member update --resource-group $APPNET_RG --appnet-name $APPNET_NAME --member-name $APPNET_MEMBER_NAME --version $VERSION

フル マネージド モード

FullyManaged モードでは、Azure Kubernetes Application Network によって、選択したリリース チャネルに基づいて各メンバーのバージョン アップグレードが自動的に管理されます。 Azure Kubernetes Application Network で、バージョンの安定性評価、ロールアウトのタイミング、および継続的な更新を手動で操作せずに処理する場合は、このモードをお勧めします。

FullyManagedアップグレード モードを使用する場合は、メンバー クラスターが新しいバージョンを採用する速度を決定するリリース チャネルを選択します。 Azure Kubernetes Application Network は、リリースの準備状況を監視し、チャネルの安定性基準に従ってメンバーをアップグレードします。

FullyManaged モードでは、次のリリース チャネルを使用できます。

  • Rapid: 使用可能になるとすぐに、最新のアプリケーション ネットワーク バージョンを提供します。 このチャネルは、新しい機能のテストが延長された検証時間よりも優先される、非運用環境または早期の検証環境を対象としています。
  • 安定版: 追加の検証とテストを完了したバージョンを提供します。 このチャネルは運用環境を対象としており、通常はマイナー バージョンの N-1に合わせ、信頼性が向上し、以前のリリースで特定された問題に対処します。

FullyManagedモードを選択すると、stableまたはrapidするリリース チャネルを指定できます。 省略した場合、既定のチャネルは stable。

Important

FullyManaged モードでは、新しいバージョンがリリース チャネルを通じて昇格されると、Azure Kubernetes Application Network によってアップグレードが自動的に適用されます。 アップグレードのタイミングまたはバージョンの選択を手動で制御することはできません。

フル マネージド モードで使用可能なアップグレード バージョンを確認する

  • az appnet list-versions コマンドとFullyManaged モードの grep を使用して、各チャネルが特定のリージョンと Kubernetes バージョンに対応するバージョンを確認します。

    az appnet list-versions --location $LOCATION -o table | grep FullyManaged

フル マネージド モードで登録し、メンバー参加中にリリース チャネルを選択する

  • FullyManaged モードで登録し、az appnet member join パラメーターと--upgrade-mode FullyManaged パラメーターを目的のチャネルに設定した --release-channel コマンドを使用して、メンバー参加中にリリース チャネルを選択します。 次の例は、メンバー参加中に Rapid チャネルを選択する方法を示しています。

    az appnet member join \
    --resource-group $APPNET_RG \
    --appnet-name $APPNET_NAME \
    --member-name $APPNET_MEMBER_NAME \
    --member-resource-id /subscriptions/$SUBSCRIPTION/resourcegroups/$AKS_RG/providers/Microsoft.ContainerService/managedClusters/$CLUSTER_NAME \
    --upgrade-mode FullyManaged \
    --release-channel Rapid \
    --member-location $LOCATION

リリース チャネルの選択を更新する

選択したリリースはいつでも更新できます。 リリース チャネルに対する変更は直ちに有効になります。

  • az appnet member update パラメーターを目的のチャネルに設定して、--release-channel コマンドを使用して、既存のメンバーのリリース チャネル選択を更新します。 次の例は、既存のメンバーの Stable チャネルに切り替える方法を示しています。

    az appnet member update --resource-group $APPNET_RG --appnet-name $APPNET_NAME --member-name $APPNET_MEMBER_NAME --release-channel Stable

関連するコンテンツ

Azure Kubernetes Application Network の詳細については、次の記事を参照してください。

  • Last updated on