Azure Stack Hub 上の AKS エンジンのリリース ノート

AKS エンジンのバージョン v0.80.2 に適用されます。

この記事では、Azure Stack Hub 上の Azure Kubernetes Service (AKS) エンジンの更新プログラムの内容について説明します。 この更新プログラムには、Azure Stack Hub プラットフォームを対象とした最新リリースの AKS engine の機能強化と修正が含まれています。 この記事は、グローバル Azure の AKS エンジンのリリース情報を文書化するためのものではありません。

アップグレードの考慮事項

  • AKS エンジンのバージョンに適切なマーケットプレース項目 AKS Base Ubuntu 20.04 Image Distro または AKS Base Windows Server を使用していますか? これらのバージョンについては、「新しいイメージと AKS エンジンをダウンロードする」セクションを参照してください。
  • ターゲット クラスターに適切なクラスター仕様 (apimodel.json) とリソース グループを使用していますか? 最初にクラスターをデプロイしたときに、このファイルは出力ディレクトリに生成されました。 deploy コマンドのパラメーターについては、「Kubernetes クラスターのデプロイ」を参照してください。
  • AKS エンジンを実行してアップグレード操作を実行するために信頼できるマシンを使用していますか。
  • クラスターに通常の負荷がかかっている前提では、アクティブなワークロードを使用して運用中のクラスターを更新する場合、ワークロードに影響を与えずにアップグレードを適用できます。 ただし、ユーザーをリダイレクトする必要がある場合に備えて、バックアップ クラスターが必要です。 バックアップ クラスターを強くお勧めします。
  • 可能であれば、Azure Stack Hub 環境内の VM からコマンドを実行して、ネットワーク ホップと接続障害の可能性を減らします。
  • サブスクリプションにプロセス全体のための十分なクォータがあることを確認します。 このプロセスでは、プロセス中に新しい VM が割り当てられます。 結果として得られる VM の数は元の VM と同じになりますが、プロセス中にいくつかの VM を作成する予定です。
  • システムの更新やスケジュールされたタスクは計画されていません。
  • 運用クラスターと同じ値を使用して構成されたクラスターで段階的なアップグレードをセットアップし、運用クラスターでアップグレードを実行する前に、そこでアップグレードをテストします。

upgrade コマンドを使用する

「Azure Stack Hub での Kubernetes クラスターのアップグレード」の説明に従って、 コマンドを使用aks-engine upgradeする必要があります。

アップグレードの中断

予期しない要因によってクラスターのアップグレードが中断されることがあります。 AKS エンジンからエラーが報告されたり、AKS エンジンの実行プロセスに何かが発生したりすると、中断が発生する可能性があります。 中断の原因を調べて対処し、同じ upgrade コマンドを再送信してアップグレード プロセスを続行します。 コマンドは upgrade べき等であり、コマンドを再送信したらクラスターのアップグレードを再開する必要があります。 通常、中断によって更新が完了するまでの時間が長くなりますが、完了には影響しません。

推定アップグレード時間

アップグレードの推定時間は、クラスター内の VM あたり 12 分から 15 分です。 たとえば、20 ノード クラスターのアップグレードには約 5 時間かかる場合があります。

AKS エンジン 0.70.0 以降を使用する手順

新しいイメージと AKS エンジンをダウンロードする

AKS ベース Ubuntu イメージと AKS エンジンの新しいバージョンをダウンロードします。

Azure Stack Hub 用 AKS エンジンのドキュメントで説明されているように、Kubernetes クラスターをデプロイするには次のものが必要です。

  • aks-engine バイナリ (必須)。
  • AKS Base Ubuntu 16.04-LTS Image Distro (非推奨 - 使用されなくなりました。API モデルで代わりに 20.04 を使用するように変更)。
  • AKS Base Ubuntu 18.04-LTS Image Distro (非推奨 - 使用されなくなりました。API モデルで代わりに 20.04 を使用するように変更)。
  • AKS Base Ubuntu 20.04-LTS Image Distro (Linux エージェントに必要)。
  • AKS Base Windows Server イメージ (Windows エージェントには次のいずれかのイメージが必要です)。
    • AKS Base Windows Server Image Containerd。
    • AKS Base Windows Server Image Docker。

これらのイメージの新しいバージョンは、この更新プログラムで利用できます。

Ubuntu 16.04 ディストリビューションで作成された Kubernetes クラスターのアップグレード

AKS Engine v0.63.0 以降では、OS が有効期限に達したため、Ubuntu 16.04 ディストリビューションはサポートされなくなりました。 AKS Engine v0.67.0 以降のバージョンの場合、aks-engine のアップグレードでは、サポートされていないディストリビューション値aks-ubuntu-18.04が で自動的に上書きされますaks-ubuntu-16.04。 AKS Engine v0.75.3 以降のバージョンの場合、Kubernetes v1.24 以降を使用している場合、aks-engine-azurestack アップグレードによって、サポートされていないディストリビューション値aks-ubuntu-20.04が で自動的に上書きされますaks-ubuntu-16.04

Ubuntu 18.04 ディストリビューションで作成された Kubernetes クラスターのアップグレード

AKS Engine v0.75.3 以降では、OS が有効期限に達したため、Ubuntu 18.04 ディストリビューションはサポートされなくなりました。 AKS Engine v0.75.3 以降のバージョンでは、aks-engine-azurestack アップグレードによって、サポートされていないディストリビューション値aks-ubuntu-20.04が で自動的に上書きされますaks-ubuntu-18.04

Docker コンテナー ランタイムを使用して作成された Kubernetes クラスターのアップグレード

Kubernetes v1.24 では、 dockershim コンポーネントが kubelet から削除されました。 その結果、Docker コンテナー ランタイムはサポートされているオプションではなくなりました。 詳細については、 Kubernetes v1.24 リリース ノート を参照してください。 AKS Engine v0.75.3 以降のバージョンでは、aks-engine-azurestack アップグレードによって、サポートされていない値containerdが で自動的に上書きされますdockercontainerRuntime

AKS エンジン リリース v0.75.3 の場合、Kubernetes v1.23 上の Windows ノードを持つクラスターでは、Docker ランタイムで Windows 基本イメージを使用できます。 Kubernetes v1.24 上の Windows ノードを持つクラスターでは、Containerd ランタイムで Windows 基本イメージを使用できます。

AKS エンジンと Azure Stack のバージョン マッピング

