共用方式為

Azure Stack Hub 上的 AKS 引擎版本資訊

  • 發行項

適用於 AKS 引擎 v0.80.2 版。

本文說明 Azure Stack Hub 更新上的 Azure Kubernetes Service （AKS） 引擎內容。 此更新包含最新版以 Azure Stack Hub 平台為目標之 AKS 引擎的改進和修正。 本文不適用於記載適用於全域 Azure 的 AKS 引擎版本資訊。

升級考量

  • 您是否針對您的 AKS 引擎版本使用正確的市集專案 AKS Base Ubuntu 20.04 Image Distro 或 AKS Base Windows Server？ 您可以在下載新映像和 AKS 引擎一節中找到版本。
  • 您是否使用目標叢集的正確叢集規格 （apimodel.json） 和資源群組？ 當您最初部署叢集時，此檔案會在輸出目錄中產生。 請參閱部署命令參數 部署 Kubernetes 叢集。
  • 您是否使用可靠的機器來執行 AKS 引擎，以及執行升級作業的來源？
  • 如果您要更新具有作用中工作負載的作業叢集，您可以套用升級而不會影響它們，假設叢集處於正常負載之下。 不過，如果您有備份叢集，以防需要將使用者重新導向至該叢集。 強烈建議使用備份叢集。
  • 可能的話，請從 Azure Stack Hub 環境內的 VM 執行 命令，以減少網路躍點和潛在的連線失敗。
  • 請確定您的訂用帳戶有足夠的配額可供整個程式使用。 進程會在程式期間配置新的 VM。 產生的 VM 數目會與原始 VM 相同，但請規劃在程式期間建立更多 VM。
  • 未規劃任何系統更新或排程的工作。
  • 在設定與生產叢集相同值的叢集上設定分段升級，並在生產叢集中執行此升級之前先測試升級。

使用升級命令

您必須使用 命令，aks-engine upgrade如升級 Azure Stack Hub 上的 Kubernetes 叢集中所述。

升級中斷

有時候非預期的因素會中斷叢集的升級。 當 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 映射散發版本 （已淘汰 - 不再使用，請改為在 API 模型中變更為使用 20.04）。
  • AKS Base Ubuntu 18.04-LTS 映射散發版本 （已淘汰 - 不再使用，API 模型變更為改用 20.04）。
  • AKS Base Ubuntu 20.04-LTS 映射散發版本（Linux 代理程式所需）。
  • AKS 基礎 Windows Server 映射（Windows 代理程式需要下列其中一個映射）：
    • AKS 基底 Windows Server 映像容器。
    • AKS 基礎 Windows Server 映射 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 引擎。

升級使用Ubuntu16.04散發版本建立的 Kubernetes 叢集

從 AKS 引擎 v0.63.0 開始，Ubuntu 16.04 散發版本已不再是支援的選項，因為 OS 已達到其生命周期結束。 針對 AKS 引擎 v0.67.0 或更新版本，aks-engine 升級會自動使用 aks-ubuntu-18.04覆寫不支援的aks-ubuntu-16.04散發版本值。 針對 AKS 引擎 v0.75.3 或更新版本，如果您使用 Kubernetes v1.24 或更新版本，aks-engine-azurestack 升級會自動以 aks-ubuntu-20.04覆寫不支援的aks-ubuntu-16.04散發版本值。

升級使用Ubuntu18.04散發版本建立的 Kubernetes 叢集

從 AKS 引擎 v0.75.3 開始，Ubuntu 18.04 散發版本已不再是支援的選項，因為 OS 已達到其生命周期結束。 針對 AKS 引擎 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 引擎 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*
2406 0.80.2*

注意

支援。* 如需詳細資訊， 請參閱 AKS 引擎版本支持原則 。

AKS 引擎和對應的影像對應

您可以在下表中找到 Azure Stack Hub 上 AKS 引擎支援的 Kubernetes 版本。 請勿使用 aks-engine get-versions 命令，它會傳回全域 Azure 和 Azure Stack Hub 中支援的版本。

