Rétablir les versions des pools de nœuds dans Azure Kubernetes Service (AKS) (version préliminaire)

La fonctionnalité de restauration de version du pool de nœuds dans Azure Kubernetes Service (AKS) vous permet de récupérer des comportements inattendus après les mises à niveau de Kubernetes. Si des problèmes se produisent, vous pouvez restaurer des pools de nœuds vers la version et la combinaison d’images de nœud Kubernetes précédentes, ce qui garantit la continuité de l’activité et réduit le temps d’arrêt. Cet article explique quand et comment utiliser la fonctionnalité de restauration, ses fonctionnalités et ses limitations, ainsi que les meilleures pratiques pour les actions postérieures à la restauration.

Prerequisites

  • Azure CLI version 2.64.0 ou ultérieure. Recherchez votre version à l’aide de la az --version commande. Si vous devez installer ou mettre à niveau, consultez Installer Azure CLI.
  • L’extension aks-preview Azure CLI installée et mise à jour vers la dernière version.
  • Version 2025-08-02-preview de l’API ou ultérieure.

Installer l’extension aks-preview Azure CLI

Important

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

Installez ou mettez à jour l’extension aks-preview à l’aide des commandes az extension add et az extension update.

# Install the aks-preview extension
az extension add --name aks-preview

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

Fonctionnalités prises en charge pour le retour à une version antérieure du pool de nœuds

La fonctionnalité de rétablissement de version des pools de nœuds prend en charge les capacités suivantes :

Caractéristique Descriptif
Rétablir la version Rétablit à la fois la version de Kubernetes et la version de l’image des nœuds à leur état précédent.
Déclencheur manuel, exécution automatique La restauration nécessite une initiation manuelle, mais une fois déclenchée, le système gère automatiquement l’ensemble du processus de restauration sans intervention supplémentaire.
Compatibilité du pool de nœuds Fonctionne sur tous les types de pools de nœuds, y compris les pools de machines virtuelles et les pools de nœuds basés sur Virtual Machine Scale Sets (VMSS).
Prise en charge du système d’exploitation Compatible avec toutes les unités de gestion de stock des systèmes d'exploitation (SKUs), notamment Ubuntu, Azure Linux et les pools Windows.
Processus simplifié Aucune gestion des instantanés n’est requise.

Limitations et considérations relatives au rétablissement des pools de nœuds

Gardez à l’esprit les limitations suivantes lors de l’utilisation de la fonctionnalité de rétablissement des pools de nœuds :

  • Limité aux modifications de version uniquement. Les autres modifications apportées au pool de nœuds ne sont pas rétablies.
  • Aucune opération simultanée n’est autorisée pendant le rétablissement.
  • Si cette option est configurée, vous devez désactiver la mise à niveau automatique du cluster avant la restauration.
  • Disponible uniquement pendant sept jours après la fin de la mise à niveau.
  • Impossible d’effectuer des rétablissements consécutifs pour revenir à plusieurs versions en arrière.
  • La restauration ne prend pas en charge l’annulation des modifications du SKU du système d’exploitation. Si vous avez modifié la référence SKU du système d’exploitation de votre pool de nœuds (par exemple, d’Ubuntu à Azure Linux), la restauration tente de restaurer la version précédente de l’image de nœud, qui appartient à une autre référence SKU de système d’exploitation et est rejetée. Pour rétablir une modification de la référence SKU du système d’exploitation, utilisez plutôt la commande az aks nodepool update --os-sku.

Gardez à l’esprit les considérations suivantes lors de l’utilisation de la restauration du pool de nœuds :

Implications en matière de sécurité Considérations opérationnelles
* Exposition aux vulnérabilités : la restauration supprime les correctifs de sécurité et les mises à jour de la version plus récente. Par conséquent, nous vous recommandons d’utiliser le retour en arrière uniquement temporairement pour résoudre les problèmes, puis de procéder à une nouvelle mise à niveau dès que possible. * Interruption de service : le processus de restauration peut entraîner des interruptions de charge de travail temporaires.
* Disponibilité des ressources : garantir une capacité suffisante pour l’opération de rollback.
* Exigences de test : prévoyez de résoudre les problèmes sous-jacents avant de réessayer de procéder à des mises à niveau.