Azure Stack Hub のバージョン AKS エンジンのバージョン
1910 0.43.0、0.43.1
2002 0.48.0、0.51.0
2005 0.48.0、0.51.0、0.55.0、0.55.4
2008 0.55.4、0.60.1
2102 0.60.1, 0.63.0, 0.67.0, 0.67.3
2108 0.63.0, 0.67.0, 0.67.3, 0.70.0, 0.71.0, 0.73.0, 0.75.3, 0.76.0
2206 0.70.0, 0.71.0, 0.73.0, 0.75.3, 0.76.0, 0.77.0
2301 0.75.3, 0.76.0, 0.77.0, 0.78.0, 0.79.0
2306 0.78.0, 0.79.0*, 0.80.2*
2311 0.80.2*

注意

*サポート。 詳細については、 AKS エンジンバージョンサポートポリシー を参照してください。

AKS エンジンと対応するイメージ マッピング

次の表に、Azure Stack Hub 上の AKS エンジンでサポートされている Kubernetes バージョンを示します。 グローバル Azure と Azure Stack Hub でサポートされているバージョンを返す aks-engine get-versions コマンドは使用しないでください。

AKS エンジン AKS 基本イメージ Kubernetes のバージョン API モデルのサンプル
v0.43.1 AKS Base Ubuntu 16.04-LTS イメージ ディストリビューション、2019 年 10 月 (2019.10.24) 1.15.5、1.15.4、1.14.8、1.14.7
v0.48.0 AKS 基本 Ubuntu 16.04-LTS イメージ ディストリビューション、2020 年 3 月 (2020.03.19) 1.15.10、1.14.7
v0.51.0 AKS 基本 Ubuntu 16.04-LTS イメージ ディストリビューション、2020 年 5 月 (2020.05.13)、AKS 基本 Windows イメージ (17763.1217.200513) 1.15.12、1.16.8、1.16.9 LinuxWindows
v0.55.0 AKS 基本 Ubuntu 16.04-LTS イメージ ディストリビューション、2020 年 8 月 (2020.08.24)、AKS 基本 Windows イメージ (17763.1397.200820) 1.15.12、1.16.14、1.17.11 LinuxWindows
v0.55.4 AKS 基本 Ubuntu 16.04-LTS イメージ ディストリビューション、2020 年 9 月 (2020.09.14)、AKS 基本 Windows イメージ (17763.1397.200820) 1.15.12、1.16.14、1.17.11 LinuxWindows
V0.60.1 AKS Base Ubuntu 16.04-LTS Image ディストリビューション、2021 年 1 月 (2021.01.28)
AKS Base Ubuntu 18.04-LTS Image ディストリビューション、2021 Q1 (2021.01.28)
AKS Base Windows Image (17763.1697.210129)
1.16.14、1.16.15、1.17.17、1.18.15 LinuxWindows
v0.63.0 AKS 基本 Ubuntu 18.04-LTS イメージ ディストリビューション、2021 Q2 (2021.05.24)AKS 基本 Windows イメージ (17763.1935.210520) 1.18.18、1.19.10、1.20.6 API モデルのサンプル (LinuxWindows)
v0.67.0 AKS 基本 Ubuntu 18.04-LTS イメージ ディストリビューション、2021 Q3 (2021.09.27)AKS 基本 Windows イメージ (17763.2213.210927) 1.19.15、1.20.11 API モデルのサンプル (LinuxWindows)
v0.67.3 AKS 基本 Ubuntu 18.04-LTS イメージ ディストリビューション、2021 Q3 (2021.09.27)AKS 基本 Windows イメージ (17763.2213.210927) 1.19.15、1.20.11 API モデルのサンプル (LinuxWindows)
v0.70.0 AKS Base Ubuntu 18.04-LTS Image Distro、2022 Q2 (2022.04.07)AKS 基本 Windows イメージ (17763.2565.220408) 1.21.10*, 1.22.7* API モデルのサンプル (LinuxWindows)
v0.71.0 AKS Base Ubuntu 18.04-LTS Image Distro, 2022 Q3 (2022.08.12), AKS Base Windows Image (17763.3232.220805) 1.22.7*, 1.23.6* API モデルのサンプル (LinuxWindows)
v0.73.0 AKS Base Ubuntu 18.04-LTS Image Distro、2022 Q4 (2022.11.02)AKS 基本 Windows イメージ (17763.3532.221102) 1.22.15*, 1.23.13* API モデルのサンプル (LinuxWindows)
v0.75.3 AKS Base Ubuntu 20.04-LTS Image Distro (2023.032.2)AKS Base Windows Server 2019 Image Docker (17763.3887.20230332)AKS Base Windows Server 2019 Image Containerd (17763.3887.20230332) 1.23.15*, 1.24.9** API モデルのサンプル (LinuxWindows)
v0.76.0 AKS Base Ubuntu 20.04-LTS Image Distro (2023.116.3)AKS Base Windows Server 2019 Image Containerd (17763.4252.20231163) 1.24.11**, 1.25.7** API モデルのサンプル (LinuxWindows)
v0.77.0 AKS Base Ubuntu 20.04-LTS Image Distro (2023.206.1)AKS Base Windows Server 2019 Image Containerd (17763.4645.20232061) 1.25.7**, 1.26.6** API モデルのサンプル (LinuxWindows)
v0.78.0 AKS Base Ubuntu 20.04-LTS Image Distro (2023.242.3)AKS Base Windows Server 2019 Image Containerd (17763.4737.20232423) 1.25.13**, 1.26.8** API モデルのサンプル (LinuxWindows)
v0.79.0 AKS Base Ubuntu 20.04-LTS Image Distro (2023.296.1)AKS Base Windows Server 2019 Image Containerd (17763.4974.20232961) 1.26.9**, 1.27.6** API モデルのサンプル (LinuxWindows)
v0.80.2 AKS Base Ubuntu 20.04-LTS Image Distro (2024.032.1)AKS Base Windows Server 2019 Image Containerd (17763.5329.20240321) 1.27.10**, 1.28.6** API モデルのサンプル (LinuxWindows)

注意

*Kubernetes v1.21 以降では、Azure Stack Hub では クラウド プロバイダー for Azure のみがサポートされています。

注意

** Kubernetes v1.24 以降では、コンテナー ランタイムのみが containerd サポートされています。 詳細については、「 Docker コンテナー ランタイムを使用して作成された Kubernetes クラスターのアップグレード 」セクションを参照してください。

