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 (非推奨 - 使用されなくなりました。代わりに 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 Base Windows Server Image Docker。

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

• AKS エンジンと Azure Stack のバージョン マッピングテーブルで、必要な AKS 基本イメージを確認します。

  「 Azure Kubernetes Services (AKS) エンジンの前提条件を Azure Stack Hub Marketplace に追加するの手順に従います。

• Kubernetes クラスター管理者 (通常は Azure Stack Hub のテナント ユーザー) は、新しい aks-engineをダウンロードする必要があります。 「 Azure Stack Hub で Linux に AKS エンジンをインストールする (または同等の Windows 記事) の手順を参照してください。 クラスターを初めてインストールしたときに使用したのと同じプロセスで実行できます。 更新プログラムは、前のバイナリを上書きします。 たとえば、 get-akse.sh スクリプトを使用した場合は、「 接続環境でのインストールに関する記事で説明されているのと同じ手順に従います。 Windows システムにインストールする場合も同じプロセスが適用されます。 Azure Stack Hub の Windows に AKS エンジンをインストール。

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 のバージョン マッピング

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

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

更新プログラムの計画

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

AKSe 0.76.0 の新機能

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

AKSe 0.75.3 以降の新機能

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-engine ツールは Azure と Azure Stack Hub 全体の共有ソース コード リポジトリであるため、多数のリリース ノートと pull request を調べると、ツールが以前に示したバージョンを超える他のバージョンの Kubernetes と OS プラットフォームをサポートしていると考える可能性があります。 これらを無視して、上記のバージョン テーブルをこの更新プログラムの公式ガイドとして使用できます。
• AKS Engine v0.67.0 では、Windows クラスターのデプロイ時に間違った Windows イメージが使用されます。 この問題を解決するには、v0.70.0 を使用します。

リファレンス

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

• https://github.com/Azure/aks-engine/releases/tag/v0.64.0
• https://github.com/Azure/aks-engine/releases/tag/v0.65.0
• https://github.com/Azure/aks-engine/releases/tag/v0.65.1
• https://github.com/Azure/aks-engine/releases/tag/v0.66.0
• https://github.com/Azure/aks-engine/releases/tag/v0.66.1
• https://github.com/Azure/aks-engine/releases/tag/v0.67.0
• https://github.com/Azure/aks-engine/releases/tag/v0.70.0
• https://github.com/Azure/aks-engine/releases/tag/v0.71.0
• https://github.com/Azure/aks-engine/releases/tag/v0.73.0
• https://github.com/Azure/aks-engine-azurestack/releases/tag/v0.75.3
• https://github.com/Azure/aks-engine-azurestack/releases/tag/v0.76.0
• https://github.com/Azure/aks-engine-azurestack/releases/tag/v0.77.0
• https://github.com/Azure/aks-engine-azurestack/releases/tag/v0.78.0
• https://github.com/Azure/aks-engine-azurestack/releases/tag/v0.79.0

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 上の 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 のバージョン マッピングテーブルで、必要な AKS 基本イメージを確認します。

  「 Azure Kubernetes Services (AKS) エンジンの前提条件を Azure Stack Hub Marketplace に追加するの手順に従います。

• Kubernetes クラスター管理者 (通常は Azure Stack Hub のテナント ユーザー) は、新しい aks-engineをダウンロードする必要があります。 「 Azure Stack Hub で Linux に AKS エンジンをインストールする (または同等の Windows 記事) の手順を参照してください。 クラスターを初めてインストールしたときに使用したのと同じプロセスで実行できます。 更新プログラムは、前のバイナリを上書きします。 たとえば、 get-akse.sh スクリプトを使用した場合は、「 接続環境でのインストールに関する記事で説明されているのと同じ手順に従います。 Windows システムにインストールする場合も同じプロセスが適用されます。 Azure Stack Hub の Windows に AKS エンジンをインストール。

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 のバージョン マッピング

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

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

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

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

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

新機能

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

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

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

既知の問題

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

リファレンス

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

• https://github.com/Azure/aks-engine/releases/tag/v0.64.0
• https://github.com/Azure/aks-engine/releases/tag/v0.65.0
• https://github.com/Azure/aks-engine/releases/tag/v0.65.1
• https://github.com/Azure/aks-engine/releases/tag/v0.66.0
• https://github.com/Azure/aks-engine/releases/tag/v0.66.1
• https://github.com/Azure/aks-engine/releases/tag/v0.67.0

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 上の 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 エージェントに必要)。

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

• Azure Stack Hub オペレーターは、新しい AKS ベース イメージをスタンプ マーケットプレースにダウンロードする必要があります。

  • 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 基本 Windows イメージ (17763.1697.210129)

    「 Azure Kubernetes Services (AKS) エンジンの前提条件を Azure Stack Hub Marketplace に追加するの手順に従います。

