你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

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

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

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

重要

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

支持的年度渠道版本

AKS 版本支持与 Kubernetes 版本一致的 Windows Server 年度容器渠道的新版本。 有关最新更新,请参阅 AKS 发行说明。 下表提供了即将发布的年度渠道版本的预计发布计划:

K8s 版本 年度渠道(主机)版本 支持的容器映像 支持结束日期
1.28 23H2(仅限预览版) Windows Server 2022 终止 1.30 支持
1.31 24H2 Windows Server 2022 和 Windows Server 2025 终止 1.34 支持
1.35 25H2 Windows Server 2025 终止 1.38 支持

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

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

备注

Kubernetes 版本 1.32 终止后,Windows Server 2019 将停用;Kubernetes 版本 1.34 终止后,Windows Server 2022 将停用。 有关详细信息,请参阅AKS 发行说明

下表比较了 Windows 年度渠道和长期服务渠道版本:

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

开始之前

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

限制

  • Windows 年度渠道不支持 Azure 网络策略管理器 (NPM)。

安装 aks-preview Azure CLI 扩展

  • 使用 az extension addaz 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. 使用 az feature register 命令注册 AKSWindowsAnnualPreview 功能标志。

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

    状态显示为“已注册”需要几分钟时间

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

    az feature show --namespace "Microsoft.ContainerService" --name "AKSWindowsAnnualPreview"
    
  3. 当状态反映为已注册时,使用 az provider register 命令刷新 Microsoft.ContainerService 资源提供程序的注册。

    az provider register --namespace Microsoft.ContainerService
    

在 AKS 上使用 Windows 年度容器渠道

若要在 AKS 上使用 Windows 年度渠道,请指定以下参数:

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

Windows 年度渠道版本基于节点池的 Kubernetes 版本。 若要查看基于节点池的 Kubernetes 版本您会获取的版本,请参阅支持的年度渠道版本

创建新的 Windows 年度渠道节点池

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

    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 年度渠道节点池的创建

  • 使用 kubectl describe node 命令检查节点池的 OS SKU,验证 Windows 年度渠道节点池的创建。

    kubectl describe node $NODE_POOL_NAME
    

    如果已成功创建 Windows 年度渠道节点池,应会看到以下输出:

    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 年度渠道

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

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

后续步骤

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