計画の更新

AKS エンジン upgrade コマンドは、クラスターのアップグレード プロセスを完全に自動化し、仮想マシン (VM)、ネットワーク、ストレージ、Kubernetes、オーケストレーション タスクを処理します。 更新プログラムを適用する前に、必ずリリース ノート情報を確認してください。

AKSe 0.76.0 の新機能

  • Kubernetes v1.24.11 と v1.25.7 のサポートが追加されました。
  • その他の機能は 、v0.76.0 GitHub ページで確認できます。

AKSe 0.75.3 以降の新機能

AKS エンジン リリース v0.75.3 と、Azure Stack Hub 上のすべての将来の AKS エンジン リリースは、新しい aks-engine-azurestack リポジトリから提供されます。 そのため、すべての aks-engine コマンドを に置き換える aks-engine-azurestack必要があります。 Azure Stack Hub で最新の AKS エンジン リリースを取得するためのコマンドも変更されました。 新しいコマンドについては、「 Linux クライアントの作成 」と 「Windows クライアントの作成」を参照してください。 問題が見つかる場合 は、新しいリポジトリに 問題を作成します。

Azure Stack Hub 上の AKS エンジン リリース v0.75.3 では、Linux 基本イメージとして Ubuntu 20.04 LTS が提供されます。 このリリース以降、Ubuntu 18.04 はサポートされなくなりました。 詳細については、「 Ubuntu 18.04 Distro で作成された Kubernetes クラスターのアップグレード 」を参照してください。

Kubernetes v1.24 以降では、ランタイムのみが containerd サポートされています。 詳細については、「 Docker ランタイムを使用して作成された Kubernetes クラスターのアップグレード 」を参照してください。 AKS エンジン リリース v0.75.3 の場合、Kubernetes v1.23 上の Windows ノードを持つクラスターでは 、Docker ランタイムで Windows 基本イメージを使用できます。 Kubernetes v1.24 上の Windows ノードを持つクラスターでは、 Containerd ランタイムで Windows 基本イメージを使用できます。

その他の機能については 、v0.75.3 GitHub ページを参照してください。

AKS エンジン 0.70.0 以降を使用する手順

Microsoft では、Azure Cloud Provider をバージョン 0.70.0 にアップグレードしました。 Azure Cloud Provider は、AKS Azure と Azure Stack Hub 上の AKS エンジンとの間で共有されるコア コンポーネントです。

AKS エンジン 0.70.0 以降を使用するには:

既知の問題

  • 1 つのクラスター内に複数の Kubernetes サービスを並行してデプロイすると、基本的なロード バランサー構成でエラーが発生する可能性があります。 一度に 1 つのサービスをデプロイすることをお勧めします。
  • aks-engine ツールは Azure と Azure Stack Hub 全体で共有されるソース コード リポジトリであるため、多くのリリース ノートと pull request を調べると、このツールが前述のバージョンを超える他のバージョンの Kubernetes と OS プラットフォームをサポートしていると考える可能性があります。 これらは無視して、この更新プログラムの公式ガイドとして上記のバージョン テーブルを使用できます。
  • AKS Engine v0.67.0 では、Windows クラスターをデプロイするときに間違った Windows イメージが使用されます。 この問題を解決するには、v0.70.0 を使用します。

リファレンス

次の一覧は、Azure と Azure Stack Hub の組み合わせに関するリリース ノートの完全なセットです。

AKS エンジンのバージョン v0.67.0 に適用されます。

この記事では、Azure Stack Hub 上の Azure Kubernetes Service (AKS) エンジンの更新プログラムの内容について説明します。 この更新プログラムには、Azure Stack Hub プラットフォームを対象とした最新リリースの AKS engine の機能強化と修正が含まれています。 この記事は、グローバル Azure の AKS エンジンのリリース情報を文書化するためのものではありません。

計画の更新

AKS エンジン upgrade コマンドを使用すると、クラスターのアップグレード プロセスが完全に自動化されます。 仮想マシン (VM)、ネットワーク、ストレージ、Kubernetes、オーケストレーション タスクを処理します。 更新プログラムを適用する前に、必ずリリース ノート情報を確認してください。

アップグレードの考慮事項

  • AKS エンジンのバージョンに適切なマーケットプレース項目 AKS Base Ubuntu 16.04-LTS または 18.04 Image Distro または AKS Base Windows Server を使用していますか? これらのバージョンについては、「新しいイメージと AKS エンジンをダウンロードする」セクションを参照してください。
  • ターゲット クラスターの正しいクラスター仕様 (apimodel.json) とリソース グループを使用していますか? 最初にクラスターをデプロイしたときに、このファイルは出力ディレクトリに生成されました。 deploy コマンドのパラメーターについては、「Kubernetes クラスターのデプロイ」を参照してください。
  • 信頼性の高いマシンを使用して AKS エンジンを実行し、そこからアップグレード操作を実行していますか?
  • クラスターに通常の負荷がかかっている前提では、アクティブなワークロードを使用して運用中のクラスターを更新する場合、ワークロードに影響を与えずにアップグレードを適用できます。 ただし、ユーザーをリダイレクトする必要がある場合に備えて、バックアップ クラスターが必要です。 バックアップ クラスターを強くお勧めします。
  • 可能であれば、Azure Stack Hub 環境内の VM からコマンドを実行して、ネットワーク ホップと接続障害の可能性を減らします。
  • サブスクリプションにプロセス全体のための十分なクォータがあることを確認します。 このプロセスでは、プロセス中に新しい VM が割り当てられます。 結果として得られる VM の数は元の VM と同じになりますが、プロセス中にいくつかの VM を作成する予定です。
  • システムの更新やスケジュールされたタスクは計画されていません。
  • 運用クラスターと同じ値を使用して構成されたクラスターで段階的なアップグレードをセットアップし、運用クラスターでアップグレードを実行する前に、そこでアップグレードをテストします。

upgrade コマンドを使用する

「Azure Stack Hub での aks-engine upgradeKubernetes クラスターのアップグレード」の説明に従って、 コマンドを使用する必要があります。

アップグレードの中断

