通过

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 Base Windows Server？ 可以在下载新映像和 AKS 引擎部分找到这些版本。
  • 是否为目标群集使用了正确的群集规范 (apimodel.json) 和资源组？ 最初部署群集时，已在输出目录中生成此文件。 请参阅部署 Kubernetes 群集的“deploy”命令参数。
  • 是否使用了可靠的计算机来运行 AKS 引擎并从中执行升级操作？
  • 如果要更新具有活动工作负载的正常群集，假如群集处于正常负载下，则可以在不影响它们的情况下应用升级。 但是，你应该有一个备份群集，以防需要将用户重定向到它。 强烈建议使用备份群集。
  • 如果可能，请从Azure Stack Hub环境中的 VM 运行命令，以减少网络跃点和潜在的连接故障。
  • 请确保订阅有足够的配额来完成整个过程。 进程将在此过程中分配新的 VM。 生成的 VM 的数量将与原始数量相同，但要对在该过程中创建更多的 VM 做好计划。
  • 未规划系统更新或计划的任务。
  • 在已使用与生产群集相同的值配置的群集上设置分阶段升级，并在其上测试升级，然后再在生产群集中执行此操作。

使用升级命令

必须按照《在 Azure Stack Hub 上升级 Kubernetes 群集》中描述的方法使用 aks-engine upgrade 命令。

升级中断

有时，意外的因素会中断群集的升级。 当 AKS 引擎报告了某个错误或在 AKS 引擎执行过程中发生某些事情时，可能会发生中断。 请检查中断的原因，解决问题，然后重新提交相同的 upgrade 命令以继续执行升级过程。 upgrade 命令是幂等的，在重新提交命令后应该会恢复群集的升级。 通常，中断会增加完成更新所需的时间，但不会影响它的完成。

估计的升级时间

群集中每个 VM 的估计升级时间为 12 到 15 分钟。 例如，升级包含 20 个节点的群集大约需要 5 小时。

下载新镜像和 AKS 引擎

下载 AKS 基础 Ubuntu 映像和 AKS 引擎的新版本。

如 Azure Stack Hub AKS 引擎文档中所述，部署 Kubernetes 群集需要：

  • aks-engine 二进制文件（必需）。
  • AKS Base Ubuntu 16.04-LTS 映像发行版（已弃用 - 不再使用，API 模型中更改为改用 22.04）。
  • AKS Base Ubuntu 18.04-LTS 映像发行版（已弃用 - 不再使用，API 模型中更改为改用 22.04）。
  • AKS Base Ubuntu 20.04-LTS 映像发行版（已弃用 - 不再使用，API 模型中改为使用 22.04）。
  • AKS 基础版 Ubuntu 22.04-LTS 映像发行版（适用于 Linux 代理）。
  • AKS 基础版 Windows Server 映像（Windows 代理需要以下映像之一）：
    • AKS 基础Windows Server映像容器化。
    • AKS 基础 Windows Server 映像 Docker。

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

  • 查看 AKS 引擎和 Azure Stack 版本映射 表，以获取所需的 AKS 基础映像。

    按照 将 Azure Kubernetes 服务（AKS）引擎先决条件添加到 Azure Stack Hub 市场。

  • Kubernetes 群集管理员（通常是Azure Stack Hub的租户用户）必须下载新的 aks-engine。 请参阅 Azure Stack Hub（或等效Windows文章）在 Linux 上安装 AKS 引擎的说明。 你可以遵循首次安装群集的过程。 更新过程会覆盖以前的二进制文件。 例如，如果你使用了 get-akse.sh 脚本，请按照在联网环境中安装中所述的步骤进行操作。 如果要在 Windows 系统上安装，则此过程适用：在 Azure Stack HubWindows上安装 AKS 引擎。

升级使用 Ubuntu 16.04 发行版创建的 Kubernetes 群集

从 AKS 引擎 v0.63.0 开始，Ubuntu 16.04 发行版不再是受支持的选项，因为该操作系统的生命周期已结束。 对于 AKS 引擎 v0.67.0 或更高版本，aks-engine upgrade 会自动用 替换掉不受支持的 aks-ubuntu-16.04 发行版值。 对于 AKS 引擎 v0.75.3 或更高版本，如果你使用的是 Kubernetes v1.24 或更高版本，则 aks-engine-azurestack 升级会自动用 aks-ubuntu-16.04 覆盖不受支持的 aks-ubuntu-20.04 发行版值。

