Désactiver la fonctionnalité de pool de nœuds Windows sur les versions locales d’Azure antérieures à 2509

> S’applique à : AKS sur Azure Local version 2508 et antérieure

La fonctionnalité de pool de nœuds Windows est désactivée par défaut dans azure Local release 2509 et versions ultérieures. Si vous utilisez Azure Local version 2508 ou antérieure, vous pouvez suivre les étapes décrites dans cet article pour désactiver la fonctionnalité de pool de nœuds Windows. Pour les versions 2509 et ultérieures, consultez Activer la fonctionnalité de pool de nœuds Windows.

Cet article explique comment désactiver la fonctionnalité de pool de nœuds Windows pour Azure Kubernetes Service (AKS) sur Azure Local versions 2508 et antérieures. Vous pouvez désactiver cette fonctionnalité pour empêcher le téléchargement automatique des disques durs virtuels Windows (disques durs virtuels), dont la taille est d’environ 20 Go et qui sont nécessaires à la création de pools de nœuds Windows. Ainsi, les entreprises disposant d’une bande passante Internet limitée peuvent éviter les téléchargements inutiles, en particulier si leurs charges de travail utilisent exclusivement des conteneurs Linux. Cela permet d’optimiser l’utilisation de la bande passante et simplifie la gestion des ressources pour les environnements où les nœuds Windows ne sont pas nécessaires.

Avant de commencer

Avant de commencer, vérifiez que les conditions préalables suivantes sont en place :

  • Azure Local déployé. Cet article s’applique uniquement si vous avez déjà déployé Azure Local (version 2508 ou antérieure). Vous ne pouvez pas exécuter les commandes de cet article avant de déployer Azure Local. Actuellement, nous ne prenons pas en charge la possibilité d’apporter cette modification avant le déploiement initial d’Azure Local.
  • Autorisations RBAC Azure pour mettre à jour la configuration locale Azure. Vérifiez que vous disposez des rôles suivants. Pour plus d’informations, consultez les autorisations requises pour le déploiement :
    • Administrateur local Azure
    • Lecteur
  • Emplacement personnalisé. Nom de l’emplacement personnalisé. L’emplacement personnalisé est configuré pendant le déploiement local Azure. Si vous êtes dans le Portail Azure, accédez à la page Serveur de vue d’ensemble > dans la ressource du système local Azure. Vous devez voir un emplacement personnalisé pour votre cluster.
  • Groupe de ressources Azure. Groupe de ressources Azure dans lequel Azure Local est déployé.

Pour simplifier la configuration, les étapes suivantes définissent les variables d’environnement référencées dans cet article. N’oubliez pas de remplacer les valeurs affichées par vos propres valeurs.

Définissez l’emplacement personnalisé et les valeurs du groupe de ressources dans les variables d’environnement :

$customlocationName = <The custom location name for Azure Local>
$resourceGroup = <The Azure resource group in which Azure Local is deployed>

Exécutez ensuite la commande suivante pour obtenir le clusterName paramètre. Ce paramètre est le nom du pont de ressources Arc que vous avez déployé sur Azure Local :

az customlocation show -n $customlocationName -g $resourceGroup --query hostResourceId

Sortie attendue :

/subscriptions/f3dwer-00000-4383-2345-00000/resourceGroups/SanJose/providers/Microsoft.ResourceConnector/appliances/sanjose-arcbridge

Dans cette sortie, sanjose-arcbridge est le nom du pont de ressources Arc que vous avez déployé sur le cluster local Azure. Ce nom est différent pour votre déploiement.

$clusterName = <Name of Arc resource bridge deployed on the Azure Local cluster>

Ensuite, obtenez le nom de l’extension AKS Arc que vous avez déployée à l’emplacement personnalisé. Pour obtenir ce nom, exécutez la commande suivante pour répertorier les extensions installées sur l’emplacement personnalisé :

az customlocation show -n $customlocationID -g $resourceGroup --query clusterExtensionIds -o tsv

Sortie attendue :

/subscriptions/fbaf508b-cb61-4383-9cda-a42bfa0c7bc9/resourceGroups/SanJose/providers/Microsoft.ResourceConnector/appliances/sanjose-arcbridge/providers/Microsoft.KubernetesConfiguration/extensions/hybridaksextension
/subscriptions/fbaf508b-cb61-4383-9cda-a42bfa0c7bc9/resourceGroups/SanJose/providers/Microsoft.ResourceConnector/appliances/sanjose-arcbridge/providers/Microsoft.KubernetesConfiguration/extensions/vmss-hci

Vous devez avoir deux extensions installées sur votre emplacement personnalisé : akS Arc et la gestion des machines virtuelles Arc. Copiez le nom de l’extension pour AKS dans une variable d’environnement. Dans l’exemple de sortie, le nom de l’extension est hybridaksextension. Il peut être différent de ce que vous voyez :