予期しない要因によってクラスターのアップグレードが中断されることがあります。 AKS エンジンがエラーを報告したり、AKS エンジンの実行プロセスに何らかの問題が発生したりすると、中断が発生する可能性があります。 中断の原因を調べて対処し、同じ upgrade コマンドを再送信してアップグレード プロセスを続行します。 コマンドは upgrade べき等であり、コマンドを再送信した後にクラスターのアップグレードを再開する必要があります。 通常、中断によって更新が完了するまでの時間が長くなりますが、完了には影響しません。

推定アップグレード時間

推定アップグレード時間は、クラスター内の VM あたり 12 分から 15 分です。 たとえば、20 ノード クラスターのアップグレードには約 5 時間かかる場合があります。

新しいイメージと AKS エンジンをダウンロードする

AKS ベース Ubuntu イメージと AKS エンジンの新しいバージョンをダウンロードします。

Azure Stack Hub 用 AKS エンジンのドキュメントで説明されているように、Kubernetes クラスターをデプロイするには次のものが必要です。

  • aks-engine バイナリ (必須)。
  • AKS Base Ubuntu 16.04-LTS Image Distro (非推奨 - 使用されなくなりました。代わりに 18.04 を使用するように API モデルで変更)。
  • AKS Base Ubuntu 18.04-LTS Image Distro (Linux エージェントに必要)。
  • AKS Base Windows Server Image Distro (Windows エージェントに必要)。

これらのイメージの新しいバージョンは、この更新プログラムで利用できます。

Ubuntu 16.04 ディストリビューションで作成された Kubernetes クラスターのアップグレード

AKS Engine v0.67.0 以降では、OS の有効期間が終了したため、Ubuntu 16.04 ディストリビューションはサポートされなくなりました。 クラスターをアップグレードするには、入力 API モデルで OS ディストリビューションを に aks-ubuntu-18.04 設定します。これは、 によって aks-engine deploy 生成され、入力として に aks-engine upgrade渡されます。

"masterProfile": {
    "distro": "aks-ubuntu-18.04"
},

"agentPoolProfiles": [{
    "distro": "aks-ubuntu-18.04"
}]

AKS エンジンと Azure Stack のバージョン マッピング

Azure Stack Hub のバージョン AKS エンジンのバージョン
1910 0.43.0、0.43.1
2002 0.48.0、0.51.0
2005 0.48.0、0.51.0、0.55.0、0.55.4
2008 0.55.4、0.60.1
2102 0 - 1000.60.1、0.63.0, 0.67.0
2108 0.63.0、0.67.0

AKS エンジン v0.67.0 の Kubernetes バージョンのアップグレード パス

次の表に、Azure Stack Hub の現在のバージョンとアップグレード バージョンを示します。 この表は、Azure Stack Hub の AKS エンジン クラスターに適用されます。 グローバル Azure と Azure Stack Hub でサポートされているバージョンを返す aks-engine get-versions コマンドは使用しないでください。

現在のバージョン 使用可能なアップグレード
1.15.12 1.16.14、1.16.15
1.16.14 1.16.15、1.17.17
1.17.11、1.17.17 1.18.18
1.18.15、1.18.18 1.19.10
1.19.10 1.19.15、1.20.11
1.20.6 1.20.11

API モデルの JSON ファイルで、 セクションでリリースとバージョンの値を orchestratorProfile 指定します。 たとえば、Kubernetes 1.17.17 をデプロイする予定の場合は、次の 2 つの値を設定する必要があります ( kubernetes-azurestack.json例を参照してください)。

-   "orchestratorRelease": "1.17",
-   "orchestratorVersion": "1.17.17"

AKS エンジンと対応するイメージ マッピング

AKS エンジン AKS 基本イメージ Kubernetes のバージョン API モデルのサンプル
v0.43.1 AKS Base Ubuntu 16.04-LTS イメージ ディストリビューション、2019 年 10 月 (2019.10.24) 1.15.5、1.15.4、1.14.8、1.14.7
v0.48.0 AKS 基本 Ubuntu 16.04-LTS イメージ ディストリビューション、2020 年 3 月 (2020.03.19) 1.15.10、1.14.7
v0.51.0 AKS 基本 Ubuntu 16.04-LTS イメージ ディストリビューション、2020 年 5 月 (2020.05.13)、AKS 基本 Windows イメージ (17763.1217.200513) 1.15.12、1.16.8、1.16.9 LinuxWindows
v0.55.0 AKS 基本 Ubuntu 16.04-LTS イメージ ディストリビューション、2020 年 8 月 (2020.08.24)、AKS 基本 Windows イメージ (17763.1397.200820) 1.15.12、1.16.14、1.17.11 LinuxWindows
v0.55.4 AKS 基本 Ubuntu 16.04-LTS イメージ ディストリビューション、2020 年 9 月 (2020.09.14)、AKS 基本 Windows イメージ (17763.1397.200820) 1.15.12、1.16.14、1.17.11 LinuxWindows
V0.60.1 AKS Base Ubuntu 16.04-LTS Image ディストリビューション、2021 年 1 月 (2021.01.28)
AKS Base Ubuntu 18.04-LTS Image ディストリビューション、2021 Q1 (2021.01.28)
AKS Base Windows Image (17763.1697.210129)
1.16.14、1.16.15、1.17.17、1.18.15 LinuxWindows
v0.63.0 AKS 基本 Ubuntu 18.04-LTS イメージ ディストリビューション、2021 Q2 (2021.05.24)AKS 基本 Windows イメージ (17763.1935.210520) 1.18.18、1.19.10、1.20.6 API モデルのサンプル (LinuxWindows)
v0.67.0 AKS 基本 Ubuntu 18.04-LTS イメージ ディストリビューション、2021 Q3 (2021.09.27)AKS 基本 Windows イメージ (17763.2213.210927) 1.19.15、1.20.11 API モデルのサンプル (LinuxWindows)

新機能

プライベート プレビューへの参加に関心がある場合は、プレビューへのアクセスを要求できます。

新機能は次のとおりです。

  • Kubernetes 1.19.15 および 1.20.11 のサポート

既知の問題

  • 1 つのクラスター内に複数の Kubernetes サービスを並行してデプロイすると、基本的なロード バランサー構成でエラーが発生する可能性があります。 一度に 1 つのサービスをデプロイすることをお勧めします。
  • aks-engine ツールは Azure と Azure Stack Hub 全体で共有されるソース コード リポジトリであるため、多くのリリース ノートと pull request を調べると、このツールが前述のバージョンを超える他のバージョンの Kubernetes と OS プラットフォームをサポートしていると考える可能性があります。 これらは無視して、この更新プログラムの公式ガイドとして上記のバージョン テーブルを使用できます。

