Partager via


Utiliser le canal annuel Windows pour conteneurs sur Azure Kubernetes Service (AKS) (préversion)

AKS prend en charge Canal annuel Windows Server pour conteneurs en préversion publique. Chaque version de canal est publiée annuellement et est prise en charge pendant deux ans. Ce canal est bénéfique si vous nécessitez des cycles d’innovation et une portabilité accrus.

Les versions de canal annuel Windows sont basées sur la version Kubernetes de votre pool de nœuds. Pour effectuer une mise à niveau d’une version de canal annuel vers la suivante, vous pouvez mettre à niveau vers une version Kubernetes qui prend en charge la prochaine version du canal annuel.

Important

Les fonctionnalités d’évaluation AKS sont disponibles en libre-service et font l’objet d’un abonnement. Les préversions sont fournies « en l’état » et « en fonction des disponibilités », et sont exclues des contrats de niveau de service et de la garantie limitée. Les préversions AKS sont, dans la mesure du possible, partiellement couvertes par le service clientèle. Telles quelles, ces fonctionnalités ne sont pas destinées à une utilisation en production. Pour plus d’informations, consultez les articles de support suivants :

Versions de canal annuel prises en charge

Prise en charge des versions AKS pour les nouvelles versions de Canal annuel Windows Server pour conteneurs en alignement avec les versions de Kubernetes. Pour les dernières mises à jour, consultez les Notes de publication AKS. Le tableau suivant fournit une planification de publication estimée pour les prochaines versions du canal annuel :

Version de K8s Version du canal annuel (hôte) Image conteneur prise en charge Date de fin de prise en charge
1.28 23H2 (préversion uniquement) Windows Server 2022 Fin de support 1.30
1,31 24H2 Windows Server 2022 et Windows Server 2025 Fin de support 1.34
1,35 25H2 Windows Server 2025 Fin de support 1.38

Version de canal annuel Windows par rapport à la version de Canal de maintenance à long terme (LTSC)

AKS prend en charge les versions de Canal de maintenance à long terme (LTSC), notamment Windows Server 2022 et Windows Server 2019. Ceux-ci proviennent d’un canal de mise en production différent de celui du canal annuel Windows Server pour conteneurs. Pour afficher nos recommandations actuelles, consultez la documentation sur les meilleures pratiques Windows.

Remarque

Windows Server 2019 sera hors service après la fin de vie de Kubernetes version 1.32 et Windows Server 2022 sera hors service après la fin de vie de Kubernetes version 1.34. Pour plus d’informations, consultez les notes de publication de la version AKS.

Le tableau suivant compare les versions du Canal annuel Windows et du Canal de maintenance à long terme :

Canal Support Mises à niveau
Canal de maintenance à long terme (LTSC) Les canaux LTSC sont publiés tous les trois ans et sont pris en charge pendant cinq ans. Ce canal est recommandé pour les clients qui utilisent le support à long terme. Pour effectuer une mise à niveau d’une version vers la suivante, vous devez migrer vos pools de nœuds vers une nouvelle option de référence SKU du système d’exploitation et reconstruire vos images conteneur avec la nouvelle version du système d’exploitation.
Canal annuel pour conteneurs Les versions annuelles du canal se produisent annuellement et sont prises en charge pendant deux ans. Pour effectuer une mise à niveau vers la dernière version, vous pouvez mettre à niveau la version Kubernetes de votre pool de nœuds.

Avant de commencer

  • Vous avez besoin d’Azure CLI version 2.56.0 ou ultérieure installée et configurée pour définir os-sku sur WindowsAnnual avec la commande az aks nodepool add . Exécutez az --version pour trouver la version. Si vous devez installer ou mettre à niveau, voir Installer Azure CLI.

Limites

  • Le canal annuel Windows ne prend pas en charge Azure Network Policy Manager (NPM).

Installez l’extension Azure CLI aks-preview.

  • Inscrivez ou mettez à jour l’extension aks-preview à l’aide de la commande az extension add ou 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
    

Inscrire l’indicateur de fonctionnalité AKSWindowsAnnualPreview

  1. Inscrivez l’indicateur de fonctionnalité AKSWindowsAnnualPreview à l’aide de la commande az feature register.

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

    Quelques minutes sont nécessaires pour que l’état s’affiche Registered (Inscrit).

  2. Vérifiez l’état de l’inscription en utilisant la commande az feature show.

    az feature show --namespace "Microsoft.ContainerService" --name "AKSWindowsAnnualPreview"
    
  3. Quand l’état reflète Inscrit, actualisez l’inscription du fournisseur de ressources Microsoft.ContainerService à l’aide de la commande az provider register.

    az provider register --namespace Microsoft.ContainerService
    

Utiliser le canal annuel Windows pour conteneurs sur AKS

Pour utiliser le canal annuel Windows sur AKS, spécifiez les paramètres suivants :

  • os-type défini sur Windows
  • os-sku défini sur WindowsAnnual

Les versions de canal annuel Windows sont basées sur la version Kubernetes de votre pool de nœuds. Pour vérifier la version que vous obtiendrez en fonction de la version Kubernetes de votre pool de nœuds, consultez les versions de Canal annuel prises en charge.

Créer un pool de nœuds de Canal annuel Windows

  • Créez un pool de nœuds de Canal annuel Windows à l’aide de la commande az aks nodepool add. L’exemple suivant crée un pool de nœuds de Canal annuel Windows avec la version 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
    

    Remarque

    Si vous ne spécifiez pas la version Kubernetes lors de la création du pool de nœuds, AKS utilise la même version Kubernetes que votre cluster.

Vérifier la création du pool de nœuds de Canal annuel Windows

  • Vérifiez la création du pool de nœuds de Canal annuel Windows en vérifiant la référence SKU du système d’exploitation de votre pool de nœuds à l’aide de la commande kubectl describe node.

    kubectl describe node $NODE_POOL_NAME
    

    Si vous avez créé un pool de nœuds de Canal annuel Windows, vous devez voir la sortie suivante :

    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
    

Mettre à niveau un pool de nœuds existant vers le Canal annuel Windows

Vous pouvez mettre à niveau un pool de nœuds existant d’une version LTSC vers le Canal annuel Windows en suivant les instructions de Mettre à niveau la version du système d’exploitation pour vos charges de travail Azure Kubernetes Service (AKS) Windows .

Pour effectuer une mise à niveau d’une version de canal annuel vers la suivante, vous pouvez mettre à niveau vers une version Kubernetes qui prend en charge la prochaine version du canal annuel.

Étapes suivantes

Pour en savoir plus sur les conteneurs Windows sur AKS, consultez les ressources suivantes :