Azure Stack Hub 上の AKS エンジンのリリース ノート
[アーティクル] 2025/03/19
15 人の共同作成者
フィードバック
この記事の内容
アップグレードの考慮事項
AKS エンジンと Azure Stack のバージョン マッピング
更新プログラムの計画
次のステップ
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 を作成する予定です。
システムの更新やスケジュールされたタスクは計画されていません。
運用クラスターと同じ値を使用して構成されたクラスターで段階的なアップグレードをセットアップし、運用クラスターでアップグレードを実行する前に、そこでアップグレードをテストします。
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 クラスターをデプロイするには次のものが必要です。
aks-engine バイナリ (必須)。
AKS Base Ubuntu 16.04-LTS Image Distro (非推奨 - 使用されなくなりました。代わりに 20.04 を使用するように API モデルで変更)。
AKS Base Ubuntu 18.04-LTS Image Distro (非推奨 - 使用されなくなりました。代わりに 20.04 を使用するように API モデルで変更)。
AKS Base Ubuntu 20.04-LTS Image Distro (Linux エージェントに必要)。
AKS Base Windows Server イメージ (Windows エージェントには次のいずれかのイメージが必要です)。
コンテナー化された AKS Base Windows Server イメージ。
AKS ベースの Windows Server イメージ Docker。
これらのイメージの新しいバージョンは、この更新プログラムで利用できます。
Ubuntu 16.04 ディストリビューションで作成された Kubernetes クラスターのアップグレード
AKS Engine v0.63.0 以降では、OS の有効期間が終了したため、Ubuntu 16.04 ディストリビューションはサポートされなくなりました。 AKS エンジン v0.67.0 以降のバージョンの場合、 aks-engine アップグレードでは、サポートされていない aks-ubuntu-16.04
ディストリビューションの値が自動的に aks-ubuntu-18.04
で上書きされます。 AKS Engine v0.75.3 以降のバージョンの場合、Kubernetes v1.24 以降を使用している場合、 aks-engine-azurestack アップグレードにより、サポートされていない aks-ubuntu-16.04
ディストリビューションの値が自動的に aks-ubuntu-20.04
で上書きされます。
Ubuntu 18.04 ディストリビューションで作成された Kubernetes クラスターのアップグレード
AKS Engine v0.75.3 以降では、OS の有効期間が終了したため、Ubuntu 18.04 ディストリビューションはサポートされなくなりました。 AKS Engine v0.75.3 以降のバージョンでは、 aks-engine-azurestack アップグレードによって、サポートされていない aks-ubuntu-18.04
ディストリビューションの値が自動的に aks-ubuntu-20.04
で上書きされます。
Docker コンテナー ランタイムにより作成した Kubernetes クラスターのアップグレード
Kubernetes v1.24 では、 dockershim コンポーネントが kubelet から削除されました。 その結果、Docker コンテナー ランタイムはサポートされなくなりました。 詳細については、 Kubernetes v1.24 リリース ノート を参照してください。 AKS Engine v0.75.3 以降のバージョンでは、 aks-engine-azurestack アップグレードによって、サポートされていない docker
containerRuntime
値が自動的に containerd
で上書きされます。
AKS エンジン リリース v0.75.3 の場合、Kubernetes v1.23 上の Windows ノードを持つクラスターでは、Docker ランタイムで Windows 基本イメージを使用できます。 Kubernetes v1.24 上の Windows ノードを持つクラスターでは、コンテナー ランタイムで 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
2406
0.80.2, 0.80.3*, 0.81.1*
2408
0.80.2, 0.80.3*, 0.81.1*
サポートされています。* 詳細については、 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月19日
1.15.10、1.14.7
v0.51.0
AKS Base Ubuntu 16.04-LTS Image ディストリビューション、2020 年 5 月 (2020.05.13)、AKS Base Windows Image (17763.1217.200513)
1.15.12、1.16.8、1.16.9
Linux 、Windows
v0.55.0
AKS Base Ubuntu 16.04-LTS Image ディストリビューション、2020 年 8 月 (2020.08.24)、AKS Base Windows Image (17763.1397.200820)
1.15.12、1.16.14、1.17.11
Linux 、Windows
v0.55.4
AKS Base Ubuntu 16.04-LTS Image ディストリビューション、2020 年 9 月 (2020.09.14)、AKS Base Windows Image (17763.1397.200820)
1.15.12、1.16.14、1.17.11
Linux 、Windows
V0.60.1
AKS Base Ubuntu 16.04-LTS Image Distro,January 2021 (2021.01.28) AKS Base Ubuntu 18.04-LTS イメージ ディストリビューション、2021 Q1 (2021.01.28), AKS ベース Windows イメージ (17763.1697.210129)
1.16.14、1.16.15、1.17.17、1.18.15
Linux 、Windows
v0.63.0
AKS Base Ubuntu 18.04-LTS イメージ ディストリビューション、2021 Q2 (2021.05.24) 、AKS Base Windows イメージ (17763.1935.210520)
1.18.18、1.19.10、1.20.6
API モデルのサンプル (Linux 、Windows )
v0.67.0
AKS Base Ubuntu 18.04-LTS イメージ ディストリビューション、2021 Q3 (2021.09.27) 、AKS Base Windows イメージ (17763.2213.210927)
1.19.15、1.20.11
API モデルのサンプル (Linux 、Windows )
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 モデルのサンプル (Linux 、Windows )
v0.70.0
AKS Base Ubuntu 18.04-LTS Image Distro, 2022 Q2 (2022.04.07) , AKS Base Windows Image (17763.2565.220408)
1.21.10*, 1.22.7*
API モデルのサンプル (Linux 、Windows )
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 モデルのサンプル (Linux 、Windows )
v0.73.0
AKS Base Ubuntu 18.04-LTS Image Distro, 2022 Q4 (2022.11.02) , AKS Base Windows Image (17763.3532.221102)
1.22.15*, 1.23.13*
API モデルのサンプル (Linux 、Windows )
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 モデルのサンプル (Linux 、Windows )
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 モデルのサンプル (Linux 、Windows )
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 モデルのサンプル (Linux 、Windows )
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 モデルのサンプル (Linux 、Windows )
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 モデルのサンプル (Linux 、Windows )
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 モデルのサンプル (Linux 、Windows )
v0.80.3
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 モデルのサンプル (Linux 、Windows )
v0.81.1
AKS Base Ubuntu 20.04-LTS Image Distro (2024.311.1) 、 AKS Base Windows Server 2019 Image Containerd (17763.6414.20243111)
1.28.15**, 1.29.10**
API モデルのサンプル (Linux 、Windows )
AKS エンジン upgrade
コマンドは、クラスターのアップグレード プロセスを完全に自動化し、仮想マシン (VM)、ネットワーク、ストレージ、Kubernetes、オーケストレーション タスクを処理します。 更新プログラムを適用する前に、必ずリリース ノート情報を確認してください。
AKS Engine リリース v0.75.3 および Azure Stack Hub 上の今後のすべての AKS エンジン リリースは、新しい aks-engine-azurestack リポジトリから 。 そのため、すべての aks-engine
コマンドを aks-engine-azurestack
に置き換える必要があります。 Azure Stack Hub で最新の AKS エンジン リリースを取得するためのコマンドも変更されました。 新しいコマンドは、 Create Linux クライアント と Create 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 ノードを持つクラスターでは、コンテナー ランタイム 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 以降を使用するには:
新しい Kubernetes クラスターを初めて作成する場合 : AKS エンジンと対応するイメージ マッピング テーブルの適切なバージョンに提供されているサンプル API モデルを使用します。
新しいクラスターを作成しているが、既存の API モデルを使用する場合 : Cloud Provider for Azure の手順に従って API モデル 変更します。 新しい設定を含め失敗すると、デプロイ エラーが発生します。
ストレージ ボリュームを使用している場合 : AzureDiskCSI ドライバーを使用していることを確認します。 バージョン 0.70.0 以降では、従来のツリー内ストレージ プロバイダーではなく、CSI ドライバーのみがサポートされています。 アップグレードするには、ストレージ ボリュームの使用中にアップグレード の手順に従います 。
1 つのクラスター内に複数の Kubernetes サービスを並列にデプロイすると、基本的なロード バランサー構成でエラーが発生する可能性があります。 一度に 1 つのサービスをデプロイすることをお勧めします。
aks エンジン ツールは Azure と Azure Stack Hub 全体の共有ソース コード リポジトリであるため、多数のリリース ノートとプル要求を調べると、ツールが以前に示したバージョンを超える他のバージョンの Kubernetes および OS プラットフォームをサポートしていると考える可能性があります。 これらのテーブルは無視して、この更新プログラムの公式ガイドとして以前のバージョンのテーブルを使用できます。
AKS Engine v0.67.0 では、Windows クラスターのデプロイ時に間違った Windows イメージが使用されます。 この問題を解決するには、v0.70.0 を使用します。
Linux ノード上の chrony
デーモンは、エラー メッセージ "Could not open /dev/ptp_hyperv: No such file or directory"
で再起動できない場合があります。
この問題の回避策は、影響を受ける Linux ノードを手動で再起動することです。 この操作により、/dev/ptp_hyperv
シンボリック リンクが再生成され、chrony
デーモンが正常に再起動されます。
次の一覧は、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 を作成する予定です。
システムの更新やスケジュールされたタスクは計画されていません。
運用クラスターと同じ値を使用して構成されたクラスターで段階的なアップグレードをセットアップし、運用クラスターでアップグレードを実行する前に、そこでアップグレードをテストします。
Azure Stack Hub 上の Kubernetes クラスターのアップグレードに関する で説明されているように、 コマンドを使用する必要があります。
予期しない要因によってクラスターのアップグレードが中断されることがあります。 中断は、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 ディストリビューションはサポートされなくなりました。 クラスターをアップグレードするには、OS ディストリビューションを入力 API モデルで 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.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"
テーブルを展開する
プライベート プレビューへの参加に関心がある場合は、プレビューへのアクセスを要求 できます。
新機能は次のとおりです。
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 を作成する予定です。
システムの更新やスケジュールされたタスクは計画されていません。
運用クラスターと同じ値を使用して構成されたクラスターで段階的なアップグレードをセットアップし、運用クラスターでアップグレードを実行する前に、そこでアップグレードをテストします。
「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 クラスターをデプロイするには次のものが必要です。
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 基本イメージ
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 Base Ubuntu 16.04-LTS Image ディストリビューション、2020 年 5 月 (2020.05.13)、AKS Base Windows Image (17763.1217.200513)
1.15.12、1.16.8、1.16.9
Linux 、Windows
v0.55.0
AKS Base Ubuntu 16.04-LTS Image ディストリビューション、2020 年 8 月 (2020.08.24)、AKS Base Windows Image (17763.1397.200820)
1.15.12、1.16.14、1.17.11
Linux 、Windows
v0.55.4
AKS Base Ubuntu 16.04-LTS Image ディストリビューション、2020 年 9 月 (2020.09.14)、AKS Base Windows Image (17763.1397.200820)
1.15.12、1.16.14、1.17.11
Linux 、Windows
V0.60.1
AKS Base Ubuntu 16.04-LTS Image Distro,January 2021 (2021.01.28) AKS Base Ubuntu 18.04-LTS イメージ ディストリビューション、2021 Q1 (2021.01.28), AKS Base Windows Image (17763.1697.210129)
1.16.14、1.16.15、1.17.17、1.18.15
Linux 、Windows
プライベート プレビューへの参加に関心がある場合は、プレビューへのアクセスを要求 できます。
新機能は次のとおりです。
Ubuntu 18.04 の一般提供。
証明書ローテーション パブリック プレビュー #4214 。
T4 Nvidia GPU プライベート プレビュー #4259 。
Azure Active Directory 統合のプライベート プレビュー。
CSI Driver for Azure Blobs Private Preview #712 。
CSI Driver Azure Disks Public Preview #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 を作成する予定です。
システムの更新やスケジュールされたタスクは計画されていません。
運用クラスターと同じ値を使用して構成されたクラスターで段階的なアップグレードをセットアップし、運用クラスターでアップグレードを実行する前に、そこでアップグレードをテストします。
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 ベース 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"
テーブルを展開する
Kubernetes のバージョン
メモ
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 モデルのサンプル (Linux 、 Windows)
1.15.12、1.16.14、1.17.11
API モデルのサンプル (Linux 、 Windows)
1.15.12、1.16.14、1.17.11
API モデルのサンプル (Linux 、 Windows)
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 を組み合わせたリリース ノートの完全なセットです。
AKS エンジンのバージョン 0.48.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 Image Distro を使用していますか? これらのバージョンについては、新しい AKS ベースの Ubuntu イメージと AKS エンジンのバージョンのダウンロード に関するセクションを参照してください。
ターゲット クラスターの適切なクラスター仕様 (apimodel.json ) とリソース グループを使用していますか? 最初にクラスターをデプロイしたときに、このファイルは出力ディレクトリに生成されました。 deploy コマンドのパラメーターについては、「Kubernetes クラスターのデプロイ 」を参照してください。
信頼性の高いマシンを使用して AKS エンジンを実行し、そこからアップグレード操作を実行していますか?
クラスターに通常の負荷がかかっている前提では、アクティブなワークロードを使用して運用中のクラスターを更新する場合、ワークロードに影響を与えずにアップグレードを適用できます。 ただし、ユーザーをリダイレクトする必要がある場合に備えて、バックアップ クラスターが必要です。 バックアップ クラスターを強くお勧めします。
可能であれば、Azure Stack Hub 環境内の VM からコマンドを実行して、ネットワーク ホップと接続障害の可能性を減らします。
サブスクリプションにプロセス全体のための十分なクォータがあることを確認します。 このプロセスでは、プロセス中に新しい VM が割り当てられます。 結果として得られる VM の数は元の VM と同じになりますが、プロセス中にいくつかの VM を作成する予定です。
システムの更新やスケジュールされたタスクは計画されていません。
運用クラスターと同じ値を使用して構成されたクラスターで段階的なアップグレードをセットアップし、運用クラスターでアップグレードを実行する前に、そこでアップグレードをテストします。
Azure Stack Hub 上の Kubernetes クラスターをアップグレードする方法に記載されている通り、コマンドを使用する必要があります。
予期しない要因によってクラスターのアップグレードが中断されることがあります。 中断は、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 を参照してください。
注意
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 )。 これは、ファイル.json API モデルを解析した後、Azure Stack Hub Resource Manager を呼び出す前に発生します。
upgrade
コマンドの新しい aks-engine オプション "--control-plane-only" を使用すると、ユーザーはマスター仮想マシンのみを対象とする操作をアップグレードできます (#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 で実行することができます。
最新の February 2020 リリースでの 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 を組み合わせたリリース ノートの完全なセットです。