リファレンス

次の一覧は、Azure と Azure Stack Hub の組み合わせに関するリリース ノートの完全なセットです。

AKS エンジンのバージョン v0.60.1 に適用されます。

この記事では、Azure Stack Hub 上の Azure Kubernetes Service (AKS) エンジンの更新プログラムの内容について説明します。 この更新プログラムには、Azure Stack Hub プラットフォームを対象とした最新リリースの AKS engine の機能強化と修正が含まれています。 この記事は、グローバル Azure の AKS エンジンのリリース情報を文書化するためのものではありません。

計画の更新

AKS エンジン upgrade コマンドは、クラスターのアップグレード プロセスを完全に自動化し、仮想マシン (VM)、ネットワーク、ストレージ、Kubernetes、オーケストレーション タスクを処理します。 更新プログラムを適用する前に、必ずリリース ノート情報を確認してください。

アップグレードの考慮事項

  • AKS エンジンのバージョンに適切なマーケットプレース項目 AKS Base Ubuntu 16.04-LTS または 18.04 Image Distro または AKS Base Windows Server を使用していますか? これらのバージョンについては、「新しいイメージと AKS エンジンをダウンロードする」セクションを参照してください。
  • ターゲット クラスターの正しいクラスター仕様 (apimodel.json) とリソース グループを使用していますか? 最初にクラスターをデプロイしたときに、このファイルは出力ディレクトリに生成されました。 deploy コマンドのパラメーターについては、「Kubernetes クラスターのデプロイ」を参照してください。
  • 信頼性の高いマシンを使用して AKS エンジンを実行し、そこからアップグレード操作を実行していますか?
  • クラスターに通常の負荷がかかっている前提では、アクティブなワークロードを使用して運用中のクラスターを更新する場合、ワークロードに影響を与えずにアップグレードを適用できます。 ただし、ユーザーをリダイレクトする必要がある場合に備えて、バックアップ クラスターが必要です。 バックアップ クラスターを強くお勧めします。
  • 可能であれば、Azure Stack Hub 環境内の VM からコマンドを実行して、ネットワーク ホップと接続障害の可能性を減らします。
  • サブスクリプションにプロセス全体のための十分なクォータがあることを確認します。 このプロセスでは、プロセス中に新しい VM が割り当てられます。 結果として得られる VM の数は元の VM と同じになりますが、プロセス中にいくつかの VM を作成する予定です。
  • システムの更新やスケジュールされたタスクは計画されていません。
  • 運用クラスターと同じ値を使用して構成されたクラスターで段階的なアップグレードをセットアップし、運用クラスターでアップグレードを実行する前に、そこでアップグレードをテストします。

upgrade コマンドを使用する

「Azure Stack Hub での aks-engine upgradeKubernetes クラスターのアップグレード」の説明に従って、 コマンドを使用する必要があります。

アップグレードの中断

予期しない要因によってクラスターのアップグレードが中断されることがあります。 AKS エンジンがエラーを報告したり、AKS エンジンの実行プロセスに何らかの問題が発生したりすると、中断が発生する可能性があります。 中断の原因を調べて対処し、同じ upgrade コマンドを再送信してアップグレード プロセスを続行します。 コマンドは upgrade べき等であり、コマンドを再送信した後にクラスターのアップグレードを再開する必要があります。 通常、中断によって更新が完了するまでの時間が長くなりますが、完了には影響しません。

推定アップグレード時間

推定アップグレード時間は、クラスター内の VM あたり 12 分から 15 分です。 たとえば、20 ノード クラスターのアップグレードには約 5 時間かかる場合があります。

新しいイメージと AKS エンジンをダウンロードする

AKS ベース Ubuntu イメージと AKS エンジンの新しいバージョンをダウンロードします。

Azure Stack Hub 上の AKS エンジンのドキュメントで説明されているように、Kubernetes クラスターをデプロイするには次のものが必要です。

  • aks-engine バイナリ (必須)。
  • AKS Base Ubuntu 16.04-LTS Image Distro (非推奨 - 使用されなくなりました。代わりに 18.04 を使用するように API モデルで変更)。
  • AKS Base Ubuntu 18.04-LTS Image Distro (Linux エージェントに必要)。
  • AKS Base Windows Server Image Distro (Windows エージェントに必要)。

この更新プログラムでは、これらの新しいバージョンを使用できます。

AKS エンジンと Azure Stack のバージョン マッピング

Azure Stack Hub のバージョン AKS エンジンのバージョン
1910 0.43.0、0.43.1
2002 0.48.0、0.51.0
2005 0.48.0、0.51.0、0.55.0、0.55.4
2008 0.55.4、0.60.1

AKS エンジン v0.60.1 の Kubernetes バージョンのアップグレード パス

次の表に、Azure Stack Hub の現在のバージョンとアップグレード バージョンを示します。 この表は、Azure Stack Hub の AKS エンジン クラスターに適用されます。 グローバル Azure と Azure Stack Hub でサポートされているバージョンを返す aks-engine get-versions コマンドは使用しないでください。

現在のバージョン 使用可能なアップグレード
1.15.12 1.16.14、1.16.15
1.16.14 1.16.15、1.17.17
1.17.11 1.17.17、1.18.15
1.17.17 1.18.15

API モデルの JSON ファイルで、 セクションでリリースとバージョンの値を orchestratorProfile 指定します。 たとえば、Kubernetes 1.17.17 をデプロイする予定の場合は、次の 2 つの値を設定する必要があります ( kubernetes-azurestack.json例を参照してください)。

-   "orchestratorRelease": "1.17",
-   "orchestratorVersion": "1.17.17"

AKS エンジンと対応するイメージ マッピング

