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

適用於 AKS 引擎的版本 v0.70.0。

本文說明 Azure Stack Hub 上的 Azure Kubernetes Service (AKS) 引擎的更新內容。 此更新包含以 Azure Stack Hub 平台為目標的最新版 AKS 引擎的改良和修正。 請注意,本文並不會針對適用於全域 Azure 的 AKS 引擎說明發行資訊。

更新規劃

AKS 引擎升級命令可將叢集的升級程序完全自動化,其涵蓋範圍包括虛擬機器 (VM)、網路、儲存體、Kubernetes 和協調流程工作。 套用更新之前,請務必檢閱版本資訊。

升級考量

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

使用升級命令

您將需要使用 AKS 引擎升級命令,如下列在 Azure Stack Hub 上升級 Kubernetes 叢集一文所述。

升級中斷

有時,非預期的因素會導致叢集的升級中斷。 當 AKS 引擎報告錯誤或 AKS 引擎執行程序發生問題時,就會發生中斷的狀況。 請檢查中斷的原因並加以解決,然後重新提交相同的升級命令以繼續進行升級程序。 升級命令為等冪命令,應會在重新提交命令後繼續升級叢集。 一般來說,中斷只會拉長完成更新所需的時間,而不會導致作業無法完成。

估計的升級時間

根據估計,叢集中的每個 VM 需要 12 到 15 分鐘的時間。 例如,含 20 個節點的叢集約需要五 (5) 個小時才能完成升級。

使用 AKS 引擎 0.70.0 的指示

Microsoft 已在版本 0.70.0 中升級 Azure 雲端提供者。 Azure 雲端提供者是在 Azure Stack Hub 上 AKS Azure 與 AKS 引擎之間共用的核心元件。

若要使用 AKS 引擎 0.70.0:

  • 如果您第一次嘗試建立新的 Kubernetes 叢集
    使用 AKS 引擎和相對應映像對應資料表中針對版本 0.70.0 所提供的範例 API 模型。

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

  • 如果您使用的是儲存體磁碟區
    請確定您使用的是 AzureDiskCSI 驅動程式。 版本 0.70.0 僅支援 CSI 驅動程式,而不是舊版「樹狀結構中」儲存體提供者。 若要升級,請遵循從 Kubernetes v1.20 升級至 v1.21 的指示。

下載新的映像和 AKS 引擎

下載新版的 AKS 基礎 Ubuntu 映像和 AKS 引擎。

如 Azure Stack Hub 的 AKS 引擎文件所說明,部署 Kubernetes 叢集需要:

  • aks-engine 二進位檔 (必要)
  • AKS 基礎 Ubuntu 16.04-LTS 映像散發版本 (已淘汰 - 不再使用,在 API 模型中變更,改為使用 18.04)
  • AKS 基礎 Ubuntu 18.04-LTS 映像散發版本 (Linux 代理程式所需)
  • AKS 基礎 Windows Server 映像散發版本 (Windows 代理程式所需)

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

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

升級使用 Ubuntu 16.04 散發版本建立的 Kubernetes 叢集。從 AKS 引擎 v0.67.0 開始,Ubuntu 16.04 散發版本不再是支援的選項,因為 OS 已達生命週期結束。 若要升級叢集,請務必在您的輸入 API 模型中,將 OS 散發版本設定為 aks-ubuntu-18.04,並其為 aks-engine deploy 產生並傳遞作為 aks-engine upgrade 的輸入。

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

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

AKS 引擎和 Azure Stack 版本對應

Azure Stack Hub 版本 AKS 引擎版本
1910 0.43.0、0.43.1
2002 0.48.0、0.51.0
2005 0.48.0、0.51.0、0.55.0、0.55.4
2008 0.55.4、0.60.1
2102 0.60.1、0.63.0、0.67.0
2108 0.63.0、0.67.0、0.67.3、0.70.0

AKS 引擎 v0.70.0 中的 Kubernetes 版本升級路徑