Pourquoi utiliser le rétablissement ?

Le rollback fournit un mécanisme de récupération critique pour les environnements de production :

  • Continuité de l’activité : réduire les temps d’arrêt lorsque les mises à niveau provoquent des problèmes inattendus
  • Atténuation des risques : restaurer rapidement des configurations connues sans procédures de récupération complexes
  • Récupération simplifiée : Éviter une intervention manuelle ou reconstruire des clusters à partir de sauvegardes

Quand utiliser le rétablissement du pool de nœuds

Envisagez la restauration comme option de récupération dans les scénarios suivants :

  • Les échecs de mise à niveau se produisent : les problèmes d’infrastructure, les contraintes de ressources ou les problèmes de compatibilité empêchent les mises à niveau réussies.
  • Interruption des applications : les charges de travail rencontrent des défaillances critiques ou une altération des données avec des versions plus récentes de Kubernetes.
  • Dégradations des performances : les nouvelles versions entraînent une latence inacceptable, des problèmes de débit ou une consommation de ressources.
  • Les lacunes de test émergent : les problèmes de production qui n’ont pas été interceptés pendant les tests de préproduction.

Workflow du rétablissement du pool de nœuds

Le diagramme suivant illustre le processus de rollback du pool de nœuds :

Diagramme montrant le flux de travail de restauration du pool de nœuds.

Le processus de restauration restaure tous les nœuds d’un pool de nœuds à leur état de version précédent. Les principaux aspects du flux de travail sont les suivants :

  • Approche tout-ou-rien : tous les nœuds doivent revenir à la version précédente pour que la restauration se termine correctement. Si un nœud ne parvient pas à revenir en arrière, l’opération entière échoue afin de communiquer clairement l’état du cluster, comme lors d’une opération de mise à niveau.
  • Suivi de la progression : surveillez l’état du rétablissement à l’aide du journal d’activité Azure pour l’historique des opérations et de l’API Operation Status pour des mises à jour en temps réel.

Rétablir une version d’un pool de nœuds

Important

Gardez les informations suivantes à l’esprit lors du rétablissement d’une version de pool de nœuds :

  • Rester sur les versions antérieures augmente les risques de sécurité à long terme et peut éventuellement empêcher les mises à niveau en raison des limitations d’asymétrie de version. Traitez le retour en arrière comme un mécanisme de récupération temporaire, et non comme une solution permanente.
  • Lorsque vous utilisez l’API REST, vous pouvez d’abord appeler l’API Get Upgrade Profile pour récupérer les versions récemment utilisées. Utilisez ces informations pour spécifier la version cible dans votre demande de restauration.

  • Rétablissez une version de pool de nœuds à l’aide de la commande az aks nodepool rollback. L’exemple suivant restaure le pool de nœuds nommé myNodePool dans le cluster AKS nommé myAKSCluster dans le groupe myResourceGroupde ressources :

    az aks nodepool rollback --name myNodePool --resource-group myResourceGroup --cluster-name myAKSCluster

Surveiller l’état du rétablissement du pool de nœuds

Vous pouvez utiliser les méthodes suivantes pour surveiller l’état d’une opération de restauration de pool de nœuds et valider une restauration réussie :

Bonnes pratiques après un rétablissement