AKS 引擎 AKS 基底映像 Kubernetes 版本 API 模型範例
v0.43.1 AKS 基礎 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 映射散發版本，2020 年 5 月 （2020.05.13）， AKS 基礎 Windows 映射 （17763.1217.200513） 1.15.12、1.16.8、1.16.9 Linux、Windows
v0.55.0 AKS Base Ubuntu 16.04-LTS 映射散發版本，2020 年 8 月 （2020.08.24）， AKS 基礎 Windows 映射 （17763.1397.200820） 1.15.12、1.16.14、1.17.11 Linux、Windows
v0.55.4 AKS Base Ubuntu 16.04-LTS 映射散發版本，2020 年 9 月 （2020.09.14），AKS 基礎 Windows 映射 （17763.1397.200820） 1.15.12、1.16.14、1.17.11 Linux、Windows
V0.60.1 AKS Base Ubuntu 16.04-LTS 映射散發版本，2021 年 1 月 （2021.01.28），
AKS Base Ubuntu 18.04-LTS 映射散發版本，2021 年第 1 季 （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 年第 2 季 （2021.05.24）， AKS 基礎 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 年第 3 季 （2021.09.27）， AKS 基礎 Windows 映射 （17763.2213.210927） 1.19.15、1.20.11 API 模型範例（Linux、 Windows）
v0.67.3 AKS Base Ubuntu 18.04-LTS 映射散發版本，2021 年第 3 季 （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 映射散發版本、2022 年第 2 季 （2022.04.07）、 AKS 基礎 Windows 映射 （17763.2565.220408） 1.21.10*, 1.22.7* API 模型範例（Linux、 Windows）
v0.71.0 AKS Base Ubuntu 18.04-LTS 映射散發版本、2022 Q3 （2022.08.12）、 AKS 基礎 Windows 映射 （17763.3232.220805） 1.22.7*, 1.23.6* API 模型範例（Linux、 Windows）
v0.73.0 AKS Base Ubuntu 18.04-LTS 映射散發版本，2022 年第 4 季 （2022.11.02）， AKS 基礎 Windows 映射 （17763.3532.221102） 1.22.15*, 1.23.13* API 模型範例（Linux、 Windows）
v0.75.3 AKS Base Ubuntu 20.04-LTS 映射散發版本 （2023.032.2）， AKS 基礎 Windows Server 2019 映射 Docker （17763.3887.20230332）、 AKS 基礎 Windows Server 2019 映射容器（17763.3887.20230332） 1.23.15*, 1.24.9** API 模型範例（Linux、 Windows）
v0.76.0 AKS Base Ubuntu 20.04-LTS 映射散發版本 （2023.116.3）、 AKS 基礎 Windows Server 2019 映射容器 （17763.4252.20231163） 1.24.11**, 1.25.7** API 模型範例（Linux、 Windows）
v0.77.0 AKS Base Ubuntu 20.04-LTS 映射散發版本 （2023.206.1）、 AKS 基礎 Windows Server 2019 映射容器 （17763.4645.20232061） 1.25.7**, 1.26.6** API 模型範例（Linux、 Windows）
v0.78.0 AKS Base Ubuntu 20.04-LTS 映射散發版本 （2023.242.3）、 AKS 基礎 Windows Server 2019 映射容器 （17763.4737.20232423） 1.25.13**, 1.26.8** API 模型範例（Linux、 Windows）
v0.79.0 AKS Base Ubuntu 20.04-LTS 映射散發版本 （2023.296.1）、 AKS 基礎 Windows Server 2019 映射容器 （17763.4974.20232961） 1.26.9**, 1.27.6** API 模型範例（Linux、 Windows）
v0.80.2 AKS Base Ubuntu 20.04-LTS 映射散發版本 （2024.032.1）、 AKS 基礎 Windows Server 2019 映射容器 （17763.5329.20240321） 1.27.10**, 1.28.6** API 模型範例（Linux、 Windows）

注意

*從 Kubernetes v1.21 開始，Azure Stack Hub 僅 支援適用於 Azure 的雲端提供者。

注意

** 從 Kubernetes v1.24 開始，僅 containerd 支援容器運行時間。 如需詳細資訊，請參閱升級以 Docker 容器運行時間建立的 Kubernetes 叢集一節。

更新規劃

