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 映像散發版本或 AKS 基底 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，改為) 。
  • Linux 代理程式) 所需的 AKS Base Ubuntu 20.04-LTS 映像散發版本 (。
  • Windows 代理程式需要下列其中一個映射 (AKS 基底 Windows Server 映射) ：
    • AKS 基底 Windows Server 映像容器化。
    • AKS 基本 Windows Server 映射 Docker。

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

升級使用 Ubuntu 16.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 節點的叢集可以搭配容器運行時間使用 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 版本。 請勿使用 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 基礎 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 基礎 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 基礎 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 基礎 Ubuntu 16.04-LTS 映像散發版本 2021 年 1 月 (2021.01.28)，
AKS 基礎 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 基礎 Ubuntu 18.04-LTS 映像散發版本，2021 Q2 (2021.05.24)、AKS 基礎 Windows 映像 (17763.1935.210520) 1.18.18、1.19.10、1.20.6 API 模型範例 (Linux、Windows)
v0.67.0 AKS 基礎 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 基礎 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 Q2 (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 Q4 (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 命令可完全自動化叢集的升級程式，並處理虛擬機 (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 提供 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 節點的叢集可以 搭配容器運行時間使用 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 映像散發版本或 AKS 基底 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) 。
  • Linux 代理程式) 所需的 AKS Base Ubuntu 18.04-LTS 映射散發版本 (。
  • Windows 代理程式) 所需的 AKS 基底 Windows Server 映射散發版本 (。

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

升級使用 Ubuntu 16.04 散發版本建立的 Kubernetes 叢集

從 AKS 引擎 v0.67.0 開始，Ubuntu 16.04 散發版本不再是支持的選項，因為 OS 已達到其生命周期結束。 若要升級叢集，請務必在輸入 API 模型中將 OS 散發版本設定為 ，這是由 aks-engine deploy 產生並當作輸入傳遞至 aks-engine upgrade的散發版本aks-ubuntu-18.04：

"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 基礎 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 基礎 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 基礎 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 基礎 Ubuntu 16.04-LTS 映像散發版本 2021 年 1 月 (2021.01.28)，
AKS 基礎 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 基礎 Ubuntu 18.04-LTS 映像散發版本，2021 Q2 (2021.05.24)、AKS 基礎 Windows 映像 (17763.1935.210520) 1.18.18、1.19.10、1.20.6 API 模型範例 (Linux、Windows)
v0.67.0 AKS 基礎 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 命令會完全自動化叢集的升級程式，並處理虛擬機 (VM) 、網路、記憶體、Kubernetes 和協調流程工作。 套用更新之前，請務必檢閱版本資訊。

升級考量

  • 您是否針對 AKS 引擎版本使用正確的市集專案、AKS Base Ubuntu 16.04-LTS 或 18.04 映像散發版本或 AKS 基底 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) 。
  • Linux 代理程式) 所需的 AKS Base Ubuntu 18.04-LTS 映射散發版本 (。
  • Windows 代理程式) 所需的 AKS 基底 Windows Server 映射散發版本 (。

此更新提供了這些元件的新版本：

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 基礎 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 基礎 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 基礎 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 基礎 Ubuntu 16.04-LTS 映像散發版本 2021 年 1 月 (2021.01.28)，
AKS 基礎 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 命令會完全自動化叢集的升級程式，並處理虛擬機 (VM) 、網路、記憶體、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 引擎二進位 (必要) 。
  • 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 引擎叢集。 請勿使用 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 (Linux、Windows) API 模型範例
1.15.12、1.16.14、1.17.11 (Linux、Windows) API 模型範例
1.15.12、1.16.14、1.17.11 (Linux、Windows) API 模型範例

最新消息

  • 將 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

已知問題

  • 在單一叢集內以平行方式部署多個 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 命令可完全自動化叢集的升級程式，並處理虛擬機 (VM) 、網路、記憶體、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 引擎二進位 (必要) 。
  • AKS Base Ubuntu 16.04-LTS 映射散發版本。

此更新提供了這些元件的新版本：

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 模型.json檔案中明確提供 Kubernetes 版本，則會使用 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)。

  • 如果 API 模型.json檔案包含 Azure Stack Hub (#2717) 不支援的屬性，aks-engine 中的新驗證步驟將會導致執行停止或顯示警告。

  • 透過新的驗證簽入，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。 如需詳細資料，請參閱套件：linux-image-4.15.0-1071-azure (4.15.0-1071.76) [security]。

  • 新的 hyperkube 更新，可支援 Kubernetes 1.14.8 和 1.15.10 版。

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

  • azure Container Monitor 載入宏的 匯報，其中包含最新的 2020 年 2 月版本 (#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)。

已知問題

  • 在單一叢集內以平行方式部署多個 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 統整的版本資訊集：

下一步