您可以在下表中找到 Azure Stack Hub 的目前版本和升級版本。 請勿執行 aks-engine get-versions 命令,因為該命令也包含全域 Azure 中支援的版本。 下列版本和升級表格適用於 Azure Stack Hub 中的 AKS 引擎叢集。

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

在 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 LinuxWindows
v0.55.0 AKS 基礎 Ubuntu 16.04-LTS 映像散發版本,2020 年 8 月 (2020.08.24)、AKS 基礎 Windows 映像 (17763.1397.200820) 1.15.12、1.16.14、1.17.11 LinuxWindows
v0.55.4 AKS 基礎 Ubuntu 16.04-LTS 映像散發版本,2020 年 9 月 (2020.09.14)、AKS 基礎 Windows 映像 (17763.1397.200820) 1.15.12、1.16.14、1.17.11 LinuxWindows
V0.60.1 AKS 基礎 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 LinuxWindows
v0.63.0 AKS 基礎 Ubuntu 18.04-LTS 映像散發版本,2021 Q2 (2021.05.24)AKS 基礎 Windows 映像 (17763.1935.210520) 1.18.18、1.19.10、1.20.6 API 模型範例 (LinuxWindows)
v0.67.0 AKS 基礎 Ubuntu 18.04-LTS 映像散發版本,2021 年第 3 季 (2021.09.27)AKS 基礎 Windows 映像 (17763.2213.210927) 1.19.15、1.20.11 API 模型範例 (LinuxWindows)
v0.67.3 AKS 基礎 Ubuntu 18.04-LTS 映像散發版本,2021 年第 3 季 (2021.09.27)AKS 基礎 Windows 映像 (17763.2213.210927) 1.19.15、1.20.11 API 模型範例 (LinuxWindows)
v0.70.0 AKS Base Ubuntu 18.04-LTS 映像散發版本 2022 年第 1 季 (2022.04.07)
AKS Base Windows 映像 (17763.2565.220408)
1.21.10, 1.22.7 API 模型範例 (LinuxWindows)

最新消息