AKS 引擎 upgrade 命令會完全自動化叢集的升級程式，並處理虛擬機、網路、記憶體、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 提供 Ubuntu 20.04 LTS 作為其 Linux 基底映射。 從此版本開始，不再支援Ubuntu18.04。 如需詳細資訊，請參閱 升級以Ubuntu18.04散發版本 建立的 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 0.70.0 版升級了 Azure 雲端提供者。 Azure 雲端提供者是 Azure Stack Hub 上 AKS Azure 與 AKS 引擎之間共用的核心元件。

若要使用 AKS 引擎 0.70.0 和更新版本：

  • 如果您第一次嘗試建立新的 Kubernetes 叢集：請使用 AKS 引擎中針對適當版本 提供的範例 API 模型，以及對應的映像對應 數據表。

  • 如果您要建立新的叢集，但想要使用現有的 API 模型：遵循 適用於 Azure 的雲端提供者指示來修改 API 模型。 無法包含新的設定會導致部署錯誤。

  • 如果您使用記憶體磁碟區：請確定您使用的是 AzureDiskCSI 驅動程式。 0.70.0 版和更新版本僅支援 CSI 驅動程式，而不是舊版樹狀結構內儲存提供者。 若要升級，請在使用記憶體磁碟區時，遵循升級中的指示。

已知問題

  • 在單一叢集內平行部署多個 Kubernetes 服務，可能會導致基本負載平衡器組態發生錯誤。 我們建議一次部署一個服務。
  • 由於 aks-engine 工具是跨 Azure 和 Azure Stack Hub 的共用原始程式碼存放庫，因此檢查許多版本資訊和提取要求，可能會導致您相信此工具支援先前列出的其他 Kubernetes 和 OS 平臺版本。 您可以忽略它們，並使用上述版本表作為此更新的官方指南。
  • AKS 引擎 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 引擎的改進和修正。 本文不適用於記載適用於全域 Azure 的 AKS 引擎版本資訊。

更新規劃

AKS 引擎 upgrade 命令會完全自動化叢集的升級程式。 它會處理虛擬機（VM）、網路、記憶體、Kubernetes 和協調流程工作。 套用更新之前，請務必檢閱版本附註資訊。

升級考量

  • 您是否針對您的 AKS 引擎版本使用正確的市集專案、AKS Base Ubuntu 16.04-LTS 或 18.04 Image Distro 或 AKS Base Windows Server？ 您可以在「下載新映像和 AKS 引擎」一節中找到版本。
  • 您是否使用目標叢集的正確叢集規格 （apimodel.json） 和資源群組？ 當您最初部署叢集時，此檔案會在輸出目錄中產生。 請參閱部署命令參數 部署 Kubernetes 叢集。
  • 您是否使用可靠的電腦來執行 AKS 引擎，以及執行升級作業的來源？
  • 如果您要更新具有作用中工作負載的作業叢集，您可以套用升級而不會影響它們，假設叢集處於正常負載之下。 不過，如果您有備份叢集，以防需要將使用者重新導向至該叢集。 強烈建議使用備份叢集。
  • 可能的話，請從 Azure Stack Hub 環境內的 VM 執行 命令，以減少網路躍點和潛在的連線失敗。
  • 請確定您的訂用帳戶有足夠的配額可供整個程式使用。 進程會在程式期間配置新的 VM。 產生的 VM 數目會與原始 VM 相同，但請規劃在程式期間建立更多 VM。
  • 未規劃任何系統更新或排程的工作。
  • 在設定與生產叢集相同值的叢集上設定分段升級，並在生產叢集中執行此升級之前先測試升級。

使用升級命令

您必須使用 命令，aks-engine upgrade如升級 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 映射散發版本（已淘汰 - 不再使用，API 模型中的變更改為使用 18.04）。
  • AKS Base Ubuntu 18.04-LTS 映射散發版本（Linux 代理程式所需）。
  • AKS 基礎 Windows Server 映像散發版本 （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 引擎。

升級使用Ubuntu16.04散發版本建立的 Kubernetes 叢集

從 AKS 引擎 v0.67.0 開始，Ubuntu 16.04 散發版本已不再是支援的選項，因為 OS 已達到其生命周期結束。 若要升級叢集，請務必將輸入 API 模型中的 OS 散發版本設定為 aks-ubuntu-18.04 ，而產生的 aks-engine deploy OS 散發版本會作為輸入傳遞至 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 引擎叢集。 請勿使用 aks-engine get-versions 命令，它會傳回全域 Azure 和 Azure Stack Hub 中支援的版本。