升级使用 Ubuntu 18.04 或 20.04 发行版创建的 Kubernetes 群集

从 AKS 引擎 v0.75.3 开始，Ubuntu 18.04 发行版不再是受支持的选项，因为该操作系统的生命周期已结束。 从 AKS 引擎 v0.82.2 开始，Ubuntu 20.04 发行版不再是受支持的选项。 对于这些 AKS 引擎版本，aks-engine-azurestack 升级会自动将不受支持的aks-ubuntu-18.04或aks-ubuntu-20.04发行版值分别替换为aks-ubuntu-20.04或aks-ubuntu-22.04。

升级使用 docker 容器运行时创建的 Kubernetes 群集

在 Kubernetes v1.24 中，dockershim 组件已从 kubelet 中删除。 因此，docker 容器运行时不再是受支持的选项。 有关详细信息，请参阅 Kubernetes v1.24 发行说明。 对于 AKS 引擎 v0.75.3 或更高版本，aks-engine-azurestack 将使用 docker 自动覆盖不受支持的 containerRuntimecontainerd 值。

对于 AKS 引擎版本 v0.75.3，Kubernetes v1.23 上具有Windows节点的群集可以将 Windows 基础映像与 Docker 运行时配合使用。 Kubernetes v1.24 上具有Windows节点的群集可以将Windows基础映像与容器运行时配合使用。

AKS 引擎和Azure Stack版本映射

Azure Stack Hub版本 AKS 引擎版本
1910 0.43.0、0.43.1
2002 0.48.0、0.51.0
2005 0.48.0、0.51.0、0.55.0、0.55.4
2008 0.55.4, 0.60.1
2102 0.60.1、0.63.0、0.67.0、0.67.3
2108 0.63.0、0.67.0、0.67.3、0.70.0、0.71.0、0.73.0、0.75.3、0.76.0
2206 0.70.0, 0.71.0, 0.73.0, 0.75.3, 0.76.0, 0.77.0
2301 0.75.3, 0.76.0, 0.77.0, 0.78.0, 0.79.0
2306 0.78.0、0.79.0、0.80.2
2311 0.80.2
2406 0.80.2, 0.80.3, 0.81.2
2408 0.80.2, 0.80.3, 0.81.2, 0.82.2, 0.83.1
2501 0.81.2, 0.82.2, 0.83.1*, 0.84.1*
2506 0.83.1*, 0.84.1*
2601 0.83.1*, 0.84.1*

*支持。 有关详细信息，请参阅 AKS 引擎版本支持策略。

AKS 引擎及相应的映像映射

可以在下表中找到 AKS 引擎在 Azure Stack Hub 上支持的 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 基础 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 年第 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 基础 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 基础 Ubuntu 18.04-LTS 镜像发行版，2022 年第 3 季度（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 Base Windows Server 2019 映像 Docker （17763.3887.20230332），AKS Base Windows Server 2019 映像 Containerd （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）
v0.80.3 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）
v0.81.2 AKS Base Ubuntu 20.04-LTS 映像发行版（2024.311.1），AKS 基础 Windows Server 2019映像容器（17763.6414.20243111） 1.28.15**、1.29.10** API 模型示例 （Linux， Windows）
v0.82.2 AKS Base Ubuntu 22.04-LTS 映像发行版（2025.079.2），AKS Windows Server 2019 基础映像容器（17763.7009.20250792） 1.29.15**, 1.30.10** API 模型示例 （Linux， Windows）
v0.83.1 AKS Base Ubuntu 22.04-LTS 映像发行版（2025.227.1）， AKS 基础 Windows Server 2019映像容器（17763.7678.20252271） 1.30.14**, 1.31.11** API 模型示例 （Linux， Windows）
v0.84.1 AKS Base Ubuntu 22.04-LTS 映像发行版（2025.337.1），AKS Windows Server 2019 基础映像容器（17763.7919.20253371） 1.31.13**, 1.32.9**, 1.33.5** API 模型示例 （Linux， Windows）

注意事项

从 Kubernetes v1.21 开始，Azure Stack Hub 只支持 Azure 云提供商。

注意事项

