使用英语阅读

通过

使用 Azure Kubernetes 服务 (AKS) 上适用于容器的 Windows Server 年度频道（预览版）

  • 项目
  • 2025/04/23

AKS 支持适用于容器的 Windows Server 年度频道（公共预览版）。 每个渠道版本每年发布一次，支持两年。 如果你需要增加创新周期和可迁移性，则此渠道非常有用。

Windows Server 年度频道版本基于节点池的 Kubernetes 版本。 若要从一个年度渠道版本升级到下一个年度渠道版本，可以升级到支持下一个年度渠道版本的 Kubernetes 版本。

重要

AKS 预览功能是基于自助服务和自愿选择启用的。 预览功能是“按现状”和“按可用”提供的，不包括在服务级别协议和有限保证中。 AKS 预览功能是由客户支持尽最大努力部分覆盖。 因此，这些功能并不适合用于生产。 有关详细信息，请参阅以下支持文章：

支持的年度频道版本

AKS 发布了对适用于容器的 Windows Server 年度道新版本的支持，与 Kubernetes 版本保持一致。 有关最新更新，请参阅 AKS 发行说明。 下表提供了即将发布的年度频道的预估发布计划：

K8s 版本 年度频道（主机）版本 支持的容器映像 终止支持日期
1.28 23H2（仅限预览版） Windows Server 2022 终止对1.33的支持
1.34 24H2 Windows Server 2022 和 Windows Server 2025 停止支持 1.35 版本
1.36 25H2 Windows Server 2025 终止 1.38 支持

Windows Server 年度频道与长期服务频道版本 (LTSC)

AKS 支持长期服务渠道版本 (LTSC)，包括 Windows Server 2022 和 Windows Server 2019。 这些版本来自与 Windows Server 容器年度发布渠道不同的渠道。 若要查看当前的建议，请参阅 Windows 最佳做法文档。

备注

在 Kubernetes 版本 1.32 达到其终止支持期限后，Windows Server 2019 将会退役，在 Kubernetes 版本 1.33 及更高版本中将不再受支持。 在 Kubernetes 版本 1.34 终止支持后，Windows Server 2022 将停用，Kubernetes 版本 1.35 及更高版本不支持。 有关详细信息，请参阅AKS 发行说明。

下表比较了 Windows Server 年度频道和长期服务频道版本：

通道 支持 升级
长期服务渠道 (LTSC) LTSC 渠道每三年发布一次，并获得五年的支持。 对于使用长期支持的客户，建议使用此渠道。 若要从一个版本升级到下一个版本，需要将节点池迁移到新的 OS SKU 选项，并使用新的 OS 版本重新生成容器映像。
适用于容器的 Windows Server 年度渠道 年度频道每年发布一次，提供两年支持。 若要升级到最新版本，可以升级节点池的 Kubernetes 版本。

开始之前

  • 需要安装和配置 Azure CLI 2.56.0 或更高版本，才能使用 os-sku 命令将 WindowsAnnual 设置为 az aks nodepool add。 运行 az --version 即可查找版本。 如果需要进行安装或升级，请参阅安装 Azure CLI。

限制

  • Windows Server 年度频道不支持 Azure 网络策略管理器。

安装 aks-preview Azure CLI 扩展

  • 使用 az extension add 或 az extension update 命令注册或更新 aks-preview 扩展。

    # Register the aks-preview extension
az extension add --name aks-preview
# Update the aks-preview extension
az extension update --name aks-preview

注册 AKSWindowsAnnualPreview 功能标志

  1. 使用 AKSWindowsAnnualPreview 命令注册 az feature register 功能标志。

    az feature register --namespace "Microsoft.ContainerService" --name "AKSWindowsAnnualPreview"

    几分钟后，状态将显示为“已注册”。

  2. 使用 az feature show 命令验证注册状态。

    az feature show --namespace "Microsoft.ContainerService" --name "AKSWindowsAnnualPreview"

  3. 当状态反映为已注册时，使用 命令刷新 az provider register 资源提供程序的注册。

    az provider register --namespace Microsoft.ContainerService

使用 AKS 上适用于容器的 Windows Server 年度频道

若要在 AKS 上使用 Windows Server 年度频道，请指定以下参数：

  • 将 os-type 设置为 Windows
  • 将 os-sku 设置为 WindowsAnnual

Windows Server 年度频道版本基于节点池的 Kubernetes 版本。 若要查看基于节点池的 Kubernetes 版本你可以获取的版本，请参阅支持的年度频道版本。

创建新的 Windows Server 年度频道节点池

  • 使用 az aks nodepool add 命令创建 Windows Server 年度频道节点池。 以下示例使用 23H2 版本创建 Windows Server 年度频道节点池：

    az aks nodepool add \
    --resource-group $RESOURCE_GROUP_NAME \
    --cluster-name $CLUSTER_NAME \
    --os-type Windows \
    --os-sku WindowsAnnual \
    --kubernetes-version 1.29
    --name $NODE_POOL_NAME \
    --node-count 1

    备注

    如果在创建节点池期间未指定 Kubernetes 版本，AKS 将使用与群集相同的 Kubernetes 版本。

验证 Windows Server 年度频道节点池的创建

  • 使用 kubectl describe node 命令检查节点池的 OS SKU，验证 Windows Server 年度频道节点池的创建状态。

    kubectl describe node $NODE_POOL_NAME

    如果已成功创建 Windows Server 年度频道节点池，应会看到以下输出：

    Name:               npwin
Roles:              agent
Labels:             agentpool=npwin
...
                    kubernetes.azure.com/os=windows
...
                    kubernetes.azure.com/node-image-version=AKSWindows-23H2-gen2
...
                    kubernetes.azure.com/os-sku=WindowsAnnual

将现有节点池升级到 Windows Server 年度频道

可以按照 升级 Azure Kubernetes 服务 （AKS） Windows 工作负载的 OS 版本中的指南，将现有节点池从 LTSC 版本升级到 Windows Server 年度频道。

若要从一个年度渠道版本升级到下一个年度渠道版本，可以升级到支持下一个年度渠道版本的 Kubernetes 版本。

后续步骤

若要详细了解 AKS 上的 Windows 容器，请参阅以下资源：

Windows 最佳做法Windows 常见问题解答