目前的版本 可用的升級
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，則必須設定下列兩個值（請參閱 範例kubernetes-azurestack.json）：

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

AKS 引擎和對應的影像對應

AKS 引擎 AKS 基底映像 Kubernetes 版本 API 模型範例
v0.43.1 AKS 基礎 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 映射散發版本，2020 年 5 月 （2020.05.13）， AKS 基礎 Windows 映射 （17763.1217.200513） 1.15.12、1.16.8、1.16.9 Linux、Windows
v0.55.0 AKS Base Ubuntu 16.04-LTS 映射散發版本，2020 年 8 月 （2020.08.24）， AKS 基礎 Windows 映射 （17763.1397.200820） 1.15.12、1.16.14、1.17.11 Linux、Windows
v0.55.4 AKS Base Ubuntu 16.04-LTS 映射散發版本，2020 年 9 月 （2020.09.14），AKS 基礎 Windows 映射 （17763.1397.200820） 1.15.12、1.16.14、1.17.11 Linux、Windows
V0.60.1 AKS Base Ubuntu 16.04-LTS 映射散發版本，2021 年 1 月 （2021.01.28），
AKS Base Ubuntu 18.04-LTS 映射散發版本，2021 年第 1 季 （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 年第 2 季 （2021.05.24）， AKS 基礎 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 年第 3 季 （2021.09.27）， AKS 基礎 Windows 映射 （17763.2213.210927） 1.19.15、1.20.11 API 模型範例（Linux、 Windows）

最新功能

如果您有興趣參與私人預覽，您可以 要求預覽存取權。

新功能包括：

  • Kubernetes 1.19.15 和 1.20.11 的支援

已知問題

  • 在單一叢集內平行部署多個 Kubernetes 服務，可能會導致基本負載平衡器組態發生錯誤。 我們建議一次部署一個服務。
  • 由於 aks-engine 工具是跨 Azure 和 Azure Stack Hub 的共用原始程式碼存放庫，因此檢查許多版本資訊和提取要求，可能會導致您相信此工具支援先前列出的其他 Kubernetes 和 OS 平臺版本。 您可以忽略它們，並使用上述版本表作為此更新的官方指南。

參考

下列清單是結合 Azure 和 Azure Stack Hub 的完整版本資訊集：

適用於 AKS 引擎 v0.60.1 版。

本文說明 Azure Stack Hub 更新上的 Azure Kubernetes Service （AKS） 引擎內容。 此更新包含最新版以 Azure Stack Hub 平台為目標之 AKS 引擎的改進和修正。 本文不適用於記載適用於全域 Azure 的 AKS 引擎版本資訊。

更新規劃

AKS 引擎 upgrade 命令會完全自動化叢集的升級程式，並處理虛擬機、網路、記憶體、Kubernetes 和協調流程工作。 套用更新之前，請務必檢閱版本附註資訊。

升級考量

  • 您是否針對您的 AKS 引擎版本使用正確的市集專案、AKS Base Ubuntu 16.04-LTS 或 18.04 Image Distro 或 AKS Base Windows Server？ 您可以在「下載新映像和 AKS 引擎」一節中找到版本。
  • 您是否使用目標叢集的正確叢集規格 （apimodel.json） 和資源群組？ 當您最初部署叢集時，此檔案會在輸出目錄中產生。 請參閱部署命令參數 部署 Kubernetes 叢集。
  • 您是否使用可靠的電腦來執行 AKS 引擎，以及執行升級作業的來源？
  • 如果您要更新具有作用中工作負載的作業叢集，您可以套用升級而不會影響它們，假設叢集處於正常負載之下。 不過，如果您有備份叢集，以防需要將使用者重新導向至該叢集。 強烈建議使用備份叢集。
  • 可能的話，請從 Azure Stack Hub 環境內的 VM 執行 命令，以減少網路躍點和潛在的連線失敗。
  • 請確定您的訂用帳戶有足夠的配額可供整個程式使用。 進程會在程式期間配置新的 VM。 產生的 VM 數目會與原始 VM 相同，但請規劃在程式期間建立更多 VM。
  • 未規劃任何系統更新或排程的工作。
  • 在設定與生產叢集相同值的叢集上設定分段升級，並在生產叢集中執行此升級之前先測試升級。