**从 Kubernetes v1.24 开始，仅支持 containerd 容器运行时。 有关详细信息，请参阅升级使用 docker 容器运行时创建的 Kubernetes 群集部分。

更新规划

AKS 引擎 upgrade 命令完全自动执行群集的升级过程，并处理虚拟机 (VM)、网络、存储、Kubernetes 和业务流程任务。 应用该更新之前，请务必查看发行说明信息。

AKSe 0.82.2 中的新增功能

  • 添加了对 Kubernetes 1.29.15 和 1.30.10 的支持。
  • Azure Stack Hub上的 AKS 引擎版本 v0.82.2 提供 Ubuntu 22.04 LTS 作为其 Linux 基础映像。 从此版本开始，不再支持 Ubuntu 20.04。
  • 可以在 v0.82.2 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 引擎版本的命令也已更改。 可以在 Create Linux 客户端和 create Windows client中看到新命令。 如果发现任何问题，请在新存储库中创建 issue。

Azure Stack Hub上的 AKS 引擎版本 v0.75.3 提供 Ubuntu 20.04 LTS 作为其 Linux 基础映像。 从此版本开始，将不再支持 Ubuntu 18.04。 有关详细信息，请参阅 升级使用 Ubuntu 18.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 模型：按照 Cloud Provider for Azure 说明修改 API 模型。 不包含新设置将导致部署错误。

  • 如果使用存储卷：确保使用的是 AzureDiskCSI 驱动程序。 0.70.0 及更高版本仅支持 CSI 驱动程序，而不支持旧的树内存储提供程序。 要升级，请在upgrade中遵循说明，同时使用存储卷。

已知问题

  • 在单个群集中并行部署多个 Kubernetes 服务可能会导致基本负载均衡器配置出错。 我们建议一次部署一个服务。
  • 由于 aks-engine 工具是 Azure 和 Azure Stack Hub 的共享源代码存储库，查看大量发行说明和拉取请求可能会让你误以为该工具支持超出之前列出的 Kubernetes 和操作系统平台的其他版本。 可以忽略它们，并使用以前的版本表作为此更新的官方指南。
  • 部署Windows群集时，AKS 引擎 v0.67.0 使用错误的Windows映像。 使用 v0.70.0 来解决此问题。

Chrony 守护程序无法重启

Linux 节点上的 chrony 守护程序可能无法重启并显示错误消息："Could not open /dev/ptp_hyperv: No such file or directory"。

此问题的解决方法是手动重新启动受影响的 Linux 节点。 此操作将重新生成 /dev/ptp_hyperv 符号链接，并使 chrony 守护程序成功重启。

参考

以下是 AKS 引擎在 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 群集的“deploy”命令参数。
  • 是否使用了可靠的计算机来运行 AKS 引擎并从中执行升级操作？
  • 如果要更新具有活动工作负载的正常群集，假如群集处于正常负载下，则可以在不影响它们的情况下应用升级。 但是，你应该有一个备份群集，以防需要将用户重定向到它。 强烈建议使用备份群集。
  • 如果可能，请从Azure Stack Hub环境中的 VM 运行命令，以减少网络跃点和潜在的连接故障。
  • 请确保订阅有足够的配额来完成整个过程。 进程将在此过程中分配新的 VM。 生成的 VM 的数量将与原始数量相同，但要对在该过程中创建更多的 VM 做好计划。
  • 未规划系统更新或计划的任务。
  • 在已使用与生产群集相同的值配置的群集上设置分阶段升级，并在其上测试升级，然后再在生产群集中执行此操作。

使用升级命令

必须按照 Azure Stack Hub 上升级 Kubernetes 群集 中的描述来使用 aks-engine upgrade 命令。

升级中断

有时，意外的因素会中断群集的升级。 当 AKS 引擎报告了某个错误或在 AKS 引擎执行过程中发生某些事情时，可能会发生中断。 请检查中断的原因，解决问题，然后重新提交相同的 upgrade 命令以继续执行升级过程。 upgrade 命令是幂等的，在重新提交命令后应该会恢复群集的升级。 通常，中断会增加完成更新所需的时间，但不会影响它的完成。

估计的升级时间

群集中每个 VM 的估计升级时间为 12 到 15 分钟。 例如，升级包含 20 个节点的群集大约需要 5 小时。