$extensionName = <Name of AKS Arc extension you deployed on the custom location>

Une fois que vous avez le nom de l’extension, créez des variables pour les paramètres suivants, puis désactivez la fonctionnalité de pool de nœuds Windows :

$extensionVersion = "$(az k8s-extension show -n $extensionName  -g $resourceGroup -c $clusterName --cluster-type appliances --query version -o tsv)"
$releaseTrain = "$(az k8s-extension show -n $extensionName -g $resourceGroup -c $clusterName --cluster-type appliances --query releaseTrain -o tsv)"
az k8s-extension update --resource-group $resourceGroup --cluster-name $clusterName --cluster-type appliances --name $extensionName --version $extensionVersion --release-train $releaseTrain --config disable-windows-nodepool=true --yes

Autre option : désactiver le pool de nœuds Windows après la connexion à un nœud physique local Azure via le Bureau à distance

Si, pour une raison quelconque, vous n’êtes pas en mesure d’utiliser Azure CloudShell ou une machine avec une connectivité à Azure afin de désactiver le pool de nœuds Windows, vous pouvez désactiver le pool de nœuds Windows après la connexion à l’un des nœuds physiques locaux Azure avec le Bureau à distance. Vous devez d’abord vous connecter à Azure.

az login --use-device-code --tenant <Azure tenant ID>
az account set -s <subscription ID>
$res=get-archcimgmt

az k8s-extension update --resource-group $res.HybridaksExtension.resourceGroup --cluster-name $res.ResourceBridge.name --cluster-type appliances --name $res.HybridaksExtension.name --version $res.HybridaksExtension.version --release-train  $res.HybridaksExtension.releaseTrain --config disable-windows-nodepool=true --yes

Vérifiez si la fonctionnalité de pool de nœuds Windows est désactivée

Vous pouvez vérifier si les paramètres de configuration ont été appliqués en exécutant az k8s-extension show, comme suit :

az k8s-extension show --name $extensionName --resource-group $resourceGroup --cluster-name $clusterName --cluster-type appliances --query configurationSettings

Sortie attendue :

...
"disable-windows-nodepool": "true",
...

Ensuite, vérifiez si les pools de nœuds Windows ont été désactivés en exécutant la commande suivante :

az aksarc get-versions --resource-group $resourceGroup --custom-location $customlocationName

La sortie de osType=Windows doit afficher « La fonctionnalité de pool de nœuds Windows est désactivée » et l’état de ready doit être false, pour chaque option de version Kubernetes :

...
"1.27.7": {
            "readiness": [
              {
                "errorMessage": null,
                "osSku": "CBLMariner",
                "osType": "Linux",
                "ready": true
              },
              {
                "errorMessage": "Windows node pool feature is disabled",
                "osSku": "Windows2019",
                "osType": "Windows",
                "ready": false
              },
              {
                "errorMessage": "Windows node pool feature is disabled",
                "osSku": "Windows2022",
                "osType": "Windows",
                "ready": false
              }
            ],
...

Questions fréquentes (FAQ)

Que se passe-t-il si j’essaie de désactiver les pools de nœuds Windows alors qu'ils existent sur au moins un cluster AKS dans le déploiement local d'Azure ?

À compter de la version 2509, la fonctionnalité de pool de nœuds Windows est désactivée par défaut. Cette modification améliore l’expérience de téléchargement en évitant les téléchargements inutiles du Windows VHD quand ce n'est pas nécessaire.

Si vous avez créé des clusters existants avant cette build qui incluent des pools de nœuds Windows, vous pouvez réactiver la fonctionnalité en fonction des besoins. Toutefois, si la fonctionnalité reste désactivée, les mises à niveau de cluster ne réussissent pas tant que les pools de nœuds Windows existent toujours. Il est recommandé de supprimer tous les pools de nœuds Windows avant de mettre à niveau Azure Local ou AKS Arc.

Pour garantir une expérience de mise à niveau fluide, réactivez la fonctionnalité de pool de nœuds Windows si vous envisagez de continuer à utiliser des pools de nœuds Windows, ou supprimez tous les pools de nœuds Windows de vos clusters.

Que se passe-t-il pour les disques durs virtuels Windows téléchargés si je désactive les pools de nœuds Windows ?

Les VHD Windows précédemment téléchargés sont automatiquement supprimés si la fonctionnalité de pools de nœuds Windows est désactivée. Vous pouvez vérifier si les disques durs virtuels Windows ont été supprimés en vérifiant les chemins de stockage local Azure. La suppression peut prendre un certain temps. Attendez 30 minutes avant de vérifier. Vous devez vérifier tous les chemins de stockage, car les disques durs virtuels Windows sont affectés aux chemins de stockage de manière tourniquet, en fonction de la capacité de stockage disponible.

Étapes suivantes

  • Last updated on