使用升級命令

您必須使用 命令，aks-engine upgrade如升級 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 映射散發版本（已淘汰 - 不再使用，API 模型中的變更改為使用 18.04）。
  • AKS Base Ubuntu 18.04-LTS 映射散發版本（Linux 代理程式所需）。
  • AKS 基礎 Windows Server 映像散發版本 （Windows 代理程式所需）。

此更新提供這些新版本：

  • Azure Stack Hub 操作員必須將新的 AKS 基底映射下載到戳記市集：

    • AKS 基底 Ubuntu 16.04-LTS 映像散發版本 2021 年 1 月 (2021.01.28)

    • AKS Base Ubuntu 18.04-LTS 映射散發版本，2021 年第 1 季 （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 版本對應

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 引擎叢集。 請勿使用 aks-engine get-versions 命令，它會傳回全域 Azure 和 Azure Stack Hub 中支援的版本。

目前的版本 可用的升級
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，則必須設定下列兩個值（請參閱 範例kubernetes-azurestack.json）：

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

AKS 引擎和對應的影像對應

AKS 引擎 AKS 基底映像 Kubernetes 版本 API 模型範例
v0.43.1 AKS 基礎 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 映射散發版本，2020 年 5 月 （2020.05.13）， AKS 基礎 Windows 映射 （17763.1217.200513） 1.15.12、1.16.8、1.16.9 Linux、Windows
v0.55.0 AKS Base Ubuntu 16.04-LTS 映射散發版本，2020 年 8 月 （2020.08.24）， AKS 基礎 Windows 映射 （17763.1397.200820） 1.15.12、1.16.14、1.17.11 Linux、Windows
v0.55.4 AKS Base Ubuntu 16.04-LTS 映射散發版本，2020 年 9 月 （2020.09.14），AKS 基礎 Windows 映射 （17763.1397.200820） 1.15.12、1.16.14、1.17.11 Linux、Windows
V0.60.1 AKS Base Ubuntu 16.04-LTS 映射散發版本，2021 年 1 月 （2021.01.28），
AKS Base Ubuntu 18.04-LTS 映射散發版本，2021 年第 1 季 （2021.01.28），
AKS 基底 Windows 映像 (17763.1697.210129)		 1.16.14、1.16.15、1.17.17、1.18.15 Linux、Windows

最新功能

如果您有興趣參與私人預覽，您可以 要求預覽存取權。

新功能包括：

  • Ubuntu 18.04 正式運作。
  • 憑證輪替公開預覽 #4214。
  • T4 Nvidia GPU Private Preview #4259。
  • Azure Active Directory 整合私人預覽版。
  • 適用於 Azure Blob 的 CSI 驅動程式私人預覽 版 #712。
  • CSI 驅動程式 Azure 磁碟公開預覽 #712。
  • CSI 驅動程式 NFS 公開預覽 #712。
  • 支援 Kubernetes 1。 17.17 #4188 和 1.18.15 #4187。

已知問題

  • 在單一叢集內平行部署多個 Kubernetes 服務，可能會導致基本負載平衡器組態發生錯誤。 我們建議一次部署一個服務。
  • 由於 aks-engine 工具是跨 Azure 和 Azure Stack Hub 的共用原始程式碼存放庫，因此檢查許多版本資訊和提取要求，可能會導致您相信此工具支援先前列出的其他 Kubernetes 和 OS 平臺版本。 您可以忽略它們，並使用上述版本表作為此更新的官方指南。

參考

下列清單是結合 Azure 和 Azure Stack Hub 的完整版本資訊集：

適用於 AKS 引擎 v0.55.4 版。

本文說明 Azure Stack Hub 更新上的 Azure Kubernetes Service （AKS） 引擎內容。 此更新包含最新版以 Azure Stack Hub 平台為目標之 AKS 引擎的改進和修正。 本文不適用於記載適用於全域 Azure 的 AKS 引擎版本資訊。

更新規劃

