Compartir a través de

Uso del Canal anual de Windows para contenedores en Azure Kubernetes Service (AKS) (versión preliminar)

  • Artículo

AKS es compatible con el Canal anual de Windows Server para contenedores en versión preliminar. Cada versión del canal se publica anualmente y tiene soporte durante dos años. Este canal es beneficioso si necesita mayores ciclos de innovación y portabilidad.

Las versiones del Canal anual de Windows se basan en la versión de Kubernetes de su grupo de nodos. Para pasar de una versión del Canal anual a la siguiente, puede actualizar a una versión de Kubernetes compatible con la siguiente versión del Canal anual.

Importante

Las características en versión preliminar de AKS están disponibles como opción de participación y autoservicio. Las versiones preliminares se proporcionan "tal cual" y "como están disponibles", y están excluidas de los Acuerdos de nivel de servicio y garantía limitada. Las versiones preliminares de AKS reciben cobertura parcial del soporte al cliente en la medida de lo posible. Por lo tanto, estas características no están diseñadas para su uso en producción. Para más información, consulte los siguientes artículos de soporte:

Versiones compatibles del Canal anual

AKS ofrece compatibilidad con las nuevas versiones del Canal anual de Windows Server para contenedores en consonancia con las versiones de Kubernetes. Para obtener las actualizaciones más recientes, consulte las notas de la versión de AKS. La siguiente tabla ofrece una programación estimada de los próximos lanzamientos del Canal anual:

Versión de K8s Versión anual del canal (host) Imágenes de contenedor compatibles Fecha de finalización de soporte técnico
1.28 23H2 (solo versión preliminar) Windows Server 2022 Finalización del soporte de 1.30
1,31 24H2 Windows Server 2022 y Windows Server 2025 Finalización del soporte de 1.34
1,35 25H2 Windows Server 2025 Finalización del soporte de 1.38

Diferencias entre versiones del Canal anual de Windows y versiones del Canal de mantenimiento a largo plazo (LTSC)

AKS es compatible con las versiones del Canal de mantenimiento a largo plazo (LTSC), incluidos Windows Server 2022 y Windows Server 2019. Proceden de un canal de publicación distinto al Canal anual de Windows Server para contenedores. Para ver nuestras recomendaciones actuales, consulte la documentación sobre Procedimientos recomendados para Windows.

Nota:

Windows Server 2019 se retirará después de que la versión 1.32 de Kubernetes llegue al final de su vida útil, y Windows Server 2022 se retirará después de que la versión 1.34 de Kubernetes llegue al final de su vida útil. Para obtener más información, vea las notas de la versión de AKS.

En la tabla siguiente se comparan los lanzamientos del Canal anual de Windows y del Canal de mantenimiento a largo plazo:

Canal Soporte técnico Actualizaciones
Canal de mantenimiento a largo plazo (LTSC) Los canales del LTSC se lanzan cada tres años y tienen soporte durante cinco años. Este canal se recomienda a los clientes que usan el Soporte a largo plazo. Para actualizar de una versión a la siguiente, deberá migrar sus grupos de nodos a una nueva opción de SKU de sistema operativo y recompilar sus imágenes de contenedor con la nueva versión de sistema operativo.
Canal anual para contenedores Las versiones del Canal anual se producen anualmente y tienen soporte durante dos años. Para actualizar a la última versión, puede actualizar la versión de Kubernetes de su grupo de nodos.

Antes de empezar

  • Necesita la versión 2.56.0 o posterior de la CLI de Azure instalada y configurada para establecer os-sku en WindowsAnnual con el comando az aks nodepool add. Ejecute az --version para encontrar la versión. Si necesita instalarla o actualizarla, vea Instalación de la CLI de Azure.

Limitaciones

  • El Canal anual de Windows no es compatible con Azure Network Policy Manager (NPM).

Instalación de la extensión de la CLI de Azure aks-preview

  • Registre o actualice la extensión aks-preview mediante el comando az extension add o az extension update.

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

Registro de la marca de característica AKSWindowsAnnualPreview

  1. Registre la marca de características de AKSWindowsAnnualPreview mediante el comando az feature register.

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

    Tarda unos minutos en que el estado muestre Registrado.

  2. Comprobar el estado del registro mediante el comando az feature show.

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

  3. Cuando aparezca el estado Registrado, actualice el registro del proveedor de recursos Microsoft.ContainerService mediante el comando az provider register.

    az provider register --namespace Microsoft.ContainerService

Uso del Canal anual de Windows para contenedores en AKS

Para usar el Canal anual de Windows en AKS, especifique los siguientes parámetros:

  • os-type se establece en Windows
  • os-sku se establece en WindowsAnnual

Las versiones del Canal anual de Windows se basan en la versión de Kubernetes de su grupo de nodos. Para comprobar qué versión obtendrá en función de la versión de Kubernetes de su grupo de nodos, consulte las versiones compatibles del Canal anual.

Creación de un nuevo grupo de nodos del Canal anual de Windows

  • Creación de un grupo de nodos del Canal anual de Windows usando el comando az aks nodepool add. El siguiente ejemplo crea un grupo de nodos del Canal anual de Windows con la versión 23H2:

    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

    Nota:

    Si no especifica la versión de Kubernetes durante la creación del grupo de nodos, AKS usará la misma versión de Kubernetes que su clúster.

Comprobación de la creación del grupo de nodos del Canal anual de Windows

  • Compruebe la creación del grupo de nodos del Canal anual de Windows comprobando la SKU del sistema operativo del grupo de nodos mediante el comando kubectl describe node.

    kubectl describe node $NODE_POOL_NAME

    Si ha creado con éxito un grupo de nodos del Canal anual de Windows, debería ver la siguiente salida:

    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

Actualización de un grupo de nodos existente al Canal anual de Windows

Puede actualizar un grupo de nodos existente desde una versión de LTSC al Canal anual de Windows siguiendo las indicaciones en Actualización de la versión del sistema operativo para las cargas de trabajo de Windows de Azure Kubernetes Service (AKS).

Para pasar de una versión del Canal anual a la siguiente, puede actualizar a una versión de Kubernetes compatible con la siguiente versión del Canal anual.

Pasos siguientes

Para más información sobre los contenedores de Windows en AKS, consulte los siguientes recursos:

Procedimientos recomendados para WindowsPreguntas frecuentes sobre Windows