• Kubernetes クラスター管理者 (通常は Azure Stack Hub のテナント ユーザー) は、新しい aks-engineをダウンロードする必要があります。 「 Azure Stack Hub で Linux に AKS エンジンをインストールする (または同等の Windows 記事) の手順を参照してください。 クラスターを初めてインストールしたときに使用したのと同じプロセスで実行できます。 更新プログラムは、前のバイナリを上書きします。 たとえば、 get-akse.sh スクリプトを使用した場合は、「 接続環境でのインストールに関する記事で説明されているのと同じ手順に従います。 Windows システムにインストールする場合も同じプロセスが適用されます。 Azure Stack Hub の Windows に AKS エンジンをインストール。

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

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

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

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

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

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

新機能

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

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

• 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 の組み合わせに関するリリース ノートの完全なセットです。

• https://github.com/Azure/aks-engine/releases/tag/v0.56.0
• https://github.com/Azure/aks-engine/releases/tag/v0.56.1
• https://github.com/Azure/aks-engine/releases/tag/v0.60.0
• https://github.com/Azure/aks-engine/releases/tag/v0.60.1

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 上の 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 イメージ ディストリビューション

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

• Azure Stack Hub オペレーターは、新しい AKS ベース Ubuntu イメージをスタンプ マーケットプレースにダウンロードする必要があります。

• 名前: AKS Base Ubuntu 16.04-LTS Image Distro、2020 年 9 月 (2020.09.14)

• バージョン: 2020.09.14

  「 Azure Kubernetes Services (AKS) エンジンの前提条件を Azure Stack Hub Marketplace に追加するの手順に従います。

• Kubernetes クラスター管理者 (通常は Azure Stack Hub のテナント ユーザー) は、新しい aks-engineをダウンロードする必要があります。 「 Azure Stack Hub で Linux に AKS エンジンをインストールする (または同等の Windows 記事) の手順を参照してください。 クラスターを初めてインストールしたときに使用したのと同じプロセスで実行できます。 更新プログラムは、前のバイナリを上書きします。 たとえば、 get-akse.sh スクリプトを使用した場合は、「 接続環境でのインストールに関する記事で説明されているのと同じ手順に従います。 Windows システムにインストールする場合も同じプロセスが適用されます。 Azure Stack Hub の Windows に AKS エンジンをインストール。

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

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

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

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

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

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

新機能

• 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 を組み合わせたリリース ノートの完全なセットです。

• https://github.com/Azure/aks-engine/releases/tag/v0.51.1
• https://github.com/Azure/aks-engine/releases/tag/v0.52.1
• https://github.com/Azure/aks-engine/releases/tag/v0.53.1
• https://github.com/Azure/aks-engine/releases/tag/v0.54.1
• https://github.com/Azure/aks-engine/releases/tag/v0.55.0
• https://github.com/Azure/aks-engine/releases/tag/v0.55.4

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 を作成する予定です。
• システムの更新やスケジュールされたタスクは計画されていません。
• 運用クラスターと同じ値を使用して構成されたクラスターで段階的なアップグレードをセットアップし、運用クラスターでアップグレードを実行する前に、そこでアップグレードをテストします。

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。

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

• Azure Stack Hub オペレーターは、新しい AKS ベース イメージをスタンプ マーケットプレースにダウンロードする必要があります。

  • 名前: AKS Base Ubuntu 16.04-LTS Image Distro, March 2020

  • バージョン: 2020.03.19

    「 Azure Kubernetes Services (AKS) エンジンの前提条件を Azure Stack Hub Marketplace に追加するの手順に従います。

• Kubernetes クラスター管理者 (通常は Azure Stack Hub のテナント ユーザー) は、新しい aks-engineをダウンロードする必要があります。 「 Azure Stack Hub で Linux に AKS エンジンをインストールする (または同等の Windows 記事) の手順を参照してください。 クラスターを初めてインストールしたときに使用したのと同じプロセスで実行できます。 更新プログラムは、前のバイナリを上書きします。 たとえば、 get-akse.sh スクリプトを使用した場合は、「 接続環境でのインストールに関する記事で説明されているのと同じ手順に従います。 Windows システムにインストールする場合も同じプロセスが適用されます。 Azure Stack Hub の Windows に AKS エンジンをインストール。

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

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

新機能

• 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)。 これは、ファイル.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 を組み合わせたリリース ノートの完全なセットです。

• https://github.com/Azure/aks-engine/releases/tag/v0.44.0
• https://github.com/Azure/aks-engine/releases/tag/v0.44.1
• https://github.com/Azure/aks-engine/releases/tag/v0.44.2
• https://github.com/Azure/aks-engine/releases/tag/v0.45.0
• https://github.com/Azure/aks-engine/releases/tag/v0.46.0
• https://github.com/Azure/aks-engine/releases/tag/v0.46.1
• https://github.com/Azure/aks-engine/releases/tag/v0.46.2
• https://github.com/Azure/aks-engine/releases/tag/v0.46.3
• https://github.com/Azure/aks-engine/releases/tag/v0.47.0
• https://github.com/Azure/aks-engine/releases/tag/v0.48.0