AKS エンジン AKS 基本イメージ Kubernetes のバージョン API モデルのサンプル
v0.43.1 AKS Base Ubuntu 16.04-LTS イメージ ディストリビューション、2019 年 10 月 (2019.10.24) 1.15.5、1.15.4、1.14.8、1.14.7
v0.48.0 AKS 基本 Ubuntu 16.04-LTS イメージ ディストリビューション、2020 年 3 月 (2020.03.19) 1.15.10、1.14.7
v0.51.0 AKS 基本 Ubuntu 16.04-LTS イメージ ディストリビューション、2020 年 5 月 (2020.05.13)、AKS 基本 Windows イメージ (17763.1217.200513) 1.15.12、1.16.8、1.16.9 LinuxWindows
v0.55.0 AKS 基本 Ubuntu 16.04-LTS イメージ ディストリビューション、2020 年 8 月 (2020.08.24)、AKS 基本 Windows イメージ (17763.1397.200820) 1.15.12、1.16.14、1.17.11 LinuxWindows
v0.55.4 AKS 基本 Ubuntu 16.04-LTS イメージ ディストリビューション、2020 年 9 月 (2020.09.14)、AKS 基本 Windows イメージ (17763.1397.200820) 1.15.12、1.16.14、1.17.11 LinuxWindows
V0.60.1 AKS Base Ubuntu 16.04-LTS Image ディストリビューション、2021 年 1 月 (2021.01.28)
AKS Base Ubuntu 18.04-LTS Image ディストリビューション、2021 Q1 (2021.01.28)
AKS Base Windows Image (17763.1697.210129)
1.16.14、1.16.15、1.17.17、1.18.15 LinuxWindows

新機能

プライベート プレビューへの参加に関心がある場合は、プレビューへのアクセスを要求できます。

新機能は次のとおりです。

  • Ubuntu 18.04 の一般提供。
  • 証明書ローテーションパブリック プレビュー #4214
  • T4 Nvidia GPU プライベート プレビュー #4259
  • Azure Active Directory 統合のプライベート プレビュー。
  • CSI Driver for Azure Blobs Private Preview #712
  • CSI ドライバー Azure Disks パブリック プレビュー #712
  • CSI ドライバー NFS パブリック プレビュー #712
  • Kubernetes 1. 17.17 #4188 および 1.18.15 #4187

既知の問題

  • 1 つのクラスター内に複数の Kubernetes サービスを並行してデプロイすると、基本的なロード バランサー構成でエラーが発生する可能性があります。 一度に 1 つのサービスをデプロイすることをお勧めします。
  • aks-engine ツールは Azure と Azure Stack Hub 全体で共有されるソース コード リポジトリであるため、多くのリリース ノートと pull request を調べると、このツールが前述のバージョンを超える他のバージョンの Kubernetes と OS プラットフォームをサポートしていると考える可能性があります。 これらは無視して、この更新プログラムの公式ガイドとして上記のバージョン テーブルを使用できます。

リファレンス

次の一覧は、Azure と Azure Stack Hub の組み合わせに関するリリース ノートの完全なセットです。

AKS エンジンのバージョン v0.55.4 に適用されます。

この記事では、Azure Stack Hub 上の Azure Kubernetes Service (AKS) エンジンの更新プログラムの内容について説明します。 この更新プログラムには、Azure Stack Hub プラットフォームを対象とした最新リリースの AKS engine の機能強化と修正が含まれています。 この記事は、グローバル Azure の AKS エンジンのリリース情報を文書化するためのものではありません。

計画の更新

AKS エンジン upgrade コマンドは、クラスターのアップグレード プロセスを完全に自動化し、仮想マシン (VM)、ネットワーク、ストレージ、Kubernetes、オーケストレーション タスクを処理します。 更新プログラムを適用する前に、必ずリリース ノート情報を確認してください。

アップグレードの考慮事項

  • AKS エンジンのバージョンに適切なマーケットプレース項目 AKS Base Ubuntu 16.04-LTS Image Distro を使用していますか? バージョンは、「新しいイメージと AKS エンジンのダウンロード」セクションにあります。
  • ターゲット クラスターの正しいクラスター仕様 (apimodel.json) とリソース グループを使用していますか? 最初にクラスターをデプロイしたときに、このファイルは出力ディレクトリに生成されました。 deploy コマンドのパラメーターについては、「Kubernetes クラスターのデプロイ」を参照してください。
  • AKS エンジンを実行してアップグレード操作を実行するために信頼できるマシンを使用していますか。
  • クラスターに通常の負荷がかかっている前提では、アクティブなワークロードを使用して運用中のクラスターを更新する場合、ワークロードに影響を与えずにアップグレードを適用できます。 ただし、ユーザーをリダイレクトする必要がある場合に備えて、バックアップ クラスターが必要です。 バックアップ クラスターを強くお勧めします。
  • 可能であれば、Azure Stack Hub 環境内の VM からコマンドを実行して、ネットワーク ホップと接続障害の可能性を減らします。
  • サブスクリプションにプロセス全体のための十分なクォータがあることを確認します。 このプロセスでは、プロセス中に新しい VM が割り当てられます。 結果として得られる VM の数は元の VM と同じになりますが、プロセス中にいくつかの VM を作成する予定です。
  • システムの更新やスケジュールされたタスクは計画されていません。
  • 運用クラスターと同じ値を使用して構成されたクラスターで段階的なアップグレードをセットアップし、運用クラスターでアップグレードを実行する前に、そこでアップグレードをテストします。

upgrade コマンドを使用する

「Azure Stack Hub での aks-engine upgradeKubernetes クラスターのアップグレード」の説明に従って、 コマンドを使用する必要があります。

アップグレードの中断

予期しない要因によってクラスターのアップグレードが中断されることがあります。 AKS エンジンがエラーを報告したり、AKS エンジンの実行プロセスに何らかの問題が発生したりすると、中断が発生する可能性があります。 中断の原因を調べて対処し、同じ upgrade コマンドを再送信してアップグレード プロセスを続行します。 コマンドは upgrade べき等であり、コマンドを再送信した後にクラスターのアップグレードを再開する必要があります。 通常、中断によって更新が完了するまでの時間が長くなりますが、完了には影響しません。

推定アップグレード時間

推定アップグレード時間は、クラスター内の VM あたり 12 分から 15 分です。 たとえば、20 ノード クラスターのアップグレードには約 5 時間かかる場合があります。

新しいイメージと AKS エンジンをダウンロードする

AKS ベースの Ubuntu イメージと AKS エンジンの新しいバージョンをダウンロードします。

Azure Stack Hub 上の AKS エンジンのドキュメントで説明されているように、Kubernetes クラスターをデプロイするには、次の 2 つのメイン コンポーネントが必要です。

  • aks-engine バイナリ (必須)。
  • AKS 基本 Ubuntu 16.04-LTS イメージ ディストリビューション

これらのイメージの新しいバージョンは、この更新プログラムで利用できます。