Après avoir réussi à restaurer votre pool de nœuds, utilisez les meilleures pratiques suivantes pour garantir la stabilité et la sécurité :

  • Examinez la cause racine : identifiez pourquoi la mise à niveau a échoué avant d’essayer une autre mise à niveau. Passez en revue les journaux d’activité des applications, les métriques de ressources et les exigences de compatibilité.
  • Test dans la non-production : validez la version la plus récente dans un environnement de développement ou de préproduction pour reproduire et résoudre les problèmes avant la mise à niveau de la production.
  • Planifiez votre nouvelle mise à niveau : ne restez pas sur la version restaurée indéfiniment. Planifiez une nouvelle mise à niveau pour maintenir les correctifs de sécurité et la prise en charge :
    • Pour les problèmes de sécurité critiques : mise à jour dans les quelques jours suivant la validation des correctifs.
    • Pour les problèmes de compatibilité des applications : remettre à niveau dans les semaines après les ajustements du code.
    • Délai maximal recommandé : 30 jours pour éviter l’accumulation de vulnérabilités de sécurité.

Questions Fréquemment Posées (FAQ)

Puis-je effectuer d’autres opérations pendant la restauration d’un pool de nœuds ?

Non, le retrait doit se terminer avant de démarrer d'autres opérations. Pour effectuer d’autres opérations, commencez par annuler le rétablissement.

Le rétablissement du pool de nœuds rétablit-il à la fois la version de Kubernetes et l’image des nœuds ?

Oui, le rétablissement revient à la dernière version de Kubernetes utilisée et à son image de nœud correspondante. Si les deux composants ont changé, le système restaure la version de Kubernetes précédente avec la dernière image de nœud compatible pour cette version.

Puis-je restaurer uniquement l’image de nœud sans modifier la version du pool de nœuds ?

Oui, si vous n’avez effectué qu’une mise à jour d’image de nœud au cours des sept derniers jours (sans mettre à niveau la version du pool de nœuds), la restauration restaure l’image de disque dur virtuel (VHD) précédente tout en conservant la même version de Kubernetes.

Puis-je revenir à une version hors support ?

Non, vous ne pouvez pas revenir à une version Kubernetes qui n’est plus prise en charge par AKS. Par exemple, si votre pool de nœuds était sur la version 1.27.9 (désormais hors prise en charge) et que vous avez effectué une mise à niveau vers la version 1.28.5, vous ne pouvez pas revenir à la version 1.27.9, car il n’est plus dans la liste des versions prises en charge. Vérifiez toujours la stratégie de prise en charge de la version d’AKS Kubernetes pour vérifier la disponibilité de la version.

Dois-je désactiver la mise à niveau automatique avant d’effectuer un rétablissement du pool de nœuds ?

Oui, si la mise à niveau automatique de votre cluster est activée, vous devez la désactiver avant d’effectuer une restauration. En outre, si le cluster est inclus dans un groupe de mise à jour dans un profil de mise à niveau automatique d'Azure Kubernetes Fleet Manager, vous devez supprimer le cluster du groupe de mise à jour avant d’effectuer la restauration. Sinon, le processus de mise à niveau automatique pourrait mettre à niveau à nouveau votre pool de nœuds une fois le rétablissement terminé.

Puis-je restaurer après avoir modifié la référence SKU du système d’exploitation (par exemple, d’Ubuntu à Azure Linux) ?

Non. La restauration d’un pool de nœuds est limitée aux changements de version et ne rétablit pas les modifications du SKU du système d’exploitation. Après la migration d’une référence SKU de système d’exploitation vers une autre (par exemple, Ubuntu vers Azure Linux), la version précédente de l’image de nœud appartient à l’ancienne référence SKU du système d’exploitation et est incompatible avec la configuration actuelle. L’opération de restauration rejette la version précédente de l’image avec une erreur similaire à :

NodeImageVersion 'AKSUbuntu-2204gen2containerd-202602.13.5' is not accepted. NodeImageVersion can only be current version 'AKSAzureLinux-V3gen2-202602.13.5' or 'latest'

Pour rétablir la référence SKU du système d’exploitation, utilisez la az aks nodepool update commande avec le --os-sku paramètre. Pour plus d’informations, consultez Restaurer votre version du système d’exploitation.

Contenu connexe

Pour en savoir plus sur les mises à niveau de pool de nœuds dans AKS, consultez les articles suivants :

  • Last updated on