下载新镜像和 AKS 引擎

下载 AKS 基础 Ubuntu 映像和 AKS 引擎的新版本。

如 Azure Stack Hub AKS 引擎文档中所述，部署 Kubernetes 群集需要：

  • aks-engine 二进制文件（必需）。
  • AKS 基础 Ubuntu 16.04-LTS 映像发行版（已弃用 - 不再使用，请在 API 模型中改用 18.04）。
  • AKS 基础 Ubuntu 18.04-LTS 映像发行版（对于 Linux 代理是必需的）。
  • AKS 基础 Windows Server 镜像发行版（Windows 代理需要）。

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

升级使用 Ubuntu 16.04 发行版创建的 Kubernetes 群集

从 AKS 引擎 v0.67.0 开始，Ubuntu 16.04 发行版不再是受支持的选项，因为该操作系统的生命周期已结束。 若要升级群集，请确保在输入 API 模型（由 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 基础 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 基础版 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 Base Ubuntu 18.04-LTS 映像发行版，2021 年第 2 季度（2021.05.24），AKS Base Windows 映像（17763.1935.210520） 1.18.18、1.19.10、1.20.6 API 模型示例 （Linux， Windows）
v0.67.0 AKS Base Ubuntu 18.04-LTS 映像发行版，2021 年第 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 和操作系统平台的其他版本。 你可以忽略它们，并将上面的版本表作为此次更新的官方指南。

参考

以下列表是组合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 群集的“deploy”命令参数。
  • 是否使用了可靠的计算机来运行 AKS 引擎并从中执行升级操作？
  • 如果要更新具有活动工作负载的正常群集，假如群集处于正常负载下，则可以在不影响它们的情况下应用升级。 但是，你应该有一个备份群集，以防需要将用户重定向到它。 强烈建议使用备份群集。
  • 如果可能，请从Azure Stack Hub环境中的 VM 运行命令，以减少网络跃点和潜在的连接故障。
  • 请确保订阅有足够的配额来完成整个过程。 进程将在此过程中分配新的 VM。 生成的 VM 的数量将与原始数量相同，但要对在该过程中创建更多的 VM 做好计划。
  • 未规划系统更新或计划的任务。
  • 在已使用与生产群集相同的值配置的群集上设置分阶段升级，并在其上测试升级，然后再在生产群集中执行此操作。

使用升级命令

必须根据 在 Azure Stack Hub 上升级 Kubernetes 群集 中的描述使用 aks-engine upgrade 命令。

升级中断

有时，意外的因素会中断群集的升级。 当 AKS 引擎报告了某个错误或在 AKS 引擎执行过程中发生某些事情时，可能会发生中断。 请检查中断的原因，解决问题，然后重新提交相同的 upgrade 命令以继续执行升级过程。 upgrade 命令是幂等的，在重新提交命令后应该会恢复群集的升级。 通常，中断会增加完成更新所需的时间，但不会影响它的完成。

估计的升级时间

群集中每个 VM 的估计升级时间为 12 到 15 分钟。 例如，升级包含 20 个节点的群集大约需要 5 小时。

下载新镜像和 AKS 引擎

下载 AKS 基础 Ubuntu 映像和 AKS 引擎的新版本。

如Azure Stack Hub上的 AKS 引擎文档中所述，部署 Kubernetes 群集需要：

  • aks-engine 二进制文件（必需）。
  • AKS 基础 Ubuntu 16.04-LTS 映像发行版（已弃用 - 不再使用，请在 API 模型中改用 18.04）。
  • AKS 基础 Ubuntu 18.04-LTS 映像发行版（对于 Linux 代理是必需的）。
  • AKS 基础 Windows Server 镜像发行版（Windows 代理需要）。

此更新提供了这些组件的新版本：

  • Azure Stack Hub 操作员必须将新的 AKS 基础映像下载到市场：

  • Kubernetes 群集管理员（通常是Azure Stack Hub的租户用户）必须下载新的 aks-engine。 请参阅 Azure Stack Hub（或等效Windows文章）在 Linux 上安装 AKS 引擎的说明。 你可以遵循首次安装群集的过程。 更新过程会覆盖以前的二进制文件。 例如，如果你使用了 get-akse.sh 脚本，请按照在联网环境中安装中所述的步骤进行操作。 如果要在 Windows 系统上安装，则此过程适用：在 Azure Stack HubWindows上安装 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月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 和操作系统平台的其他版本。 你可以忽略它们，并将上面的版本表作为此次更新的官方指南。