AKS エンジンと Azure Stack のバージョン マッピング

Azure Stack Hub のバージョン AKS エンジンのバージョン
1910 0.43.0、0.43.1
2002 0.48.0、0.51.0
2005 0.48.0、0.51.0、0.55.0、0.55.4

AKS エンジン v0.55.4 の Kubernetes バージョンのアップグレード パス

次の表に、Azure Stack Hub の現在のバージョンとアップグレード バージョンを示します。 この表は、Azure Stack Hub の AKS エンジン クラスターに適用されます。 グローバル Azure と Azure Stack Hub でサポートされているバージョンを返す aks-engine get-versions コマンドは使用しないでください。

現在のバージョン 使用可能なアップグレード
1.15.10 1.15.12
1.15.12、1.16.8、1.16.9 1.16.14
1.16.8、1.16.9、1.16.14 1.17.11

API モデルの JSON ファイルで、 セクションでリリースとバージョンの値を orchestratorProfile 指定します。 たとえば、Kubernetes 1.17.17 をデプロイする予定の場合は、次の 2 つの値を設定する必要があります ( kubernetes-azurestack.json例を参照してください)。

    -   "orchestratorRelease": "1.16",
    -   "orchestratorVersion": "1.16.14"

AKS エンジンと対応するイメージ マッピング

Kubernetes のバージョン Notes
1.15.5、1.15.4、1.14.8、1.14.7
1.15.10、1.14.7
1.15.12、1.16.8、1.16.9 API モデルのサンプル (LinuxWindows)
1.15.12、1.16.14、1.17.11 API モデルのサンプル (LinuxWindows)
1.15.12、1.16.14、1.17.11 API モデルのサンプル (LinuxWindows)

新機能

  • Azure Stack の Linux VHD を 2020.09.14 に更新します #3828
  • Azure Stack で K8s v1.17.11 のサポートを追加します #3702
  • Azure Stack で K8s v1.16.14 のサポートを追加します #3704
  • Linux VHD を 2020.09.14 に更新します #3750
  • Windows VHD を 8 月に更新します #3730
  • Kubernetes メトリック サーバーを v0.3.7 にアップグレードします #3669
  • ログのローテーションの問題を修正するために Docker バージョンをアップグレードします #3693
  • CoreDNS を v1.7.0 にアップグレードします #3608
  • Moby 19.03.x パッケージを使用します #3549
  • azure-cni の更新戦略の修正 #3571

既知の問題

  • 1 つのクラスター内に複数の Kubernetes サービスを並行してデプロイすると、基本的なロード バランサー構成でエラーが発生する可能性があります。 一度に 1 つのサービスをデプロイすることをお勧めします。
  • aks-engine get-versionsを実行すると、出力によって Azure と Azure Stack Hub に適用できる情報が生成されますが、Azure Stack Hub に対応するものを明確に識別する方法はありません。 このコマンドを使用して、アップグレードに使用できるバージョンを特定しないでください。 前のセクションで説明したアップグレード参照テーブルを使用します。
  • aks-engine ツールは Azure と Azure Stack Hub 全体で共有されるソース コード リポジトリであるため、多くのリリース ノートと pull request を調べると、このツールが前述のバージョンを超える他のバージョンの Kubernetes と OS プラットフォームをサポートしていると考える可能性があります。 これらは無視して、この更新プログラムの公式ガイドとして上記のバージョン テーブルを使用できます。

リファレンス

これは、Azure と Azure Stack Hub を組み合わせたリリース ノートの完全なセットです。

バージョン 0.48.0 以前の AKS エンジンに適用されます。

この記事では、Azure Stack Hub 上の Azure Kubernetes Service (AKS) エンジンの更新プログラムの内容について説明します。 この更新プログラムには、Azure Stack Hub プラットフォームを対象とした最新リリースの AKS engine の機能強化と修正が含まれています。 この記事は、グローバル Azure の AKS エンジンのリリース情報を文書化するためのものではありません。

計画の更新

AKS エンジン upgrade コマンドは、クラスターのアップグレード プロセスを完全に自動化し、仮想マシン (VM)、ネットワーク、ストレージ、Kubernetes、オーケストレーション タスクを処理します。 更新プログラムを適用する前に、必ずリリース ノート情報を確認してください。

アップグレードの考慮事項

  • AKS エンジンのバージョンに適切なマーケットプレース項目 AKS Base Ubuntu 16.04-LTS Image Distro を使用していますか? これらのバージョンについては、新しい AKS ベースの Ubuntu イメージと AKS エンジンのバージョンのダウンロードに関するセクションを参照してください。
  • ターゲット クラスターの正しいクラスター仕様 (apimodel.json) とリソース グループを使用していますか? 最初にクラスターをデプロイしたときに、このファイルは出力ディレクトリに生成されました。 deploy コマンドのパラメーターについては、「Kubernetes クラスターのデプロイ」を参照してください。
  • 信頼性の高いマシンを使用して AKS エンジンを実行し、そこからアップグレード操作を実行していますか?
  • クラスターに通常の負荷がかかっている前提では、アクティブなワークロードを使用して運用中のクラスターを更新する場合、ワークロードに影響を与えずにアップグレードを適用できます。 ただし、ユーザーをリダイレクトする必要がある場合に備えて、バックアップ クラスターが必要です。 バックアップ クラスターを強くお勧めします。
  • 可能であれば、Azure Stack Hub 環境内の VM からコマンドを実行して、ネットワーク ホップと接続障害の可能性を減らします。
  • サブスクリプションにプロセス全体のための十分なクォータがあることを確認します。 このプロセスでは、プロセス中に新しい VM が割り当てられます。 結果として得られる VM の数は元の VM と同じになりますが、プロセス中にいくつかの VM を作成する予定です。
  • システムの更新やスケジュールされたタスクは計画されていません。
  • 運用クラスターと同じ値を使用して構成されたクラスターで段階的なアップグレードをセットアップし、運用クラスターでアップグレードを実行する前に、そこでアップグレードをテストします。

upgrade コマンドを使用する

「Azure Stack Hub での Kubernetes クラスターのアップグレード」の説明に従って、 コマンドを使用aks-engine upgradeする必要があります。

アップグレードの中断