新功能包括:

  • 已新增 Kubernetes v1.21.10 (#4840) 的支援
  • 已新增 Kubernetes v1.22.7 (#4838) 的支援
  • 您可以在 v0.70.0 找到其他功能。

已知問題

  • 在單一叢集內以平行方式部署多個 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 引擎升級命令可將叢集的升級程序完全自動化,其涵蓋範圍包括虛擬機器 (VM)、網路、儲存體、Kubernetes 和協調流程工作。 套用更新之前,請務必檢閱版本資訊。

升級考量

  • 您是否對您的 AKS 引擎版本使用正確的市集項目,AKS 基礎 Ubuntu 16.04-LTS 或 18.04 映像散發版本或 AKS 基礎 Windows Server? 您可以在「下載新映像和 AKS 引擎」一節中找到版本。
  • 針對目標叢集所使用的叢集規格 (apimodel.json) 和資源群組是否正確? 在最初部署叢集時,會在您的輸出目錄中產生此檔案。 請參閱部署 Kubernetes 叢集中的部署命令參數。
  • 您是否使用可靠的機器執行 AKS 引擎,並從中執行升級作業?
  • 如果您要更新具有作用中工作負載的作業叢集,則可以在其不受影響的情況下套用升級 (假設叢集的負載正常)。 不過,您應該要有備份叢集,以備需要將使用者重新導向至該處時使用。 強烈建議使用備份叢集。
  • 可以的話,請從 Azure Stack Hub 環境內的 VM 執行命令,以減少網路躍點和潛在的連線失敗。
  • 確定訂用帳戶有足夠的配額可執行整個程序。 此程序會在程序進行期間配置新的 VM。 產生的 VM 數目會與原有的相同,但在規劃時應假設在此程序中會建立更多 VM。
  • 未規劃任何系統更新或排程的工作。
  • 在設定了與生產叢集相同之值的叢集上設定分段升級,並在其中測試升級,然後才在生產叢集中進行升級。

使用升級命令

您將需要使用 AKS 引擎升級命令,如下列在 Azure Stack Hub 上升級 Kubernetes 叢集一文所描述。

升級中斷

有時,非預期的因素會導致叢集的升級中斷。 當 AKS 引擎報告錯誤或 AKS 引擎執行程序發生問題時,就會發生中斷的狀況。 請檢查中斷的原因並加以解決,然後重新提交相同的升級命令以繼續進行升級程序。 升級命令為等冪命令,應會在重新提交命令後繼續升級叢集。 一般來說,中斷只會拉長完成更新所需的時間,而不會導致作業無法完成。

估計的升級時間

根據估計,叢集中的每個 VM 需要 12 到 15 分鐘的時間。 例如,含 20 個節點的叢集約需要五 (5) 個小時才能完成升級。

下載新的映像和 AKS 引擎

下載新版的 AKS 基礎 Ubuntu 映像和 AKS 引擎。

如 Azure Stack Hub 的 AKS 引擎文件所說明,部署 Kubernetes 叢集需要:

  • aks-engine 二進位檔 (必要)
  • AKS 基礎 Ubuntu 16.04-LTS 映像散發版本 (已淘汰 - 不再使用,在 API 模型中變更,改為使用 18.04)
  • AKS 基礎 Ubuntu 18.04-LTS 映像散發版本 (Linux 代理程式所需)
  • AKS 基礎 Windows Server 映像散發版本 (Windows 代理程式所需)

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

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

升級使用 Ubuntu 16.04 散發版本建立的 Kubernetes 叢集。從 AKS 引擎 v0.67.0 開始,Ubuntu 16.04 散發版本不再是支援的選項,因為 OS 已達生命週期結束。 若要升級叢集,請務必在您的輸入 API 模型中,將 OS 散發版本設定為 aks-ubuntu-18.04,並其為 aks-engine deploy 產生並傳遞作為 aks-engine upgrade 的輸入。

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

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

AKS 引擎和 Azure Stack 版本對應

Azure Stack Hub 版本 AKS 引擎版本
1910 0.43.0、0.43.1
2002 0.48.0、0.51.0
2005 0.48.0、0.51.0、0.55.0、0.55.4
2008 0.55.4、0.60.1
2102 0.60.1、0.63.0、0.67.0
2108 0.63.0、0.67.0

AKS 引擎 v0.67.0 中的 Kubernetes 版本升級路徑

您可以在下表中找到 Azure Stack Hub 的目前版本和升級版本。 請勿執行 aks-engine get-versions 命令,因為該命令也包含全域 Azure 中支援的版本。 下列版本和升級表格適用於 Azure Stack Hub 中的 AKS 引擎叢集。

目前版本 可用的升級
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 LinuxWindows
v0.55.0 AKS 基礎 Ubuntu 16.04-LTS 映像散發版本,2020 年 8 月 (2020.08.24)、AKS 基礎 Windows 映像 (17763.1397.200820) 1.15.12、1.16.14、1.17.11 LinuxWindows
v0.55.4 AKS 基礎 Ubuntu 16.04-LTS 映像散發版本,2020 年 9 月 (2020.09.14)、AKS 基礎 Windows 映像 (17763.1397.200820) 1.15.12、1.16.14、1.17.11 LinuxWindows
V0.60.1 AKS 基礎 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 LinuxWindows
v0.63.0 AKS 基礎 Ubuntu 18.04-LTS 映像散發版本,2021 Q2 (2021.05.24)AKS 基礎 Windows 映像 (17763.1935.210520) 1.18.18、1.19.10、1.20.6 API 模型範例 (LinuxWindows)
v0.67.0 AKS 基礎 Ubuntu 18.04-LTS 映像散發版本,2021 年第 3 季 (2021.09.27)AKS 基礎 Windows 映像 (17763.2213.210927) 1.19.15、1.20.11 API 模型範例 (LinuxWindows)

最新消息

如果您有興趣參與個人預覽版,可以要求預覽存取

新功能包括:

  • 支援 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 引擎升級命令可將叢集的升級程序完全自動化,其涵蓋範圍包括虛擬機器 (VM)、網路、儲存體、Kubernetes 和協調流程工作。 套用更新之前,請務必檢閱版本資訊。

升級考量

  • 您是否對您的 AKS 引擎版本使用正確的市集項目,AKS 基礎 Ubuntu 16.04-LTS 或 18.04 映像散發版本或 AKS 基礎 Windows Server? 您可以在「下載新映像和 AKS 引擎」一節中找到版本。
  • 針對目標叢集所使用的叢集規格 (apimodel.json) 和資源群組是否正確? 在最初部署叢集時,會在您的輸出目錄中產生此檔案。 請參閱部署 Kubernetes 叢集中的部署命令參數。
  • 您是否使用可靠的機器執行 AKS 引擎,並從中執行升級作業?
  • 如果您要更新具有作用中工作負載的作業叢集,則可以在其不受影響的情況下套用升級 (假設叢集的負載正常)。 不過,您應該要有備份叢集,以備需要將使用者重新導向至該處時使用。 強烈建議使用備份叢集。
  • 可以的話,請從 Azure Stack Hub 環境內的 VM 執行命令,以減少網路躍點和潛在的連線失敗。
  • 確定訂用帳戶有足夠的配額可執行整個程序。 此程序會在程序進行期間配置新的 VM。 產生的 VM 數目會與原有的相同,但在規劃時應假設在此程序中會建立更多 VM。
  • 未規劃任何系統更新或排程的工作。
  • 在設定了與生產叢集相同之值的叢集上設定分段升級,並在其中測試升級,然後才在生產叢集中進行升級。

使用升級命令

您將需要使用 AKS 引擎升級命令,如下列在 Azure Stack Hub 上升級 Kubernetes 叢集一文所描述。

升級中斷

有時,非預期的因素會導致叢集的升級中斷。 當 AKS 引擎報告錯誤或 AKS 引擎執行程序發生問題時,就會發生中斷的狀況。 請檢查中斷的原因並加以解決,然後重新提交相同的升級命令以繼續進行升級程序。 升級命令為等冪命令,應會在重新提交命令後繼續升級叢集。 一般來說,中斷只會拉長完成更新所需的時間,而不會導致作業無法完成。

估計的升級時間

根據估計,叢集中的每個 VM 需要 12 到 15 分鐘的時間。 例如,含 20 個節點的叢集約需要五 (5) 個小時才能完成升級。

下載新的映像和 AKS 引擎

下載新版的 AKS 基礎 Ubuntu 映像和 AKS 引擎。

如 Azure Stack Hub 的 AKS 引擎文件所說明,部署 Kubernetes 叢集需要:

  • aks-engine 二進位檔 (必要)
  • AKS 基礎 Ubuntu 16.04-LTS 映像散發版本 (必要)
  • AKS 基礎 Ubuntu 18.04-LTS 映像散發版本 (選用)
  • 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 的目前版本和升級版本。 請勿執行 aks-engine get-versions 命令,因為該命令也包含全域 Azure 中支援的版本。 下列版本和升級表格適用於 Azure Stack Hub 中的 AKS 引擎叢集。

目前版本 可用的升級
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 LinuxWindows
v0.55.0 AKS 基礎 Ubuntu 16.04-LTS 映像散發版本,2020 年 8 月 (2020.08.24)、AKS 基礎 Windows 映像 (17763.1397.200820) 1.15.12、1.16.14、1.17.11 LinuxWindows
v0.55.4 AKS 基礎 Ubuntu 16.04-LTS 映像散發版本,2020 年 9 月 (2020.09.14)、AKS 基礎 Windows 映像 (17763.1397.200820) 1.15.12、1.16.14、1.17.11 LinuxWindows
V0.60.1 AKS 基礎 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 LinuxWindows

最新消息

如果您有興趣參與個人預覽版,可以要求預覽存取

新功能包括:

  • Ubuntu 18.04 的正式發行
  • 憑證輪替公開預覽 #4214
  • T4 Nvidia GPU 私人預覽 #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 引擎升級命令可將叢集的升級程序完全自動化,其涵蓋範圍包括虛擬機器 (VM)、網路、儲存體、Kubernetes 和協調流程工作。 套用更新之前,請務必檢閱版本資訊。

升級考量

  • 針對您的 AKS engine 版本,您是否使用正確的 Marketplace 項目:AKS 基礎 Ubuntu 16.04-LTS 映像散發版本? 您可以在「下載新的映像和 AKS 引擎」一節中找到您的版本。

  • 針對目標叢集所使用的叢集規格 (apimodel.json) 和資源群組是否正確? 在最初部署叢集時,會在您的輸出目錄中產生此檔案。 請參閱部署 Kubernetes 叢集中的 deploy 命令參數。

  • 您是否使用可靠的機器執行 AKS 引擎,並從中執行升級作業?

  • 如果您要更新具有作用中工作負載的作業叢集,則可以在其不受影響的情況下套用升級 (假設叢集的負載正常)。 不過,您應該要有備份叢集,以備需要將使用者重新導向至該處時使用。 強烈建議使用備份叢集。

  • 可以的話,請從 Azure Stack Hub 環境內的 VM 執行命令,以減少網路躍點和潛在的連線失敗。

  • 確定訂用帳戶有足夠的配額可執行整個程序。 此程序會在程序進行期間配置新的 VM。 產生的 VM 數目會與原有的相同,但在規劃時應假設在此程序中會建立更多 VM。

  • 未規劃任何系統更新或排程的工作。

  • 在設定了與生產叢集相同之值的叢集上設定分段升級,並在其中測試升級,然後才在生產叢集中進行升級。

使用升級命令

您將需要使用 AKS 引擎 upgrade 命令,如下列在 Azure Stack Hub 上升級 Kubernetes 叢集一文所述。

升級中斷

有時,非預期的因素會導致叢集的升級中斷。 當 AKS 引擎報告錯誤或 AKS 引擎執行程序發生問題時,就會發生中斷的狀況。 請檢查中斷的原因並加以解決,然後重新提交相同的升級命令以繼續進行升級程序。 升級命令為等冪命令,應會在重新提交命令後繼續升級叢集。 一般來說,中斷只會拉長完成更新所需的時間,而不會導致作業無法完成。

估計的升級時間

根據估計,叢集中的每個 VM 需要 12 到 15 分鐘的時間。 例如,含 20 個節點的叢集約需要五 (5) 個小時才能完成升級。

下載新的映像和 AKS 引擎

下載新版的 AKS 基礎 Ubuntu 映像和 AKS 引擎。

如 Azure Stack Hub 的 AKS 引擎文件所說明,部署 Kubernetes 叢集需要兩個主要元件:

  • 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 的目前版本和升級版本。 請勿執行 aks-engine get-versions 命令,因為該命令也包含全域 Azure 中支援的版本。 下列版本和升級表格適用於 Azure Stack Hub 中的 AKS 引擎叢集。

目前版本 可用的升級
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.16.14,則必須設定下列兩個值 (請參閱範例 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 模型範例 (LinuxWindows)
1.15.12、1.16.14、1.17.11 API 模型範例 (LinuxWindows)
1.15.12、1.16.14、1.17.11 API 模型範例 (LinuxWindows)

最新消息

  • 將 Azure Stack 的 Linux VHD 更新至 2020.09.14 #3828
  • 為 Azure Stack 上的 K8s v1.17.11 新增支援 #3702
  • 為 Azure Stack 上的 K8s v1.16.14 新增支援 #3704
  • Linux VHD 更新至 2020.09.14 #3750
  • Windows VHD 更新至 8 月 #3730
  • 將 Kubernetes 計量伺服器升級至 v0.3.7 #3669
  • 升級 Docker 版本以修正記錄輪替問題 #3693
  • 將 CoreDNS 升級至 v1.7.0 #3608
  • 使用 moby 19.03.x 套件 #3549
  • 修正 azure-cni 更新策略 #3571

已知問題

  • 在單一叢集內以平行方式部署多個 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 引擎升級命令可將叢集的升級程序完全自動化,其涵蓋範圍包括虛擬機器 (VM)、網路、儲存體、Kubernetes 和協調流程工作。 在套用更新之前,請務必先檢閱本文中的資訊。

升級考量

  • 針對您的 AKS engine 版本,您是否使用正確的 Marketplace 項目:AKS 基礎 Ubuntu 16.04-LTS 映像散發版本? 您可以在下載新的 AKS 基礎 Ubuntu 映像和 AKS 引擎版本一節中找到您的版本。

  • 您對目標叢集使用的叢集規格 (apimodel.json) 和資源群組是否正確? 在最初部署叢集時,會在您的輸出目錄中產生此檔案。 請參閱部署 Kubernetes 叢集中的「部署」命令參數。

  • 您是否使用可靠的機器執行 AKS 引擎,並從中執行升級作業?

  • 如果您要更新具有作用中工作負載的作業叢集,則可以在其不受影響的情況下套用升級 (假設叢集的負載正常)。 不過,您應該要有備份叢集,以備需要將使用者重新導向至該處時使用。

  • 可以的話,請從 Azure Stack Hub 環境內的 VM 執行命令,以減少網路躍點和潛在的連線失敗。

  • 確定訂用帳戶有足夠的配額可執行整個程序。 此程序會在程序進行期間配置新的 VM。 產生的 VM 數目會與原有的相同,但在規劃時應假設在此程序中會建立更多 VM。

  • 未規劃任何系統更新或排程的工作。

  • 在設定了與生產叢集相同之值的叢集上設定分段升級,並在其中測試升級,然後才在生產叢集中進行升級。

使用升級命令

您將需要使用 AKS 引擎「升級」命令,如在 Azure Stack Hub 上升級 Kubernetes 叢集一文所說明。

升級中斷

有時,非預期的因素會導致叢集的升級中斷。 當 AKS 引擎報告錯誤或 AKS 引擎執行程序發生問題時,就會發生中斷的狀況。 請檢查中斷的原因並加以解決,然後重新提交相同的升級命令以繼續進行升級程序。 升級命令為等冪命令,應會在重新提交命令後繼續升級叢集。 一般來說,中斷只會拉長完成更新所需的時間,而不會導致作業無法完成。

估計的升級時間

根據估計,叢集中的每個 VM 需要 12 到 15 分鐘的時間。 例如,含 20 個節點的叢集約需要五 (5) 個小時才能完成升級。

下載新的映像和 AKS 引擎

下載新版的 AKS 基礎 Ubuntu 映像和 AKS 引擎。

如 Azure Stack Hub 的 AKS 引擎文件所說明,部署 Kubernetes 叢集需要兩個主要元件:

  • aks-engine 二進位檔
  • AKS 基礎 Ubuntu 16.04-LTS 映像散發版本

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

Kubernetes 版本升級路徑

您可以在下表中找到 Azure Stack Hub 的目前版本和升級版本。 請勿執行 aks-engine get-versions 命令,因為該命令也包含全域 Azure 中支援的版本。 下列版本和升級表格適用於 Azure Stack Hub 中的 AKS 引擎叢集。

目前的版本 可用的升級
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 不支援的屬性,aks-engine 中的新驗證步驟將會導致執行停止或顯示警告 (#2717)。

  • 透過新的驗證簽入,aks-engine 將會驗證執行 aks-engine 版本所需的 AKS 基礎映像版本是否可供使用 (#2342)。 此驗證會在剖析 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]

  • 新的 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 的相關項目

錯誤修正

  • Windows azure.json 中的 userAssignedIdentityId 遺漏引號 (#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 統整的版本資訊集

後續步驟