AKS 引擎 upgrade 命令會完全自動化叢集的升級程式，並處理虛擬機、網路、記憶體、Kubernetes 和協調流程工作。 套用更新之前，請務必檢閱版本附註資訊。

升級考量

  • 您是否針對您的 AKS 引擎版本使用正確的市集專案 AKS Base Ubuntu 16.04-LTS 映像散發版本？ 您可以在 [下載新映像和 AKS 引擎] 區段中找到版本。
  • 您是否使用目標叢集的正確叢集規格 （apimodel.json） 和資源群組？ 當您最初部署叢集時，此檔案會在輸出目錄中產生。 請參閱部署命令參數 部署 Kubernetes 叢集。
  • 您是否使用可靠的機器來執行 AKS 引擎，以及執行升級作業的來源？
  • 如果您要更新具有作用中工作負載的作業叢集，您可以套用升級而不會影響它們，假設叢集處於正常負載之下。 不過，如果您有備份叢集，以防需要將使用者重新導向至該叢集。 強烈建議使用備份叢集。
  • 可能的話，請從 Azure Stack Hub 環境內的 VM 執行 命令，以減少網路躍點和潛在的連線失敗。
  • 請確定您的訂用帳戶有足夠的配額可供整個程式使用。 進程會在程式期間配置新的 VM。 產生的 VM 數目會與原始 VM 相同，但請規劃在程式期間建立更多 VM。
  • 未規劃任何系統更新或排程的工作。
  • 在設定與生產叢集相同值的叢集上設定分段升級，並在生產叢集中執行此升級之前先測試升級。

使用升級命令

您必須使用 命令，aks-engine upgrade如升級 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 映射散發版本

此更新提供這些映像的新版本：

  • Azure Stack Hub 操作員必須將新的 AKS 基底 Ubuntu 映射下載到戳記市集：

  • 名稱：AKS Base Ubuntu 16.04-LTS 映射散發版本，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 版本對應

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 引擎叢集。 請勿使用 aks-engine get-versions 命令，它會傳回全域 Azure 和 Azure Stack Hub 中支援的版本。

目前的版本 可用的升級
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，則必須設定下列兩個值（請參閱 範例kubernetes-azurestack.json）：

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

AKS 引擎和對應的影像對應

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）

最新功能

已知問題

  • 在單一叢集內平行部署多個 Kubernetes 服務，可能會導致基本負載平衡器組態發生錯誤。 我們建議一次部署一個服務。
  • 當您執行 aks-engine get-versions時，輸出會產生適用於 Azure 和 Azure Stack Hub 的資訊;不過，沒有明確的方式可辨別對應至 Azure Stack Hub 的內容。 請勿使用此命令來判斷哪些版本可供升級。 使用上一節所述的升級參考數據表。
  • 由於 aks-engine 工具是跨 Azure 和 Azure Stack Hub 的共用原始程式碼存放庫，因此檢查許多版本資訊和提取要求，可能會導致您相信此工具支援先前列出的其他 Kubernetes 和 OS 平臺版本。 您可以忽略它們，並使用上述版本表作為此更新的官方指南。

參考

這是 Azure 和 Azure Stack Hub 組合的完整版本資訊集：

適用於 AKS 引擎 0.48.0 版或更早版本。

本文說明 Azure Stack Hub 更新上的 Azure Kubernetes Service （AKS） 引擎內容。 此更新包含最新版以 Azure Stack Hub 平台為目標之 AKS 引擎的改進和修正。 本文不適用於記載適用於全域 Azure 的 AKS 引擎版本資訊。

更新規劃

AKS 引擎 upgrade 命令會完全自動化叢集的升級程式，並處理虛擬機、網路、記憶體、Kubernetes 和協調流程工作。 套用更新之前，請務必檢閱版本附註資訊。