予期しない要因によってクラスターのアップグレードが中断されることがあります。 AKS エンジンからエラーが報告されたり、AKS エンジンの実行プロセスに何かが発生したりすると、中断が発生する可能性があります。 中断の原因を調べて対処し、同じ upgrade コマンドを再送信してアップグレード プロセスを続行します。 コマンドは upgrade べき等であり、コマンドを再送信したらクラスターのアップグレードを再開する必要があります。 通常、中断によって更新が完了するまでの時間が長くなりますが、完了には影響しません。

推定アップグレード時間

アップグレードの推定時間は、クラスター内の VM あたり 12 分から 15 分です。 たとえば、20 ノード クラスターのアップグレードには約 5 時間かかる場合があります。

新しいイメージと AKS エンジンをダウンロードする

AKS ベースの Ubuntu イメージと AKS エンジンの新しいバージョンをダウンロードします。

Azure Stack Hub 上の AKS エンジンのドキュメントで説明されているように、Kubernetes クラスターをデプロイするには、次の 2 つのメイン コンポーネントが必要です。

  • aks-engine バイナリ (必須)。
  • AKS Base Ubuntu 16.04-LTS Image Distro。

この更新プログラムでは、これらの新しいバージョンを使用できます。

Kubernetes バージョンのアップグレード パス

次の表に、Azure Stack Hub の現在のバージョンとアップグレード バージョンを示します。 この表は、Azure Stack Hub の AKS エンジン クラスターに適用されます。 グローバル Azure と Azure Stack Hub でサポートされているバージョンを返す aks-engine get-versions コマンドは使用しないでください。

現在のバージョン 使用可能なアップグレード
1.14.7 1.15.10
1.14.8 1.15.10
1.15.4 1.15.10
1.15.5 1.15.10

新機能

  • Kubernetes バージョン 1.15.10 以降のサポート (#2834)。 新しいクラスターをデプロイする場合は、API モデル .json ファイル ( クラスター定義ファイルとも呼ばれます) で、リリース バージョン番号とマイナー バージョン番号の両方を次の形式で指定します。 クラスター定義ファイルの例については、「 kubernetes-azurestack.json」を参照してください。

    • "orchestratorRelease": "1.15,

    • "orchestratorVersion": "1.15.10"

    Note

    Kubernetes バージョンが API モデル .json ファイルで明示的に指定されていない場合、バージョン 1.15 が使用され (#2932)、orchestratorVersion の既定値は 1.15.11 になり、クラスターのデプロイ中にエラーが発生します。

  • aks-engine v0.43.1 では、受信要求の Azure Stack Hub Resource Manager しきい値制限がある場合、クラウド プロバイダーがその制御ループや他のタスクを実行するための既定の頻度設定は適切に機能しません。 この更新により Azure Stack Hub の既定値が変更され、Azure Stack Hub Resource Manager への再試行の負荷が軽減されます (#2861)。

  • aks-engine の新しい検証手順では、API モデル .json ファイルに Azure Stack Hub でサポートされていないプロパティが含まれている場合、実行が停止するか、警告が表示されます (#2717)。

  • aks-engine では、新しい検証チェックインにより、実行中の aks-engine のバージョンに必要な AKS ベース イメージのバージョンの可用性が検証されます (#2342)。 これは、API モデルをファイル.json解析した後、Azure Stack Hub Resource Managerを呼び出す前に発生します。

  • コマンドの新しい aks-engine オプション "--control-plane-only" upgrade を使用すると、ユーザーはマスター Virtual Machinesのみを対象とする操作をアップグレードできます (#2635)。

  • Ubuntu 16.04-LTS 用の Linux カーネル バージョン 4.15.0-1071-azure への更新。 詳細については、「パッケージ: linux-image-4.15.0-1071-azure (4.15.0-1071.76) security」を参照してください。

  • Kubernetes バージョン 1.14.8 および 1.15.10 をサポートする新しい hyperkube 更新プログラム。

  • クラスターの Kubernetes のバージョンと一致するように kubectl を更新します。 このコンポーネントは Kubernetes クラスターのコントロール プレーン ノードで使用できます。これはマスターへの SSH で実行することができます。

  • 最新の 2020 年 2 月リリースの Azure Container Monitor アドインの更新 (#2850)。

  • coredns をバージョン v1.6.6 にアップグレードします (#2555)。

  • etcd をバージョン 3.3.18 にアップグレードします (#2462)。

  • moby をバージョン 3.0.11 にアップグレードします (#2887)。

  • このリリースでは、AKS エンジンは k8s.gcr.io からの依存関係をなくし、イメージの構築時に公式の Kubernetes MCR registry @ mcr.microsoft.com を使用するようになりました (#2722)。

既知の問題

  • 1 つのクラスター内に複数の Kubernetes サービスを並行してデプロイすると、基本的なロード バランサー構成でエラーが発生する可能性があります。 一度に 1 つのサービスをデプロイすることをお勧めします。
  • aks-engine get-versions を実行すると、Azure と Azure Stack Hub に適用可能な情報が生成されますが、Azure Stack Hub に対応するものを明確に識別する方法はありません。 このコマンドを使用して、アップグレードに使用できるバージョンを特定しないでください。 前のセクションで説明したアップグレード参照テーブルを使用します。
  • aks-engine ツールは Azure と Azure Stack Hub 全体の共有ソース コード リポジトリであるため、多くのリリース ノートと pull request を調べると、ツールが以前にリストしたバージョン以外の Kubernetes と OS プラットフォームをサポートしていると考える可能性があります。 これらを無視して、この更新プログラムの公式ガイドとして上記のバージョン テーブルを使用できます。

リファレンス

修正されたバグの一部と、バージョン 0.44.0 からバージョン 0.48.0 までのリリース ノートの完全なセットを次に示します。 リリース ノートには、Azure と Azure Stack Hub の両方が含まれています。

バグの修正

  • userAssignedIdentityId Windows azure.json 引用符がありません (#2327)

  • アドインは update config アップグレード専用です (#2282)

  • Windows ノードで管理 IP を取得するためのバンプ タイムアウト (#2284)

  • Windows VHD に 1.0.28 Azure CNI .zip ファイルを追加 (#2268)

  • 設定 IPAddressCount の正しい既定の順序 (#2358)

  • 手動エラーや保守容易性を回避するために、すべての K8s バージョンに単一の omsagent yaml を使用するように更新 (#2692)

リリース ノート

これは、Azure と Azure Stack Hub を組み合わせたリリース ノートの完全なセットです。

次の手順