参考

以下列表是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 基础 Ubuntu 16.04-LTS 映像发行版？ 可以在“下载新映像和 AKS 引擎”部分中找到版本。
  • 是否为目标群集使用了正确的群集规范 (apimodel.json) 和资源组？ 最初部署群集时，已在输出目录中生成此文件。 请参阅部署 Kubernetes 群集的“deploy”命令参数。
  • 是否使用了可靠的计算机来运行 AKS 引擎并从中执行升级操作？
  • 如果要更新具有活动工作负载的正常群集，假如群集处于正常负载下，则可以在不影响它们的情况下应用升级。 但是，你应该有一个备份群集，以防需要将用户重定向到它。 强烈建议使用备份群集。
  • 如果可能，请从Azure Stack Hub环境中的 VM 运行命令，以减少网络跃点和潜在的连接故障。
  • 请确保订阅有足够的配额来完成整个过程。 进程将在此过程中分配新的 VM。 生成的 VM 的数量将与原始数量相同，但要对在该过程中创建更多的 VM 做好计划。
  • 未规划系统更新或计划的任务。
  • 在已使用与生产群集相同的值配置的群集上设置分阶段升级，并在其上测试升级，然后再在生产群集中执行此操作。

使用升级命令

必须按照在 Azure Stack Hub 上升级 Kubernetes 群集中的说明，使用aks-engine upgrade命令。

升级中断

有时，意外的因素会中断群集的升级。 当 AKS 引擎报告了某个错误或在 AKS 引擎执行过程中发生某些事情时，可能会发生中断。 请检查中断的原因，解决问题，然后重新提交相同的 upgrade 命令以继续执行升级过程。 upgrade 命令是幂等的，在重新提交命令后应该会恢复群集的升级。 通常，中断会增加完成更新所需的时间，但不会影响它的完成。

估计的升级时间

群集中每个 VM 的估计升级时间为 12 到 15 分钟。 例如，升级包含 20 个节点的群集大约需要 5 小时。

下载新镜像和 AKS 引擎

下载 AKS 基础 Ubuntu 镜像和 AKS 引擎的新版本。

如Azure Stack Hub上的 AKS 引擎文档中所述，部署 Kubernetes 群集需要两个主要组件：

  • aks-engine 二进制文件（必需）。
  • AKS 基础 Ubuntu 16.04-LTS 映像发行版

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

  • Azure Stack Hub 操作员必须将新的 AKS 基础 Ubuntu 映像下载到印记市场：

  • 姓名：AKS 基础 Ubuntu 16.04-LTS 映像发行版，2020 年 9 月 (2020.09.14)

  • 版本：2020.09.14

    按照 将 Azure Kubernetes 服务（AKS）引擎先决条件添加到 Azure Stack Hub 市场。

  • Kubernetes 群集管理员（通常是Azure Stack Hub的租户用户）必须下载新的 aks-engine。 请参阅 Azure Stack Hub（或等效Windows文章）在 Linux 上安装 AKS 引擎的说明。 你可以遵循首次安装群集的过程。 更新过程会覆盖以前的二进制文件。 例如，如果你使用了 get-akse.sh 脚本，请按照在联网环境中安装中所述的步骤进行操作。 如果要在 Windows 系统上安装，则此过程适用：在 Azure Stack HubWindows上安装 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）

最新动态

  • 将Azure Stack的 Linux VHD 更新为 2020.09.14 #3828
  • 在 Azure Stack #3702
  • 在 Azure Stack #3704
  • Linux VHD 更新到 2020.09.14 #3750
  • Windows VHD 更新至 8 月 #3730
  • 将 Kubernetes metrics-server 升级到 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 和操作系统平台的其他版本。 你可以忽略它们，并将上面的版本表作为此次更新的官方指南。

参考