升級考量

  • 您是否針對您的 AKS 引擎版本使用正確的市集專案 AKS Base Ubuntu 16.04-LTS 映像散發版本？ 您可以在下載新的 AKS 基底 Ubuntu 映像和 AKS 引擎版本一節 中找到版本。
  • 您是否使用目標叢集的正確叢集規格 （apimodel.json） 和資源群組？ 當您最初部署叢集時，此檔案會在輸出目錄中產生。 請參閱部署命令參數 部署 Kubernetes 叢集。
  • 您是否使用可靠的電腦來執行 AKS 引擎，以及執行升級作業的來源？
  • 如果您要更新具有作用中工作負載的作業叢集，您可以套用升級而不會影響它們，假設叢集處於正常負載之下。 不過，如果您有備份叢集，以防需要將使用者重新導向至該叢集。 強烈建議使用備份叢集。
  • 可能的話，請從 Azure Stack Hub 環境內的 VM 執行 命令，以減少網路躍點和潛在的連線失敗。
  • 請確定您的訂用帳戶有足夠的配額可供整個程式使用。 進程會在程式期間配置新的 VM。 產生的 VM 數目會與原始 VM 相同，但請規劃在程式期間建立更多 VM。
  • 未規劃任何系統更新或排程的工作。
  • 在設定與生產叢集相同值的叢集上設定分段升級，並在生產叢集中執行此升級之前先測試升級。

使用升級命令

您必須使用 命令，aks-engine upgrade如升級 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 映射散發版本。

此更新提供這些新版本：

  • 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 引擎叢集。 請勿使用 aks-engine get-versions 命令，它會傳回全域 Azure 和 Azure Stack Hub 中支援的版本。

目前的版本 可用的升級
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"

    注意

    如果未在 API 模型中明確提供 Kubernetes 版本.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 之前發生。

  • 命令中的upgrade新 aks-engine 選項 “--control-plane-only” 可讓用戶升級作業，只以主要 虛擬機器 （#2635） 為目標。

  • Ubuntu 16.04-LTS 的 Linux 核心版本 4.15.0-1071-azure 更新。 如需詳細資訊，請參閱“Package： linux-image-4.15.0-1071-azure （4.15.0-1071.76） [security]”。

  • 支援 Kubernetes 1.14.8 版和 1.15.10 版的新 Hyperkube 更新。

  • 更新 kubectl 以符合叢集的 Kubernetes 版本。 此元件可在 Kubernetes 叢集控制平面節點中使用，您可以透過 SSH 將它執行到主要節點。

  • 最新 2020 年 2 月版本 （#2850） 的 Azure Container Monitor 載入宏更新。

  • coredns升級至 v1.6.6 版（#2555）。

  • 升級 etcd 至 3.3.18 版（#2462）。

  • 升級 moby 至 3.0.11 版（#2887）。

  • 隨著這個版本的 AKS 引擎從現在開始削減相依性k8s.gcr.io，在建置其映像 （#2722） 時使用官方Kubernetes MCR registry @ mcr.microsoft.com。

已知問題

  • 在單一叢集內平行部署多個 Kubernetes 服務，可能會導致基本負載平衡器組態發生錯誤。 我們建議一次部署一個服務。
  • 執行 aks-engine get-versions 會產生適用於 Azure 和 Azure Stack Hub 的資訊;不過，沒有明確的方式可辨別對應至 Azure Stack Hub 的內容。 請勿使用此命令來判斷哪些版本可供升級。 使用上一節所述的升級參考數據表。
  • 由於 aks-engine 工具是跨 Azure 和 Azure Stack Hub 的共用原始程式碼存放庫，因此檢查許多版本資訊和提取要求，可能會導致您相信此工具支援先前列出的其他 Kubernetes 和 OS 平臺版本。 您可以忽略它們，並使用上述版本表作為此更新的官方指南。

參考

以下是一些已修正的錯誤清單，以及從 0.44.0 版到 0.48.0 版的完整版本資訊集。 版本資訊包括 Azure 和 Azure Stack Hub。

錯誤修正

  • userAssignedIdentityId 在 Windows azure.json 遺漏引號 （#2327）

  • 載入宏 update config 僅限升級 （#2282）

  • 在 Windows 節點上取得管理 IP 的逾時 （#2284）

  • 將 1.0.28 Azure CNI .zip檔案新增至 Windows VHD （#2268）

  • 正確設定 IPAddressCount 的預設順序 （#2358）

  • 更新為所有 K8s 版本使用單一 omsagent yaml，以避免任何手動錯誤和容易維護性 （#2692）

版本資訊

這是 Azure 和 Azure Stack Hub 組合的完整版本資訊集：

下一步