这是 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 基础 Ubuntu 16.04-LTS 映像发行版？ 可以在下载新的 AKS 基础 Ubuntu 映像和 AKS 引擎版本部分中找到版本。
  • 是否为目标群集使用了正确的群集规范 (apimodel.json) 和资源组？ 最初部署群集时，已在输出目录中生成此文件。 请参阅部署 Kubernetes 群集的“deploy”命令参数。
  • 是否使用了可靠的计算机来运行 AKS 引擎并从中执行升级操作？
  • 如果要更新具有活动工作负载的正常群集，假如群集处于正常负载下，则可以在不影响它们的情况下应用升级。 但是，你应该有一个备份群集，以防需要将用户重定向到它。 强烈建议使用备份群集。
  • 如果可能，请从Azure Stack Hub环境中的 VM 运行命令，以减少网络跃点和潜在的连接故障。
  • 请确保订阅有足够的配额来完成整个过程。 进程将在此过程中分配新的 VM。 生成的 VM 的数量将与原始数量相同，但要对在该过程中创建更多的 VM 做好计划。
  • 未规划系统更新或计划的任务。
  • 在已使用与生产群集相同的值配置的群集上设置分阶段升级，并在其上测试升级，然后再在生产群集中执行此操作。

使用升级命令

必须根据 在 Azure Stack Hub 上升级 Kubernetes 群集 中的描述使用 aks-engine upgrade 命令。

升级中断

有时，意外的因素会中断群集的升级。 当 AKS 引擎报告了某个错误或在 AKS 引擎执行过程中发生某些事情时，可能会发生中断。 请检查中断的原因，解决问题，然后重新提交相同的 upgrade 命令以继续执行升级过程。 upgrade 命令是幂等的，在重新提交命令后应该会恢复群集的升级。 通常，中断会增加完成更新所需的时间，但不会影响它的完成。

估计的升级时间

群集中每个 VM 的估计升级时间为 12 到 15 分钟。 例如，升级包含 20 个节点的群集大约需要 5 小时。

下载新镜像和 AKS 引擎

下载 AKS 基础 Ubuntu 镜像和 AKS 引擎的新版本。

如Azure Stack Hub上的 AKS 引擎文档中所述，部署 Kubernetes 群集需要两个主要组件：

  • aks-engine 二进制文件（必需）。
  • AKS 基础 Ubuntu 16.04-LTS 映像发行版。

此更新提供了这些组件的新版本：

  • Azure Stack Hub 操作员必须将新的 AKS 基础映像下载到市场：

  • Kubernetes 群集管理员（通常是Azure Stack Hub的租户用户）必须下载新的 aks-engine。 请参阅 Azure Stack Hub（或等效Windows文章）在 Linux 上安装 AKS 引擎的说明。 你可以遵循首次安装群集的过程。 更新过程会覆盖以前的二进制文件。 例如，如果你使用了 get-akse.sh 脚本，请按照在联网环境中安装中所述的步骤进行操作。 如果要在 Windows 系统上安装，则此过程适用：在 Azure Stack HubWindows上安装 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 模型 .json 文件中显式提供 Kubernetes 版本，将使用版本 1.15（#2932），业务流程协调程序Version 将默认为 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 基础映像版本的可用性（#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) [安全性]。

  • 新的 hyperkube 更新支持 Kubernetes 版本 1.14.8 和 1.15.10。

  • 更新了 kubectl，使之与群集的 Kubernetes 版本匹配。 此组件在 Kubernetes 群集控制平面节点中提供，通过 SSH 连接到主节点即可运行它。

  • 使用最新2020年2月版本（#2850）的 Azure 容器监视器插件的更新。

  • 将 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 和操作系统平台的其他版本。 你可以忽略它们，并将上面的版本表作为此次更新的官方指南。

参考

下面列出了一些已修复的 bug，以及从版本 0.44.0 到 0.48.0 的完整发行说明。 发行说明包括Azure和Azure Stack Hub。

Bug 修复

  • Windows azure.json 中的 userAssignedIdentityId 缺少引号 （#2327）

  • 加载项update config只能升级（#2282）

  • 在 Windows 节点上增加获取管理 IP 的超时时间（#2284）

  • 将 1.0.28 Azure CNI .zip 文件添加到 Windows VHD（#2268）

  • 更正设置 IPAddressCount 的默认顺序（#2358）

  • 更新为使用单个 omsagent yaml 适用于所有 K8s 版本，以避免任何手动错误并提高维护的简便性（#2692）

发行说明

这是 Azure 和 Azure Stack Hub 的完整发布说明集：

后续步骤

  • Last updated on