Partager via


az aks nodepool

Note

Ce groupe de commandes a des commandes définies dans Azure CLI et au moins une extension. Installez chaque extension pour bénéficier de ses fonctionnalités étendues. Apprenez-en davantage sur les extensions.

Commandes pour gérer les pools de nœuds dans le cluster Kubernetes Kubernetes.

Commandes

Nom Description Type État
az aks nodepool add

Ajoutez un pool de nœuds au cluster Kubernetes managé.

Core GA
az aks nodepool add (aks-preview extension)

Ajoutez un pool de nœuds au cluster Kubernetes managé.

Extension GA
az aks nodepool delete

Supprimez le pool d’agents dans le cluster Kubernetes managé.

Core GA
az aks nodepool delete (aks-preview extension)

Supprimez le pool d’agents dans le cluster Kubernetes managé.

Extension GA
az aks nodepool delete-machines

Supprimez des machines spécifiques dans un pool d’agents pour un cluster managé.

Core GA
az aks nodepool delete-machines (aks-preview extension)

Supprimez des machines spécifiques dans un pool d’agents pour un cluster managé.

Extension GA
az aks nodepool get-upgrades

Obtenir les versions de mise à niveau disponibles pour un pool d’agents du cluster Kubernetes managé.

Core GA
az aks nodepool get-upgrades (aks-preview extension)

Obtenir les versions de mise à niveau disponibles pour un pool d’agents du cluster Kubernetes managé.

Extension GA
az aks nodepool list

Lister les pools de nœuds dans le cluster Kubernetes managé. Pour obtenir la liste des nœuds dans la commande d’exécution kubectl get nodes du cluster.

Core GA
az aks nodepool list (aks-preview extension)

Lister les pools de nœuds dans le cluster Kubernetes managé.

Extension GA
az aks nodepool manual-scale

Commandes pour gérer nodepool virtualMachineProfile.scale.manual.

Cœur et extension GA
az aks nodepool manual-scale add

Ajoutez un nouveau manuel à un pool d’agents VirtualMachines dans le cluster Kubernetes managé.

Core GA
az aks nodepool manual-scale add (aks-preview extension)

Ajoutez un nouveau manuel à un pool d’agents VirtualMachines dans le cluster Kubernetes managé.

Extension GA
az aks nodepool manual-scale delete

Supprimez un manuel existant pour un pool d’agents VirtualMachines dans le cluster Kubernetes managé.

Core GA
az aks nodepool manual-scale delete (aks-preview extension)

Supprimez un manuel existant pour un pool d’agents VirtualMachines dans le cluster Kubernetes managé.

Extension GA
az aks nodepool manual-scale update

Mettez à jour un manuel existant d’un pool d’agents VirtualMachines dans le cluster Kubernetes managé.

Core GA
az aks nodepool manual-scale update (aks-preview extension)

Mettez à jour un manuel existant d’un pool d’agents VirtualMachines dans le cluster Kubernetes managé.

Extension GA
az aks nodepool operation-abort

Abandonner la dernière opération en cours d’exécution sur le pool de nœuds.

Core GA
az aks nodepool operation-abort (aks-preview extension)

Abandonner la dernière opération en cours d’exécution sur le pool de nœuds.

Extension GA
az aks nodepool scale

Mettre à l’échelle le pool de nœuds dans un cluster Kubernetes managé.

Core GA
az aks nodepool scale (aks-preview extension)

Mettre à l’échelle le pool de nœuds dans un cluster Kubernetes managé.

Extension GA
az aks nodepool show

Montrer les détails pour un pool de nœuds dans le cluster Kubernetes managé.

Core GA
az aks nodepool show (aks-preview extension)

Montrer les détails pour un pool de nœuds dans le cluster Kubernetes managé.

Extension GA
az aks nodepool snapshot

Commandes pour gérer les instantanés de nodepool.

Cœur et extension GA
az aks nodepool snapshot create

Créez un instantané nodepool.

Core GA
az aks nodepool snapshot create (aks-preview extension)

Créez un instantané nodepool.

Extension GA
az aks nodepool snapshot delete

Supprimez un instantané nodepool.

Core GA
az aks nodepool snapshot delete (aks-preview extension)

Supprimez un instantané nodepool.

Extension GA
az aks nodepool snapshot list

Répertorier les instantanés de nodepool.

Core GA
az aks nodepool snapshot list (aks-preview extension)

Répertorier les instantanés de nodepool.

Extension GA
az aks nodepool snapshot show

Affichez les détails d’un instantané de pool de nœuds.

Core GA
az aks nodepool snapshot show (aks-preview extension)

Affichez les détails d’un instantané de pool de nœuds.

Extension GA
az aks nodepool snapshot update

Mettez à jour les balises sur un instantané d’un pool de nœuds.

Core GA
az aks nodepool snapshot update (aks-preview extension)

Mettez à jour les balises sur un instantané d’un pool de nœuds.

Extension GA
az aks nodepool snapshot wait

Attendez qu’un instantané nodepool atteigne un état souhaité.

Core GA
az aks nodepool start

Démarrez le pool d’agents arrêté dans le cluster Kubernetes managé.

Core GA
az aks nodepool start (aks-preview extension)

Démarrez le pool d’agents arrêté dans le cluster Kubernetes managé.

Extension GA
az aks nodepool stop

Arrêtez l’exécution du pool d’agents dans le cluster Kubernetes managé.

Core GA
az aks nodepool stop (aks-preview extension)

Arrêtez l’exécution du pool d’agents dans le cluster Kubernetes managé.

Extension GA
az aks nodepool update

Mettez à jour les propriétés d’un pool de nœuds.

Core GA
az aks nodepool update (aks-preview extension)

Mettez à jour les propriétés d’un pool de nœuds.

Extension GA
az aks nodepool upgrade

Mettre à niveau le pool de nœuds dans un cluster Kubernetes managé.

Core GA
az aks nodepool upgrade (aks-preview extension)

Mettre à niveau le pool de nœuds dans un cluster Kubernetes managé.

Extension GA
az aks nodepool wait

Attendez qu’un pool de nœuds atteigne un état souhaité.

Core GA

az aks nodepool add

Ajoutez un pool de nœuds au cluster Kubernetes managé.

az aks nodepool add --cluster-name
                    --name --nodepool-name
                    --resource-group
                    [--aks-custom-headers]
                    [--allowed-host-ports]
                    [--asg-ids]
                    [--crg-id]
                    [--disable-windows-outbound-nat]
                    [--drain-timeout]
                    [--enable-cluster-autoscaler]
                    [--enable-encryption-at-host]
                    [--enable-fips-image]
                    [--enable-node-public-ip]
                    [--enable-secure-boot]
                    [--enable-ultra-ssd]
                    [--enable-vtpm]
                    [--eviction-policy {Deallocate, Delete}]
                    [--gateway-prefix-size]
                    [--gpu-driver {Install, None}]
                    [--gpu-instance-profile {MIG1g, MIG2g, MIG3g, MIG4g, MIG7g}]
                    [--host-group-id]
                    [--if-match]
                    [--if-none-match]
                    [--kubelet-config]
                    [--kubernetes-version]
                    [--labels]
                    [--linux-os-config]
                    [--localdns-config]
                    [--max-count]
                    [--max-pods]
                    [--max-surge]
                    [--max-unavailable]
                    [--message-of-the-day]
                    [--min-count]
                    [--mode {Gateway, System, User}]
                    [--no-wait]
                    [--node-count]
                    [--node-osdisk-size]
                    [--node-osdisk-type {Ephemeral, Managed}]
                    [--node-public-ip-prefix-id]
                    [--node-public-ip-tags]
                    [--node-soak-duration]
                    [--node-taints]
                    [--node-vm-size]
                    [--os-sku {AzureLinux, AzureLinux3, CBLMariner, Mariner, Ubuntu, Ubuntu2204, Windows2019, Windows2022}]
                    [--os-type]
                    [--pod-ip-allocation-mode {DynamicIndividual, StaticBlock}]
                    [--pod-subnet-id]
                    [--ppg]
                    [--priority {Regular, Spot}]
                    [--scale-down-mode {Deallocate, Delete}]
                    [--snapshot-id]
                    [--spot-max-price]
                    [--tags]
                    [--undrainable-node-behavior]
                    [--vm-set-type]
                    [--vm-sizes]
                    [--vnet-subnet-id]
                    [--workload-runtime {KataVmIsolation}]
                    [--zones]

Exemples

Créez un pool de nœuds dans un cluster AKS existant avec le système d’exploitation éphémère activé.

az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster --node-osdisk-type Ephemeral --node-osdisk-size 48

Créez un pool de nœuds avec EncryptionAtHost activé.

az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster --enable-encryption-at-host

Créez un pool de nœuds avec UltraSSD activé.

az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster --enable-ultra-ssd

Créer un cluster nodepool avec une référence SKU de système d’exploitation spécifique

az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster --os-sku Ubuntu

Créer un pool de nœuds avec le système d’exploitation compatible FIPS

az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster --enable-fips-image

créez un cluster Kubernetes avec un ID d’instantané.

az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster --kubernetes-version 1.20.9 --snapshot-id "/subscriptions/00000/resourceGroups/AnotherResourceGroup/providers/Microsoft.ContainerService/snapshots/mysnapshot1"

créer un pool de nœuds dans un cluster AKS existant avec l’ID de groupe hôte

az aks nodepool add -g MyResourceGroup -n MyNodePool --cluster-name MyMC --host-group-id /subscriptions/00000/resourceGroups/AnotherResourceGroup/providers/Microsoft.ContainerService/hostGroups/myHostGroup --node-vm-size VMSize

créez un pool de nœuds avec un ID de groupe de réservations de capacité(CRG).

az aks nodepool add -g MyResourceGroup -n MyNodePool --cluster-name MyMC --node-vm-size VMSize --crg-id "/subscriptions/SubID/resourceGroups/ResourceGroupName/providers/Microsoft.ContainerService/CapacityReservationGroups/MyCRGID"

Créer un pool de nœuds avec le mode d’allocation ip défini sur « StaticBlock » et à l’aide d’un ID de sous-réseau de pod

az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster  --os-sku Ubuntu --pod-subnet-id /subscriptions/SubID/resourceGroups/AnotherResourceGroup/providers/Microsoft.Network/virtualNetworks/MyVnet/subnets/MySubnet --pod-ip-allocation-mode StaticBlock

créer un pool de nœuds de type VirtualMachines

az aks nodepool add -g MyResourceGroup -n MyNodePool --cluster-name MyMC --vm-set-type VirtualMachines --vm-sizes "VMSize1,VMSize2" --node-count 3

Créez un pool de nœuds avec KataVmIsolation activé.

az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster --os-sku AzureLinux --vm-size Standard_D4s_v3 --workload-runtime KataVmIsolation --node-count 1

Paramètres obligatoires

--cluster-name

Nom du cluster.

--name --nodepool-name -n

Nom du pool de nœuds.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--aks-custom-headers

Paires clé-valeur séparées par des virgules pour spécifier des en-têtes personnalisés.

--allowed-host-ports

Exposer les ports hôtes sur le pool de nœuds. Quand elle est spécifiée, le format doit être une liste séparée par un espace de plages avec protocole, par exemple. 80/TCP 443/TCP 4000-5000/TCP.

--asg-ids

ID des groupes de sécurité d’application auxquels l’interface réseau du pool de nœuds doit appartenir. Lorsqu’il est spécifié, le format doit être une liste séparée par des espaces d’ID.

--crg-id

ID crg utilisé pour associer le nouveau nodepool à la ressource de groupe de réservations de capacité existant.

--disable-windows-outbound-nat

Désactivez Windows OutboundNAT sur le pool de nœuds de l’agent Windows.

Propriété Valeur
Valeur par défaut: False
--drain-timeout

Lorsque les nœuds vident le nombre de minutes à attendre que tous les pods soient supprimés.

--enable-cluster-autoscaler -e

Activez la mise à l’échelle automatique du cluster.

Propriété Valeur
Valeur par défaut: False
--enable-encryption-at-host

Activez EncryptionAtHost, la valeur par défaut est false.

Propriété Valeur
Valeur par défaut: False
--enable-fips-image

Utilisez le système d’exploitation compatible FIPS sur les nœuds de l’agent.

Propriété Valeur
Valeur par défaut: False
--enable-node-public-ip

Activez l’adresse IP publique du nœud VMSS ou des machines virtuelles.

Propriété Valeur
Valeur par défaut: False
--enable-secure-boot

Activez le démarrage sécurisé sur le pool de nœuds de l’agent. Doit utiliser le type de pool d’agents vmSS ou machines virtuelles.

Propriété Valeur
Valeur par défaut: False
--enable-ultra-ssd

Activez UltraSSD, la valeur par défaut est false.

Propriété Valeur
Valeur par défaut: False
--enable-vtpm

Activez vTPM sur le pool de nœuds de l’agent. Doit utiliser le type de pool d’agents vmSS ou machines virtuelles.

Propriété Valeur
Valeur par défaut: False
--eviction-policy

Stratégie d’éviction du pool de nœuds Spot. Elle ne peut être définie que lorsque --priority est Spot.

Propriété Valeur
Valeur par défaut: Delete
Valeurs acceptées: Deallocate, Delete
--gateway-prefix-size

Taille d’IPPrefix publique attachée au pool de nœuds en mode passerelle. Le pool de nœuds doit être en mode passerelle.

--gpu-driver

Indique s’il faut installer le pilote pour le pool de nœuds GPU. Les valeurs possibles sont « Installer » ou « Aucun ». La valeur par défaut est « Installer ».

Propriété Valeur
Valeurs acceptées: Install, None
--gpu-instance-profile

Profil d’instance GPU pour partitionner des GPU Nvidia multi-gpu.

Propriété Valeur
Valeurs acceptées: MIG1g, MIG2g, MIG3g, MIG4g, MIG7g
--host-group-id

ID de groupe hôte dédié complet utilisé pour approvisionner le pool de nœuds de l’agent.

--if-match

La valeur fournie est comparée à l’ETag du pool d’agents, si elle correspond à l’opération se poursuit. S’il ne correspond pas, la demande est rejetée pour empêcher les remplacements accidentels. Cela ne doit pas être spécifié lors de la création d’un nouveau pool d’agents.

--if-none-match

Définissez sur « * » pour autoriser la création d’un nouveau pool d’agents, mais pour empêcher la mise à jour d’un pool d’agents existant. D’autres valeurs seront ignorées.

--kubelet-config

Chemin d’accès au fichier JSON contenant des configurations Kubelet pour les nœuds d’agent. https://aka.ms/aks/custom-node-config.

--kubernetes-version -k

Version de Kubernetes à utiliser pour créer le cluster, par exemple « 1.16.9 ».

Propriété Valeur
Valeur de: `az aks get-versions`
--labels

Étiquettes de nœud pour le pool de nœuds. Consultez https://aka.ms/node-labels la syntaxe des étiquettes.

--linux-os-config

Chemin d’accès au fichier JSON contenant des configurations de système d’exploitation pour les nœuds d’agent Linux. https://aka.ms/aks/custom-node-config.

--localdns-config

Définissez le profil localDNS pour un pool de nœuds avec un fichier de configuration JSON.

--max-count

Nombre maximal de nœuds utilisés pour la mise à l’échelle automatique, lorsque « --enable-cluster-autoscaler » spécifié. Spécifiez la valeur dans la plage de [0, 1000] pour le pool de nœuds utilisateur et [1 1000] pour le pool de nœuds système.

--max-pods -m

Nombre maximal de pods pouvant être déployés sur un nœud.

S’il n’est pas spécifié, les valeurs par défaut sont basées sur le plug-in réseau. 30 pour « azure », 110 pour « kubenet » ou 250 pour « none ».

--max-surge

Nœuds supplémentaires utilisés pour accélérer la mise à niveau. Quand elle est spécifiée, elle représente le nombre ou le pourcentage utilisé, par exemple. 5 ou 33 %.

--max-unavailable

Nombre maximal ou pourcentage de nœuds qui peuvent être simultanément indisponibles pendant la mise à niveau. Quand elle est spécifiée, elle représente le nombre ou le pourcentage utilisé, par exemple. 1 ou 5%.

--message-of-the-day

Chemin d’accès à un fichier contenant le message souhaité de la journée. Valide uniquement pour les nœuds Linux. Est écrit dans /etc/motd.

--min-count

Nombre minimal de nœuds utilisés pour la mise à l’échelle automatique, lorsque « --enable-cluster-autoscaler » spécifié. Spécifiez la valeur dans la plage de [0, 1000] pour le pool de nœuds utilisateur et [1 1000] pour le pool de nœuds système.

--mode

Mode d’un pool de nœuds qui définit la fonction principale d’un pool de nœuds. Si la valeur est « System », AKS préfère la planification des pods système aux pools de nœuds avec le mode System. En savoir plus sur https://aka.ms/aks/nodepool/mode.

Propriété Valeur
Valeur par défaut: User
Valeurs acceptées: Gateway, System, User
--no-wait

Ne pas attendre la fin de l’opération de longue durée.

Propriété Valeur
Valeur par défaut: False
--node-count -c

Nombre de nœuds dans le pool d’agents Kubernetes. Après avoir créé un cluster, vous pouvez modifier la taille de son pool de nœuds avec az aks scale.

Propriété Valeur
Valeur par défaut: 3
--node-osdisk-size

Taille en Gio du disque du système d’exploitation pour chaque nœud du pool d’agents. Minimum 30 Gio.

--node-osdisk-type

Type de disque de système d’exploitation à utiliser pour les machines d’un pool d’agents donné. La valeur par défaut est « éphémère » lorsque cela est possible conjointement avec la taille de machine virtuelle et la taille du disque du système d’exploitation. Peut ne pas être modifié pour ce pool après la création. ('Éphémère' ou 'Géré'').

Propriété Valeur
Valeurs acceptées: Ephemeral, Managed
--node-public-ip-prefix-id

ID de préfixe IP public utilisé pour affecter des adresses IP publiques aux nœuds VMSS ou machines virtuelles.

--node-public-ip-tags

IpTags des adresses IP publiques du nœud.

--node-soak-duration

Durée (en minutes) d’attente après le drainage d’un nœud et avant de la réimager et passer au nœud suivant.

--node-taints

Les aversions de nœud pour le pool de nœuds.

--node-vm-size -s

Taille de Machines Virtuelles à créer en tant que nœuds Kubernetes. Si l’utilisateur ne le spécifie pas, le serveur sélectionne une taille de machine virtuelle par défaut pour elle/lui.

--os-sku

Référence SKU du système d’exploitation du pool de nœuds de l’agent. Ubuntu, Ubuntu2204, AzureLinux ou AzureLinux3 pour Linux. Windows2019 ou Windows2022 pour Windows.

Propriété Valeur
Valeurs acceptées: AzureLinux, AzureLinux3, CBLMariner, Mariner, Ubuntu, Ubuntu2204, Windows2019, Windows2022
--os-type

Type de système d’exploitation. Linux ou Windows.

--pod-ip-allocation-mode

Définissez le mode d’allocation ip pour savoir comment les adresses IP de pod à partir du sous-réseau de pod Azure sont allouées aux nœuds du cluster AKS. Le choix est entre les lots dynamiques d’adresses IP individuelles ou l’allocation statique d’un ensemble de blocs CIDR. Les valeurs acceptées sont « DynamicIndividual » ou « StaticBlock ».

Utilisé avec le plug-in réseau « azure ». Nécessite --pod-subnet-id.

Propriété Valeur
Valeurs acceptées: DynamicIndividual, StaticBlock
--pod-subnet-id

ID de ressource d’un sous-réseau dans un réseau virtuel existant dans lequel attribuer des pods dans le cluster (nécessite un plug-in réseau Azure).

--ppg

ID d’un PPG.

--priority

Priorité du pool de nœuds.

Propriété Valeur
Valeur par défaut: Regular
Valeurs acceptées: Regular, Spot
--scale-down-mode

Décrivez comment les machines virtuelles sont ajoutées ou supprimées des pools de nœuds.

Propriété Valeur
Valeur par défaut: Delete
Valeurs acceptées: Deallocate, Delete
--snapshot-id

ID d’instantané source utilisé pour créer ce pool de nœuds.

--spot-max-price

Elle ne peut être définie que lorsque --priority est Spot. Spécifiez le prix maximal que vous êtes prêt à payer en dollars AMÉRICAINs. Les valeurs possibles sont toutes les valeurs décimales supérieures à zéro ou -1 qui indiquent le prix par défaut up-to à la demande. Il ne peut inclure que jusqu’à 5 décimales.

Propriété Valeur
Valeur par défaut: nan
--tags

Balises séparées par l’espace : key[=value] [key[=value] ...]. Utilisez « » pour effacer les balises existantes.

--undrainable-node-behavior

Définissez le comportement des nœuds indrainables pendant la mise à niveau. La valeur doit être « Cordon » ou « Schedule ». La valeur par défaut est « Schedule ».

Propriété Valeur
Valeur par défaut: Schedule
--vm-set-type

Type de jeu de machines virtuelles du pool d’agents. VirtualMachineScaleSets ou AvailabilitySet ou VirtualMachines. La valeur par défaut est « VirtualMachineScaleSets ».

--vm-sizes

Liste séparée par des virgules de tailles de machine virtuelle. Valide uniquement pour le pool de nœuds VirtualMachines. S’il --vm-sizes n’est pas spécifié mais --node-vm-size spécifié, la valeur de --node-vm-size sera utilisée. Si aucun d’entre eux n’a été spécifié, la valeur par défaut est Standard_DS2_v2 pour Linux ou Standard_D2s_v3 pour Windows.

--vnet-subnet-id

ID de ressource d’un sous-réseau dans un réseau virtuel existant dans lequel déployer le cluster.

--workload-runtime

Définissez le runtime de charge de travail.

Azure fournit un autre runtime de charge de travail pour activer les charges de travail prises en charge par Kata dans vos pools de nœuds. Les valeurs suivantes peuvent être spécifiées :

  • « KataVmIsolation » pour Kata.
Propriété Valeur
Valeurs acceptées: KataVmIsolation
--zones -z

Zones de disponibilité où les nœuds d’agent seront placés. En outre, pour installer des nœuds d’agent dans plusieurs zones, vous devez passer des numéros de zone séparés par des espaces. Par exemple : Pour avoir toutes les 3 zones, vous êtes censé entrer --zones 1 2 3.

Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az aks nodepool add (aks-preview extension)

Ajoutez un pool de nœuds au cluster Kubernetes managé.

az aks nodepool add --cluster-name
                    --name --nodepool-name
                    --resource-group
                    [--aks-custom-headers]
                    [--allowed-host-ports]
                    [--asg-ids]
                    [--batch-soak-duration]
                    [--crg-id]
                    [--disable-windows-outbound-nat]
                    [--drain-batch-size]
                    [--drain-timeout]
                    [--drain-timeout-bg]
                    [--driver-type {CUDA, GRID}]
                    [--enable-artifact-streaming]
                    [--enable-cluster-autoscaler]
                    [--enable-encryption-at-host]
                    [--enable-fips-image]
                    [--enable-node-public-ip]
                    [--enable-secure-boot]
                    [--enable-ultra-ssd]
                    [--enable-vtpm]
                    [--eviction-policy {Deallocate, Delete}]
                    [--final-soak-duration]
                    [--gateway-prefix-size]
                    [--gpu-driver {Install, None}]
                    [--gpu-instance-profile {MIG1g, MIG2g, MIG3g, MIG4g, MIG7g}]
                    [--host-group-id]
                    [--if-match]
                    [--if-none-match]
                    [--kubelet-config]
                    [--kubernetes-version]
                    [--labels]
                    [--linux-os-config]
                    [--localdns-config]
                    [--max-blocked-nodes]
                    [--max-count]
                    [--max-pods]
                    [--max-surge]
                    [--max-unavailable]
                    [--message-of-the-day]
                    [--min-count]
                    [--mode {Gateway, Machines, ManagedSystem, System, User}]
                    [--no-wait]
                    [--node-count]
                    [--node-osdisk-size]
                    [--node-osdisk-type {Ephemeral, Managed}]
                    [--node-public-ip-prefix-id]
                    [--node-public-ip-tags]
                    [--node-soak-duration]
                    [--node-taints]
                    [--node-vm-size]
                    [--os-sku {AzureLinux, AzureLinux3, AzureLinux3OSGuard, AzureLinuxOSGuard, CBLMariner, Flatcar, Mariner, Ubuntu, Ubuntu2204, Ubuntu2404, Windows2019, Windows2022, Windows2025, WindowsAnnual}]
                    [--os-type]
                    [--pod-ip-allocation-mode {DynamicIndividual, StaticBlock}]
                    [--pod-subnet-id]
                    [--ppg]
                    [--priority {Regular, Spot}]
                    [--scale-down-mode {Deallocate, Delete}]
                    [--snapshot-id]
                    [--spot-max-price]
                    [--ssh-access {disabled, entraid, localuser}]
                    [--tags]
                    [--undrainable-node-behavior]
                    [--upgrade-strategy {BlueGreen, Rolling}]
                    [--vm-set-type]
                    [--vm-sizes]
                    [--vnet-subnet-id]
                    [--workload-runtime {KataCcIsolation, KataMshvVmIsolation, KataVmIsolation, OCIContainer, WasmWasi}]
                    [--zones]

Exemples

Créez un pool de nœuds dans un cluster AKS existant avec le système d’exploitation éphémère activé.

az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster --node-osdisk-type Ephemeral --node-osdisk-size 48

Créez un pool de nœuds avec EncryptionAtHost activé.

az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster --enable-encryption-at-host

Créer un pool de nœuds avec une référence os-sku spécifique

az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster  --os-sku Ubuntu

Créez un pool de nœuds qui peut exécuter des charges de travail wasm.

az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster  --workload-runtime WasmWasi

créez un cluster Kubernetes avec un ID d’instantané.

az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster --kubernetes-version 1.20.9 --snapshot-id "/subscriptions/00000/resourceGroups/AnotherResourceGroup/providers/Microsoft.ContainerService/snapshots/mysnapshot1"

créez un pool de nœuds avec un ID de groupe de réservations de capacité(CRG).

az aks nodepool add -g MyResourceGroup -n MyNodePool --cluster-name MyMC --node-vm-size VMSize --crg-id "/subscriptions/SubID/resourceGroups/ResourceGroupName/providers/Microsoft.ContainerService/CapacityReservationGroups/MyCRGID"

créer un pool de nœuds dans un cluster AKS existant avec l’ID de groupe hôte

az aks nodepool add -g MyResourceGroup -n MyNodePool --cluster-name MyMC --host-group-id /subscriptions/00000/resourceGroups/AnotherResourceGroup/providers/Microsoft.ContainerService/hostGroups/myHostGroup --node-vm-size VMSize

Créer un pool de nœuds avec le mode d’allocation ip défini sur « StaticBlock » et à l’aide d’un ID de sous-réseau de pod

az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster  --os-sku Ubuntu --pod-subnet-id /subscriptions/00000/resourceGroups/AnotherResourceGroup/providers/Microsoft.Network/virtualNetworks/MyVnet/subnets/MySubnet --pod-ip-allocation-mode StaticBlock

Créer un pool de nœuds de type VirtualMachines

az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster --vm-set-type VirtualMachines --vm-sizes "Standard_D4s_v3,Standard_D8s_v3" --node-count 3

Créer un pool de nœuds avec le mode ManagedSystem

az aks nodepool add -g MyResourceGroup -n managedsystem1 --cluster-name MyManagedCluster --mode ManagedSystem

Créer un pool de nœuds avec une stratégie de mise à niveau bleue verte et des paramètres par défaut

az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster --upgrade-strategy BlueGreen

Paramètres obligatoires

--cluster-name

Nom du cluster.

--name --nodepool-name -n

Nom du pool de nœuds.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--aks-custom-headers

Envoyer des en-têtes personnalisés. Lorsqu’il est spécifié, le format doit être Key1=Value1,Key2=Value2.

--allowed-host-ports
Préversion

Exposer les ports hôtes sur le pool de nœuds. Quand elle est spécifiée, le format doit être une liste séparée par des virgules de plages avec protocole, par exemple. 80/TCP,443/TCP,4000-5000/TCP. Doit utiliser le type de pool d’agents VMSS.

--asg-ids
Préversion

ID des groupes de sécurité d’application auxquels l’interface réseau du pool de nœuds doit appartenir. Lorsqu’il est spécifié, le format doit être une liste séparée par des virgules d’ID. Doit utiliser le type de pool d’agents VMSS.

--batch-soak-duration

Temps d’attente (en minutes) après avoir vidé un lot de nœuds avant de passer au lot suivant. La valeur par défaut est de 15 minutes. Uniquement pour les mises à niveau bleu-vert.

--crg-id
Préversion

Crg-id utilisé pour associer le nouveau nodepool à la ressource de groupe de réservations de capacité existant. Doit utiliser le type de pool d’agents VMSS.

--disable-windows-outbound-nat

Désactivez Windows OutboundNAT sur le pool de nœuds de l’agent Windows. Doit utiliser le type de pool d’agents VMSS.

Propriété Valeur
Valeur par défaut: False
--drain-batch-size

Nombre ou pourcentage de nœuds à vider par lot pendant les mises à niveau bleu-vert. Accepte un entier (par exemple, « 5 ») ou un pourcentage (par exemple, « 50%»). La valeur par défaut est 10%.

Spécifie le nombre de nœuds à vider dans chaque lot pendant une mise à niveau bleu-vert. Doit être une valeur non nulle, soit sous la forme d’un entier (par exemple, « 5 ») soit d’un pourcentage (par exemple, « 50%») du nombre total de nœuds bleus au début de la mise à niveau. Les nœuds fractionnaires sont arrondis. Pour plus d’informations et meilleures pratiques, consultez https://learn.microsoft.com/en-us/azure/aks/upgrade-cluster.

--drain-timeout

Lorsque les nœuds vident le nombre de minutes à attendre que tous les pods soient supprimés.

--drain-timeout-bg

Délai d’expiration (en minutes) pour supprimer les pods et terminer correctement par nœud pendant les mises à niveau bleues vertes. La valeur par défaut est de 30 minutes.

Durée maximale (en minutes) d’attente de l’éviction du pod et de l’arrêt normal par nœud pendant les mises à niveau bleu-vert. Honore les budgets d’interruption des pods. Si elle est dépassée, la mise à niveau échoue. La valeur par défaut est de 30 minutes.

--driver-type
Préversion

Spécifiez le type de pilote GPU à installer lors de la création de pools d’agents Windows. Les valeurs valides sont « GRID » et « CUDA ». S’il n’est pas fourni, AKS sélectionne le pilote en fonction de la compatibilité du système. Cette option ne peut pas être modifiée une fois que AgentPool a été créé. La valeur par défaut est sélectionnée par le système.

Propriété Valeur
Valeurs acceptées: CUDA, GRID
--enable-artifact-streaming
Préversion

Activez le streaming d’artefacts pour VirtualMachineScaleSets géré par un pool de nœuds, afin d’accélérer le démarrage froid des conteneurs sur un nœud via le chargement d’images à la demande. Pour utiliser cette fonctionnalité, les images conteneur doivent également activer le streaming d’artefacts sur ACR. S’il n’est pas spécifié, la valeur par défaut est false.

Propriété Valeur
Valeur par défaut: False
--enable-cluster-autoscaler -e

Activez la mise à l’échelle automatique du cluster. Doit utiliser le type de pool d’agents VMSS.

Propriété Valeur
Valeur par défaut: False
--enable-encryption-at-host

Activez EncryptionAtHost sur le pool de nœuds de l’agent.

Propriété Valeur
Valeur par défaut: False
--enable-fips-image

Utilisez le système d’exploitation compatible FIPS sur les nœuds de l’agent.

Propriété Valeur
Valeur par défaut: False
--enable-node-public-ip

Activez l’adresse IP publique du nœud VMSS. Doit utiliser le type de pool d’agents VMSS.

Propriété Valeur
Valeur par défaut: False
--enable-secure-boot
Préversion

Activez le démarrage sécurisé sur le pool de nœuds de l’agent. Doit utiliser le type de pool d’agents VMSS.

Propriété Valeur
Valeur par défaut: False
--enable-ultra-ssd

Activez UltraSSD sur le pool de nœuds de l’agent. Doit utiliser le type de pool d’agents VMSS.

Propriété Valeur
Valeur par défaut: False
--enable-vtpm
Préversion

Activez vTPM sur le pool de nœuds de l’agent. Doit utiliser le type de pool d’agents VMSS.

Propriété Valeur
Valeur par défaut: False
--eviction-policy

Stratégie d’éviction du pool de nœuds Spot. Elle ne peut être définie que lorsque --priority est Spot.

Propriété Valeur
Valeur par défaut: Delete
Valeurs acceptées: Deallocate, Delete
--final-soak-duration

Temps d’attente (en minutes) après que tous les anciens nœuds sont vidés avant de les supprimer. La valeur par défaut est de 60 minutes. Uniquement pour les mises à niveau bleu-vert.

--gateway-prefix-size
Préversion

Taille d’IPPrefix publique attachée au pool de nœuds en mode passerelle. Le pool de nœuds doit être en mode passerelle.

--gpu-driver

Indique s’il faut installer le pilote pour le pool de nœuds GPU. Les valeurs possibles sont « Installer » ou « Aucun ». La valeur par défaut est « Installer ».

Propriété Valeur
Valeurs acceptées: Install, None
--gpu-instance-profile

Profil d’instance GPU pour partitionner des GPU Nvidia multi-gpu.

Propriété Valeur
Valeurs acceptées: MIG1g, MIG2g, MIG3g, MIG4g, MIG7g
--host-group-id

(PRÉVERSION) ID de groupe hôte dédié complet utilisé pour approvisionner le pool de nœuds de l’agent. Doit utiliser le type de pool d’agents VMSS.

--if-match

La valeur fournie est comparée à l’ETag du pool d’agents, si elle correspond à l’opération se poursuit. S’il ne correspond pas, la demande est rejetée pour empêcher les remplacements accidentels. Cela ne doit pas être spécifié lors de la création d’un nouveau pool d’agents.

--if-none-match

Définissez sur « * » pour autoriser la création d’un nouveau pool d’agents, mais pour empêcher la mise à jour d’un pool d’agents existant. D’autres valeurs seront ignorées.

--kubelet-config

Configurations Kubelet pour les nœuds d’agent.

--kubernetes-version -k

Version de Kubernetes à utiliser pour créer le cluster, par exemple « 1.7.12 » ou « 1.8.7 ».

Propriété Valeur
Valeur de: `az aks get-versions`
--labels

Étiquettes de nœud pour le pool de nœuds. Consultez https://aka.ms/node-labels la syntaxe des étiquettes.

--linux-os-config

Configurations du système d’exploitation pour les nœuds d’agent Linux.

--localdns-config

Définissez le profil localDNS pour un pool de nœuds avec un fichier de configuration JSON.

--max-blocked-nodes

Nombre maximal ou pourcentage de nœuds supplémentaires autorisés à être bloqués dans le pool d’agents lors d’une mise à niveau lorsque le comportement de nœud indrainable est Cordon. Quand elle est spécifiée, elle représente le nombre ou le pourcentage utilisé, par exemple. 1 ou 5%.

--max-count

Nombre maximal de nœuds utilisés pour la mise à l’échelle automatique, lorsque « --enable-cluster-autoscaler » spécifié. Spécifiez la valeur dans la plage de [0, 1000] pour le pool de nœuds utilisateur et [1 1000] pour le pool de nœuds système.

--max-pods -m

Nombre maximal de pods pouvant être déployés sur un nœud.

S’il n’est pas spécifié, les valeurs par défaut sont basées sur le plug-in réseau. 30 pour « azure », 110 pour « kubenet » ou 250 pour « none ».

Propriété Valeur
Valeur par défaut: 0
--max-surge

Nœuds supplémentaires utilisés pour accélérer la mise à niveau. Quand elle est spécifiée, elle représente le nombre ou le pourcentage utilisé, par exemple. 5 ou 33 %.

--max-unavailable

Nombre maximal ou pourcentage de nœuds qui peuvent être simultanément indisponibles pendant la mise à niveau. Quand elle est spécifiée, elle représente le nombre ou le pourcentage utilisé, par exemple. 1 ou 5%.

--message-of-the-day

Chemin d’accès à un fichier contenant le message souhaité de la journée. Valide uniquement pour les nœuds Linux. Est écrit dans /etc/motd.

--min-count

Nombre de nœuds de minimun utilisés pour la mise à l’échelle automatique, lorsque « --enable-cluster-autoscaler » spécifié. Spécifiez la valeur dans la plage de [0, 1000] pour le pool de nœuds utilisateur et [1 1000] pour le pool de nœuds système.

--mode

Mode d’un pool de nœuds qui définit la fonction principale d’un pool de nœuds. Si la valeur est « System », AKS préfère la planification des pods système aux pools de nœuds avec le mode System. Si elle est définie sur « ManagedSystem », toutes les autres propriétés, sauf le nom et le mode, sont réinitialisées et gérées par AKS. En savoir plus sur https://aka.ms/aks/nodepool/mode.

Propriété Valeur
Valeur par défaut: User
Valeurs acceptées: Gateway, Machines, ManagedSystem, System, User
--no-wait

Ne pas attendre la fin de l’opération de longue durée.

Propriété Valeur
Valeur par défaut: False
--node-count -c

Nombre de nœuds dans le pool d’agents Kubernetes. Après avoir créé un cluster, vous pouvez modifier la taille de son pool de nœuds avec az aks scale.

Propriété Valeur
Valeur par défaut: 3
--node-osdisk-size

Taille en Gio du disque du système d’exploitation pour chaque nœud du pool d’agents. Minimum 30 Gio.

Propriété Valeur
Valeur par défaut: 0
--node-osdisk-type

Type de disque de système d’exploitation à utiliser pour les machines d’un pool d’agents donné. La valeur par défaut est « éphémère » lorsque cela est possible conjointement avec la taille de machine virtuelle et la taille du disque du système d’exploitation. Peut ne pas être modifié pour ce pool après la création. ('Éphémère' ou 'Géré'').

Propriété Valeur
Valeurs acceptées: Ephemeral, Managed
--node-public-ip-prefix-id

ID de préfixe IP public utilisé pour affecter des adresses IP publiques aux nœuds VMSS. Doit utiliser le type de pool d’agents VMSS.

--node-public-ip-tags

IpTags des adresses IP publiques du nœud. Doit utiliser le type de pool d’agents VMSS.

--node-soak-duration

Durée (en minutes) d’attente après le drainage d’un nœud et avant de la réimager et passer au nœud suivant.

--node-taints

Les aversions de nœud pour le pool de nœuds.

--node-vm-size -s

Taille de Machines Virtuelles à créer en tant que nœuds Kubernetes. Si l’utilisateur ne le spécifie pas, le serveur sélectionne une taille de machine virtuelle par défaut pour elle/lui.

--os-sku

Référence os-sku du pool de nœuds de l’agent. Ubuntu, Ubuntu2204, Ubuntu2404, CBLMarinr, AzureLinux, AzureLinux3, AzureLinuxOSGuard, AzureLinux3OSGuard ou Flatcar lorsque le type de système d’exploitation est Linux, la valeur par défaut est Ubuntu si elle n’est pas définie ; Windows2019, Windows2022, Windows2025 ou WindowsAnnual lorsque le type de système d’exploitation est Windows, la valeur par défaut actuelle est Windows2022 si elle n’est pas définie.

Propriété Valeur
Valeurs acceptées: AzureLinux, AzureLinux3, AzureLinux3OSGuard, AzureLinuxOSGuard, CBLMariner, Flatcar, Mariner, Ubuntu, Ubuntu2204, Ubuntu2404, Windows2019, Windows2022, Windows2025, WindowsAnnual
--os-type

Type de système d’exploitation. Linux ou Windows. Windows n’est pas encore pris en charge pour le type de jeu de machines virtuelles « VirtualMachines ».

--pod-ip-allocation-mode

Définissez le mode d’allocation ip pour savoir comment les adresses IP de pod à partir du sous-réseau de pod Azure sont allouées aux nœuds du cluster AKS. Le choix est entre les lots dynamiques d’adresses IP individuelles ou l’allocation statique d’un ensemble de blocs CIDR. Les valeurs acceptées sont « DynamicIndividual » ou « StaticBlock ».

Utilisé avec le plug-in réseau « azure ». Nécessite --pod-subnet-id.

Propriété Valeur
Valeurs acceptées: DynamicIndividual, StaticBlock
--pod-subnet-id

ID d’un sous-réseau dans un réseau virtuel existant dans lequel attribuer des pods dans le cluster (nécessite un plug-in réseau Azure).

--ppg

ID d’un PPG. Doit utiliser le type de pool d’agents VMSS.

--priority

Priorité du pool de nœuds.

Propriété Valeur
Valeur par défaut: Regular
Valeurs acceptées: Regular, Spot
--scale-down-mode

Décrit comment les machines virtuelles sont ajoutées ou supprimées des pools de nœuds.

Propriété Valeur
Valeur par défaut: Delete
Valeurs acceptées: Deallocate, Delete
--snapshot-id

ID d’instantané source utilisé pour créer ce pool de nœuds. Doit utiliser le type de pool d’agents VMSS.

--spot-max-price

Elle ne peut être définie que lorsque --priority est Spot. Spécifiez le prix maximal que vous êtes prêt à payer en dollars AMÉRICAINs. Les valeurs possibles sont toutes les valeurs décimales supérieures à zéro ou -1 qui indiquent le prix par défaut up-to à la demande. Il ne peut inclure que jusqu’à 5 décimales.

Propriété Valeur
Valeur par défaut: nan
--ssh-access
Préversion

Configurez le paramètre SSH pour le pool de nœuds. Utilisez « désactivé » pour désactiver l’accès SSH, « localuser » pour activer l’accès SSH à l’aide de la clé privée.

Propriété Valeur
Valeur par défaut: localuser
Valeurs acceptées: disabled, entraid, localuser
--tags

Balises séparées par l’espace : key[=value] [key[=value] ...]. Utilisez « » pour effacer les balises existantes.

--undrainable-node-behavior

Définissez le comportement des nœuds indrainables pendant la mise à niveau. La valeur doit être « Cordon » ou « Schedule ». La valeur par défaut est « Schedule ».

--upgrade-strategy

Stratégie de mise à niveau pour le pool de nœuds. Les valeurs autorisées sont « Rolling » ou « BlueGreen ». La valeur par défaut est « Rolling ».

Propriété Valeur
Valeurs acceptées: BlueGreen, Rolling
--vm-set-type

Type de jeu de machines virtuelles du pool d’agents. VirtualMachineScaleSets, AvailabilitySet ou VirtualMachines(préversion).

--vm-sizes
Préversion

Liste de tailles séparées par des virgules. Doit utiliser le type de pool d’agents VirtualMachines.

--vnet-subnet-id

ID d’un sous-réseau d’un réseau virtuel existant dans lequel déployer le cluster.

--workload-runtime

Détermine le type de charge de travail qu’un nœud peut exécuter. Par défaut, OCIContainer.

Propriété Valeur
Valeur par défaut: OCIContainer
Valeurs acceptées: KataCcIsolation, KataMshvVmIsolation, KataVmIsolation, OCIContainer, WasmWasi
--zones -z

Liste séparée par l’espace des zones de disponibilité où les nœuds d’agent seront placés. Doit utiliser le type de pool d’agents VMSS.

Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az aks nodepool delete

Supprimez le pool d’agents dans le cluster Kubernetes managé.

az aks nodepool delete --cluster-name
                       --name --nodepool-name
                       --resource-group
                       [--if-match]
                       [--ignore-pdb]
                       [--no-wait]

Exemples

Supprimer un pool d’agents avec ignore-pdb

az aks nodepool delete --resource-group MyResourceGroup --cluster-name MyManagedCluster --name nodepool1 --if-match etag --ignore-pdb

Paramètres obligatoires

--cluster-name

Nom du cluster.

--name --nodepool-name -n

Nom du pool de nœuds.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--if-match

La valeur fournie est comparée à l’ETag du pool de nœuds, si elle correspond à l’opération se poursuit. S’il ne correspond pas, la demande est rejetée pour empêcher les remplacements accidentels. Cela ne doit pas être spécifié lors de la création d’un nouveau pool d’agents.

--ignore-pdb -i

Supprimez un pool de nœuds existant sans tenir compte du budget d’interruption de pod.

--no-wait

Ne pas attendre la fin de l’opération de longue durée.

Propriété Valeur
Valeur par défaut: False
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az aks nodepool delete (aks-preview extension)

Supprimez le pool d’agents dans le cluster Kubernetes managé.

az aks nodepool delete --cluster-name
                       --name --nodepool-name
                       --resource-group
                       [--if-match]
                       [--ignore-pod-disruption-budget]
                       [--no-wait]

Exemples

Supprimer un pool d’agents avec ignore-pod-disruption-budget

az aks nodepool delete --resource-group MyResourceGroup --cluster-name MyManagedCluster --name nodepool1 --ignore-pod-disruption-budget=true

Paramètres obligatoires

--cluster-name

Nom du cluster.

--name --nodepool-name -n

Nom du pool de nœuds.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--if-match

La valeur fournie est comparée à l’ETag du pool de nœuds, si elle correspond à l’opération se poursuit. S’il ne correspond pas, la demande est rejetée pour empêcher les remplacements accidentels. Cela ne doit pas être spécifié lors de la création d’un nouveau pool d’agents.

--ignore-pod-disruption-budget -i
Préversion

(PRÉVERSION) ignore-pod-disruption-budget supprime un pool de nœuds existant sans tenir compte du budget d’interruption de pod.

--no-wait

Ne pas attendre la fin de l’opération de longue durée.

Propriété Valeur
Valeur par défaut: False
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az aks nodepool delete-machines

Supprimez des machines spécifiques dans un pool d’agents pour un cluster managé.

az aks nodepool delete-machines --cluster-name
                                --machine-names
                                --name --nodepool-name
                                --resource-group
                                [--no-wait]

Exemples

Supprimer des machines spécifiques dans un pool d’agents

az aks nodepool delete-machines -g myResourceGroup --nodepool-name nodepool1 --cluster-name myAKSCluster --machine-names machine1

Paramètres obligatoires

--cluster-name

Nom du cluster.

--machine-names

Liste séparée par l’espace des noms d’ordinateurs du pool d’agents à supprimer.

--name --nodepool-name -n

Nom du pool de nœuds.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--no-wait

Ne pas attendre la fin de l’opération de longue durée.

Propriété Valeur
Valeur par défaut: False
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az aks nodepool delete-machines (aks-preview extension)

Supprimez des machines spécifiques dans un pool d’agents pour un cluster managé.

az aks nodepool delete-machines --cluster-name
                                --machine-names
                                --name --nodepool-name
                                --resource-group
                                [--no-wait]

Exemples

Supprimer des machines spécifiques dans un pool d’agents

az aks nodepool delete-machines -g myResourceGroup --nodepool-name nodepool1 --cluster-name myAKSCluster --machine-names machine1

Paramètres obligatoires

--cluster-name

Nom du cluster.

--machine-names

Liste séparée par l’espace des noms d’ordinateurs du pool d’agents à supprimer.

--name --nodepool-name -n

Nom du pool de nœuds.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--no-wait

Ne pas attendre la fin de l’opération de longue durée.

Propriété Valeur
Valeur par défaut: False
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az aks nodepool get-upgrades

Obtenir les versions de mise à niveau disponibles pour un pool d’agents du cluster Kubernetes managé.

az aks nodepool get-upgrades --cluster-name
                             --name --nodepool-name
                             --resource-group

Exemples

Obtenir les versions de mise à niveau disponibles pour un pool d’agents du cluster Kubernetes managé.

az aks nodepool get-upgrades --resource-group MyResourceGroup --cluster-name MyManagedCluster --nodepool-name MyNodePool

Paramètres obligatoires

--cluster-name

Nom du cluster.

--name --nodepool-name -n

Nom du pool de nœuds.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az aks nodepool get-upgrades (aks-preview extension)

Obtenir les versions de mise à niveau disponibles pour un pool d’agents du cluster Kubernetes managé.

az aks nodepool get-upgrades --cluster-name
                             --name --nodepool-name
                             --resource-group

Exemples

Obtenir les versions de mise à niveau disponibles pour un pool d’agents du cluster Kubernetes managé.

az aks nodepool get-upgrades --resource-group MyResourceGroup --cluster-name MyManagedCluster --nodepool-name MyNodePool

Paramètres obligatoires

--cluster-name

Nom du cluster.

--name --nodepool-name -n

Nom du pool de nœuds.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az aks nodepool list

Lister les pools de nœuds dans le cluster Kubernetes managé. Pour obtenir la liste des nœuds dans la commande d’exécution kubectl get nodes du cluster.

az aks nodepool list --cluster-name
                     --resource-group

Paramètres obligatoires

--cluster-name

Nom du cluster.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az aks nodepool list (aks-preview extension)

Lister les pools de nœuds dans le cluster Kubernetes managé.

az aks nodepool list --cluster-name
                     --resource-group

Paramètres obligatoires

--cluster-name

Nom du cluster.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az aks nodepool operation-abort

Abandonner la dernière opération en cours d’exécution sur le pool de nœuds.

az aks nodepool operation-abort --cluster-name
                                --name --nodepool-name
                                --resource-group
                                [--no-wait]

Exemples

Abandon de l’opération sur le pool d’agents

az aks nodepool operation-abort -g myResourceGroup --nodepool-name nodepool1 --cluster-name myAKSCluster

Paramètres obligatoires

--cluster-name

Nom du cluster.

--name --nodepool-name -n

Nom du pool de nœuds.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--no-wait

Ne pas attendre la fin de l’opération de longue durée.

Propriété Valeur
Valeur par défaut: False
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az aks nodepool operation-abort (aks-preview extension)

Abandonner la dernière opération en cours d’exécution sur le pool de nœuds.

az aks nodepool operation-abort --cluster-name
                                --name --nodepool-name
                                --resource-group
                                [--aks-custom-headers]
                                [--no-wait]

Exemples

Abandon de l’opération sur le pool d’agents

az aks nodepool operation-abort -g myResourceGroup --nodepool-name nodepool1 --cluster-name myAKSCluster

Paramètres obligatoires

--cluster-name

Nom du cluster.

--name --nodepool-name -n

Nom du pool de nœuds.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--aks-custom-headers

Envoyer des en-têtes personnalisés. Lorsqu’il est spécifié, le format doit être Key1=Value1,Key2=Value2.

--no-wait

Ne pas attendre la fin de l’opération de longue durée.

Propriété Valeur
Valeur par défaut: False
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az aks nodepool scale

Mettre à l’échelle le pool de nœuds dans un cluster Kubernetes managé.

az aks nodepool scale --cluster-name
                      --name --nodepool-name
                      --resource-group
                      [--no-wait]
                      [--node-count]

Paramètres obligatoires

--cluster-name

Nom du cluster.

--name --nodepool-name -n

Nom du pool de nœuds.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--no-wait

Ne pas attendre la fin de l’opération de longue durée.

Propriété Valeur
Valeur par défaut: False
--node-count -c

Nombre de nœuds dans le pool de nœuds Kubernetes.

Propriété Valeur
Valeur par défaut: 3
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az aks nodepool scale (aks-preview extension)

Mettre à l’échelle le pool de nœuds dans un cluster Kubernetes managé.

az aks nodepool scale --cluster-name
                      --name --nodepool-name
                      --resource-group
                      [--aks-custom-headers]
                      [--no-wait]
                      [--node-count]

Paramètres obligatoires

--cluster-name

Nom du cluster.

--name --nodepool-name -n

Nom du pool de nœuds.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--aks-custom-headers

Envoyer des en-têtes personnalisés. Lorsqu’il est spécifié, le format doit être Key1=Value1,Key2=Value2.

--no-wait

Ne pas attendre la fin de l’opération de longue durée.

Propriété Valeur
Valeur par défaut: False
--node-count -c

Nombre de nœuds dans le pool de nœuds Kubernetes.

Propriété Valeur
Valeur par défaut: 3
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az aks nodepool show

Montrer les détails pour un pool de nœuds dans le cluster Kubernetes managé.

az aks nodepool show --cluster-name
                     --name --nodepool-name
                     --resource-group

Paramètres obligatoires

--cluster-name

Nom du cluster.

--name --nodepool-name -n

Nom du pool de nœuds.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az aks nodepool show (aks-preview extension)

Montrer les détails pour un pool de nœuds dans le cluster Kubernetes managé.

az aks nodepool show --cluster-name
                     --name --nodepool-name
                     --resource-group

Paramètres obligatoires

--cluster-name

Nom du cluster.

--name --nodepool-name -n

Nom du pool de nœuds.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az aks nodepool start

Démarrez le pool d’agents arrêté dans le cluster Kubernetes managé.

az aks nodepool start --cluster-name
                      --name --nodepool-name
                      --resource-group
                      [--aks-custom-headers]
                      [--no-wait]

Exemples

Démarrer le pool d’agents dans le cluster managé

az aks nodepool start --nodepool-name nodepool1 -g MyResourceGroup --cluster-name MyManagedCluster

Paramètres obligatoires

--cluster-name

Nom du cluster.

--name --nodepool-name -n

Nom du pool de nœuds.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--aks-custom-headers

Envoyer des en-têtes personnalisés. Lorsqu’il est spécifié, le format doit être Key1=Value1,Key2=Value2.

--no-wait

Ne pas attendre la fin de l’opération de longue durée.

Propriété Valeur
Valeur par défaut: False
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az aks nodepool start (aks-preview extension)

Démarrez le pool d’agents arrêté dans le cluster Kubernetes managé.

az aks nodepool start --cluster-name
                      --name --nodepool-name
                      --resource-group
                      [--aks-custom-headers]
                      [--no-wait]

Exemples

Démarrer le pool d’agents dans le cluster managé

az aks nodepool start --nodepool-name nodepool1 -g MyResourceGroup --cluster-name MyManagedCluster

Paramètres obligatoires

--cluster-name

Nom du cluster.

--name --nodepool-name -n

Nom du pool de nœuds.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--aks-custom-headers

Envoyer des en-têtes personnalisés. Lorsqu’il est spécifié, le format doit être Key1=Value1,Key2=Value2.

--no-wait

Ne pas attendre la fin de l’opération de longue durée.

Propriété Valeur
Valeur par défaut: False
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az aks nodepool stop

Arrêtez l’exécution du pool d’agents dans le cluster Kubernetes managé.

az aks nodepool stop --cluster-name
                     --name --nodepool-name
                     --resource-group
                     [--aks-custom-headers]
                     [--no-wait]

Exemples

Arrêter le pool d’agents dans le cluster managé

az aks nodepool stop --nodepool-name nodepool1 -g MyResourceGroup --cluster-name MyManagedCluster

Paramètres obligatoires

--cluster-name

Nom du cluster.

--name --nodepool-name -n

Nom du pool de nœuds.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--aks-custom-headers

Envoyer des en-têtes personnalisés. Lorsqu’il est spécifié, le format doit être Key1=Value1,Key2=Value2.

--no-wait

Ne pas attendre la fin de l’opération de longue durée.

Propriété Valeur
Valeur par défaut: False
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az aks nodepool stop (aks-preview extension)

Arrêtez l’exécution du pool d’agents dans le cluster Kubernetes managé.

az aks nodepool stop --cluster-name
                     --name --nodepool-name
                     --resource-group
                     [--aks-custom-headers]
                     [--no-wait]

Exemples

Arrêter le pool d’agents dans le cluster managé

az aks nodepool stop --nodepool-name nodepool1 -g MyResourceGroup --cluster-name MyManagedCluster

Paramètres obligatoires

--cluster-name

Nom du cluster.

--name --nodepool-name -n

Nom du pool de nœuds.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--aks-custom-headers

Envoyer des en-têtes personnalisés. Lorsqu’il est spécifié, le format doit être Key1=Value1,Key2=Value2.

--no-wait

Ne pas attendre la fin de l’opération de longue durée.

Propriété Valeur
Valeur par défaut: False
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az aks nodepool update

Mettez à jour les propriétés d’un pool de nœuds.

Mettez à jour un pool de nœuds pour activer/désactiver le cluster-autoscaler ou modifier min-count ou max-count. Lorsqu’elle est appelée sans argument facultatif, cela tente de déplacer le pool de nœuds vers son état d’objectif sans modifier la configuration actuelle du pool de nœuds. Cela peut être utilisé pour sortir d’un état non réussi.

az aks nodepool update --cluster-name
                       --name --nodepool-name
                       --resource-group
                       [--aks-custom-headers]
                       [--allowed-host-ports]
                       [--asg-ids]
                       [--disable-cluster-autoscaler]
                       [--disable-fips-image]
                       [--disable-secure-boot]
                       [--disable-vtpm]
                       [--drain-timeout]
                       [--enable-cluster-autoscaler]
                       [--enable-fips-image]
                       [--enable-secure-boot]
                       [--enable-vtpm]
                       [--if-match]
                       [--if-none-match]
                       [--labels]
                       [--localdns-config]
                       [--max-count]
                       [--max-surge]
                       [--max-unavailable]
                       [--min-count]
                       [--mode {Gateway, System, User}]
                       [--no-wait]
                       [--node-soak-duration]
                       [--node-taints]
                       [--os-sku {AzureLinux, AzureLinux3, Ubuntu, Ubuntu2204}]
                       [--scale-down-mode {Deallocate, Delete}]
                       [--tags]
                       [--undrainable-node-behavior]
                       [--update-cluster-autoscaler]

Exemples

Rapprochez le pool de nœuds à son état actuel.

az aks nodepool update -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster

Activer la mise à l’échelle automatique du cluster dans la plage de nombre de nœuds [1,5]

az aks nodepool update --enable-cluster-autoscaler --min-count 1 --max-count 5 -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster

Désactiver la mise à l’échelle automatique du cluster pour un cluster existant

az aks nodepool update --disable-cluster-autoscaler -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster

Mettez à jour le nombre minimal ou le nombre maximal pour la mise à l’échelle automatique du cluster.

az aks nodepool update --update-cluster-autoscaler --min-count 1 --max-count 10 -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster

Paramètres obligatoires

--cluster-name

Nom du cluster.

--name --nodepool-name -n

Nom du pool de nœuds.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--aks-custom-headers

Paires clé-valeur séparées par des virgules pour spécifier des en-têtes personnalisés.

--allowed-host-ports

Exposer les ports hôtes sur le pool de nœuds. Quand elle est spécifiée, le format doit être une liste séparée par un espace de plages avec protocole, par exemple. 80/TCP 443/TCP 4000-5000/TCP.

--asg-ids

ID des groupes de sécurité d’application auxquels l’interface réseau du pool de nœuds doit appartenir. Lorsqu’il est spécifié, le format doit être une liste séparée par des espaces d’ID.

--disable-cluster-autoscaler -d

Désactivez la mise à l’échelle automatique du cluster.

Propriété Valeur
Valeur par défaut: False
--disable-fips-image

Basculez pour utiliser le système d’exploitation non compatible FIPS sur les nœuds de l’agent.

Propriété Valeur
Valeur par défaut: False
--disable-secure-boot

Désactivez le démarrage sécurisé sur un pool de nœuds d’agent activé pour le lancement approuvé existant.

Propriété Valeur
Valeur par défaut: False
--disable-vtpm

Désactivez vTPM sur un pool de nœuds d’agent activé pour le lancement approuvé existant.

Propriété Valeur
Valeur par défaut: False
--drain-timeout

Lorsque les nœuds vident le nombre de minutes à attendre que tous les pods soient supprimés.

--enable-cluster-autoscaler -e

Activez la mise à l’échelle automatique du cluster.

Propriété Valeur
Valeur par défaut: False
--enable-fips-image

Basculez pour utiliser le système d’exploitation compatible FIPS sur les nœuds de l’agent.

Propriété Valeur
Valeur par défaut: False
--enable-secure-boot

Activez le démarrage sécurisé sur un pool de nœuds d’agent activé pour le lancement approuvé existant. Doit utiliser le type de pool d’agents vmSS ou machines virtuelles.

Propriété Valeur
Valeur par défaut: False
--enable-vtpm

Activez vTPM sur un pool de nœuds d’agent activé pour le lancement approuvé existant. Doit utiliser le type de pool d’agents vmSS ou machines virtuelles.

Propriété Valeur
Valeur par défaut: False
--if-match

La valeur fournie est comparée à l’ETag du pool de nœuds, si elle correspond à l’opération se poursuit. S’il ne correspond pas, la demande est rejetée pour empêcher les remplacements accidentels. Cela ne doit pas être spécifié lors de la création d’un nouveau pool d’agents.

--if-none-match

Définissez sur « * » pour autoriser la création d’un nouveau pool de nœuds, mais pour empêcher la mise à jour d’un pool de nœuds existant. D’autres valeurs seront ignorées.

--labels

Étiquettes de nœud pour le pool de nœuds. Consultez https://aka.ms/node-labels la syntaxe des étiquettes.

--localdns-config

Définissez le profil localDNS pour un pool de nœuds avec un fichier de configuration JSON.

--max-count

Nombre maximal de nœuds utilisés pour la mise à l’échelle automatique, lorsque « --enable-cluster-autoscaler » spécifié. Spécifiez la valeur dans la plage de [0, 1000] pour le pool de nœuds utilisateur et [1 1000] pour le pool de nœuds système.

--max-surge

Nœuds supplémentaires utilisés pour accélérer la mise à niveau. Quand elle est spécifiée, elle représente le nombre ou le pourcentage utilisé, par exemple. 5 ou 33 %.

--max-unavailable

Nombre maximal ou pourcentage de nœuds qui peuvent être simultanément indisponibles pendant la mise à niveau. Quand elle est spécifiée, elle représente le nombre ou le pourcentage utilisé, par exemple. 1 ou 5%.

--min-count

Nombre minimal de nœuds utilisés pour la mise à l’échelle automatique, lorsque « --enable-cluster-autoscaler » spécifié. Spécifiez la valeur dans la plage de [0, 1000] pour le pool de nœuds utilisateur et [1 1000] pour le pool de nœuds système.

--mode

Mode d’un pool de nœuds qui définit la fonction principale d’un pool de nœuds. Si la valeur est « System », AKS préfère la planification des pods système aux pools de nœuds avec le mode System. En savoir plus sur https://aka.ms/aks/nodepool/mode.

Propriété Valeur
Valeurs acceptées: Gateway, System, User
--no-wait

Ne pas attendre la fin de l’opération de longue durée.

Propriété Valeur
Valeur par défaut: False
--node-soak-duration

Durée (en minutes) d’attente après le drainage d’un nœud et avant de la réimager et passer au nœud suivant.

--node-taints

Les aversions de nœud pour le pool de nœuds. Vous pouvez mettre à jour la teinte de nœud existante d’un pool de nœuds ou créer une teinte de nœud pour un pool de nœuds. Passez la chaîne "" vide pour supprimer toutes les teintes.

--os-sku

Référence os-sku du pool de nœuds de l’agent.

Propriété Valeur
Valeurs acceptées: AzureLinux, AzureLinux3, Ubuntu, Ubuntu2204
--scale-down-mode

Décrivez comment les machines virtuelles sont ajoutées ou supprimées des pools de nœuds.

Propriété Valeur
Valeurs acceptées: Deallocate, Delete
--tags

Balises séparées par l’espace : key[=value] [key[=value] ...]. Utilisez « » pour effacer les balises existantes.

--undrainable-node-behavior

Définissez le comportement des nœuds indrainables pendant la mise à niveau. La valeur doit être « Cordon » ou « Schedule ». La valeur par défaut est « Schedule ».

--update-cluster-autoscaler -u

Mettez à jour le nombre minimal ou le nombre maximal pour la mise à l’échelle automatique du cluster.

Propriété Valeur
Valeur par défaut: False
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az aks nodepool update (aks-preview extension)

Mettez à jour les propriétés d’un pool de nœuds.

Mettez à jour un pool de nœuds pour activer/désactiver le cluster-autoscaler ou modifier min-count ou max-count. Lorsqu’elle est appelée sans argument facultatif, cela tente de déplacer le pool de nœuds vers son état d’objectif sans modifier la configuration actuelle du pool de nœuds. Cela peut être utilisé pour sortir d’un état non réussi.

az aks nodepool update --cluster-name
                       --name --nodepool-name
                       --resource-group
                       [--aks-custom-headers]
                       [--allowed-host-ports]
                       [--asg-ids]
                       [--batch-soak-duration]
                       [--disable-cluster-autoscaler]
                       [--disable-fips-image]
                       [--disable-secure-boot]
                       [--disable-vtpm]
                       [--drain-batch-size]
                       [--drain-timeout]
                       [--drain-timeout-bg]
                       [--enable-artifact-streaming]
                       [--enable-cluster-autoscaler]
                       [--enable-fips-image]
                       [--enable-secure-boot]
                       [--enable-vtpm]
                       [--final-soak-duration]
                       [--gpu-driver {Install, None}]
                       [--if-match]
                       [--if-none-match]
                       [--labels]
                       [--localdns-config]
                       [--max-blocked-nodes]
                       [--max-count]
                       [--max-surge]
                       [--max-unavailable]
                       [--min-count]
                       [--mode {Gateway, Machines, ManagedSystem, System, User}]
                       [--no-wait]
                       [--node-soak-duration]
                       [--node-taints]
                       [--node-vm-size]
                       [--os-sku {AzureLinux, AzureLinux3, AzureLinux3OSGuard, AzureLinuxOSGuard, Flatcar, Ubuntu, Ubuntu2204, Ubuntu2404}]
                       [--scale-down-mode {Deallocate, Delete}]
                       [--ssh-access {disabled, entraid, localuser}]
                       [--tags]
                       [--undrainable-node-behavior]
                       [--update-cluster-autoscaler]
                       [--upgrade-strategy {BlueGreen, Rolling}]
                       [--yes]

Exemples

Rapprochez le pool de nœuds à son état actuel.

az aks nodepool update -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster

Activer la mise à l’échelle automatique du cluster dans la plage de nombre de nœuds [1,5]

az aks nodepool update --enable-cluster-autoscaler --min-count 1 --max-count 5 -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster

Désactiver la mise à l’échelle automatique du cluster pour un cluster existant

az aks nodepool update --disable-cluster-autoscaler -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster

Mettez à jour le nombre minimal ou le nombre maximal pour la mise à l’échelle automatique du cluster.

az aks nodepool update --update-cluster-autoscaler --min-count 1 --max-count 10 -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster

Modifier un pool de nœuds en mode système

az aks nodepool update --mode System -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster

Mettre à jour la taille de machine virtuelle de mise à l’échelle automatique du cluster, le nombre minimal et le nombre maximal pour le pool de nœuds de machines virtuelles

az aks nodepool update -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster --update-cluster-autoscaler --node-vm-size "Standard_D2s_v3" --min-count 2 --max-count 4

Mettre à jour un pool de nœuds avec des paramètres de mise à niveau bleu-vert

az aks nodepool update -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster --drain-batch-size 50% --drain-timeout-bg 5 --batch-soak-duration 10 --final-soak-duration 10

Paramètres obligatoires

--cluster-name

Nom du cluster.

--name --nodepool-name -n

Nom du pool de nœuds.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--aks-custom-headers

Envoyer des en-têtes personnalisés. Lorsqu’il est spécifié, le format doit être Key1=Value1,Key2=Value2.

--allowed-host-ports
Préversion

Exposer les ports hôtes sur le pool de nœuds. Quand elle est spécifiée, le format doit être une liste séparée par des virgules de plages avec protocole, par exemple. 80/TCP,443/TCP,4000-5000/TCP. Doit utiliser le type de pool d’agents VMSS.

--asg-ids
Préversion

ID des groupes de sécurité d’application auxquels l’interface réseau du pool de nœuds doit appartenir. Lorsqu’il est spécifié, le format doit être une liste séparée par des virgules d’ID. Doit utiliser le type de pool d’agents VMSS.

--batch-soak-duration

Temps d’attente (en minutes) après avoir vidé un lot de nœuds avant de passer au lot suivant. La valeur par défaut est de 15 minutes. Uniquement pour les mises à niveau bleu-vert.

--disable-cluster-autoscaler -d

Désactivez la mise à l’échelle automatique du cluster.

Propriété Valeur
Valeur par défaut: False
--disable-fips-image

Basculez pour utiliser le système d’exploitation non compatible FIPS sur les nœuds de l’agent.

Propriété Valeur
Valeur par défaut: False
--disable-secure-boot
Préversion

Désactivez le démarrage sécurisé sur un pool de nœuds d’agent activé pour le lancement approuvé existant.

Propriété Valeur
Valeur par défaut: False
--disable-vtpm
Préversion

Désactivez vTPM sur un pool de nœuds d’agent activé pour le lancement approuvé existant.

Propriété Valeur
Valeur par défaut: False
--drain-batch-size

Nombre ou pourcentage de nœuds à vider par lot pendant les mises à niveau bleu-vert. Accepte un entier (par exemple, « 5 ») ou un pourcentage (par exemple, « 50%»). La valeur par défaut est 10%.

Spécifie le nombre de nœuds à vider dans chaque lot pendant une mise à niveau bleu-vert. Doit être une valeur non nulle, soit sous la forme d’un entier (par exemple, « 5 ») soit d’un pourcentage (par exemple, « 50%») du nombre total de nœuds bleus au début de la mise à niveau. Les nœuds fractionnaires sont arrondis. Pour plus d’informations et des bonnes pratiques, consultez : https://learn.microsoft.com/en-us/azure/aks/upgrade-cluster.

--drain-timeout

Lorsque les nœuds vident le nombre de minutes à attendre que tous les pods soient supprimés.

--drain-timeout-bg

Délai d’expiration (en minutes) pour supprimer les pods et terminer correctement par nœud pendant les mises à niveau bleues vertes. La valeur par défaut est de 30 minutes.

Durée maximale (en minutes) d’attente de l’éviction du pod et de l’arrêt normal par nœud pendant les mises à niveau bleu-vert. Honore les budgets d’interruption des pods. Si elle est dépassée, la mise à niveau échoue. La valeur par défaut est de 30 minutes.

--enable-artifact-streaming
Préversion

Activez le streaming d’artefacts pour VirtualMachineScaleSets géré par un pool de nœuds, afin d’accélérer le démarrage froid des conteneurs sur un nœud via le chargement d’images à la demande. Pour utiliser cette fonctionnalité, les images conteneur doivent également activer le streaming d’artefacts sur ACR. S’il n’est pas spécifié, la valeur par défaut est false.

Propriété Valeur
Valeur par défaut: False
--enable-cluster-autoscaler -e

Activez la mise à l’échelle automatique du cluster. Doit utiliser le type de pool d’agents VMSS.

Propriété Valeur
Valeur par défaut: False
--enable-fips-image

Basculez pour utiliser le système d’exploitation compatible FIPS sur les nœuds de l’agent.

Propriété Valeur
Valeur par défaut: False
--enable-secure-boot
Préversion

Activez le démarrage sécurisé sur un pool de nœuds d’agent activé pour le lancement approuvé existant. Doit utiliser le type de pool d’agents VMSS.

Propriété Valeur
Valeur par défaut: False
--enable-vtpm
Préversion

Activez vTPM sur un pool de nœuds d’agent activé pour le lancement approuvé existant. Doit utiliser le type de pool d’agents VMSS.

Propriété Valeur
Valeur par défaut: False
--final-soak-duration

Temps d’attente (en minutes) après que tous les anciens nœuds sont vidés avant de les supprimer. La valeur par défaut est de 60 minutes. Uniquement pour les mises à niveau bleu-vert.

--gpu-driver

Indique s’il faut installer le pilote pour le pool de nœuds GPU. Les valeurs possibles sont « Installer » ou « Aucun ».

Propriété Valeur
Valeurs acceptées: Install, None
--if-match

La valeur fournie est comparée à l’ETag du pool de nœuds, si elle correspond à l’opération se poursuit. S’il ne correspond pas, la demande est rejetée pour empêcher les remplacements accidentels. Cela ne doit pas être spécifié lors de la création d’un nouveau pool d’agents.

--if-none-match

Définissez sur « * » pour autoriser la création d’un nouveau pool de nœuds, mais pour empêcher la mise à jour d’un pool de nœuds existant. D’autres valeurs seront ignorées.

--labels

Étiquettes de nœud pour le pool de nœuds. Consultez https://aka.ms/node-labels la syntaxe des étiquettes.

--localdns-config

Définissez le profil localDNS pour un pool de nœuds avec un fichier de configuration JSON.

--max-blocked-nodes

Nombre maximal ou pourcentage de nœuds supplémentaires autorisés à être bloqués dans le pool d’agents lors d’une mise à niveau lorsque le comportement de nœud indrainable est Cordon. Quand elle est spécifiée, elle représente le nombre ou le pourcentage utilisé, par exemple. 1 ou 5%.

--max-count

Nombre maximal de nœuds utilisés pour la mise à l’échelle automatique, lorsque « --enable-cluster-autoscaler » spécifié. Spécifiez la valeur dans la plage de [0, 1000] pour le pool de nœuds utilisateur et [1 1000] pour le pool de nœuds système.

--max-surge

Nœuds supplémentaires utilisés pour accélérer la mise à niveau. Quand elle est spécifiée, elle représente le nombre ou le pourcentage utilisé, par exemple. 5 ou 33 %.

--max-unavailable

Nombre maximal ou pourcentage de nœuds qui peuvent être simultanément indisponibles pendant la mise à niveau. Quand elle est spécifiée, elle représente le nombre ou le pourcentage utilisé, par exemple. 1 ou 5%.

--min-count

Nombre de nœuds de minimun utilisés pour la mise à l’échelle automatique, lorsque « --enable-cluster-autoscaler » spécifié. Spécifiez la valeur dans la plage de [0, 1000] pour le pool de nœuds utilisateur et [1 1000] pour le pool de nœuds système.

--mode

Mode d’un pool de nœuds qui définit la fonction principale d’un pool de nœuds. Si la valeur est « System », AKS préfère la planification des pods système aux pools de nœuds avec le mode System. Si la valeur est « ManagedSystem », toutes les autres propriétés, sauf le nom et le mode, sont rejetées et gérées par AKS. En savoir plus sur https://aka.ms/aks/nodepool/mode.

Propriété Valeur
Valeurs acceptées: Gateway, Machines, ManagedSystem, System, User
--no-wait

Ne pas attendre la fin de l’opération de longue durée.

Propriété Valeur
Valeur par défaut: False
--node-soak-duration

Durée (en minutes) d’attente après le drainage d’un nœud et avant de la réimager et passer au nœud suivant.

--node-taints

Les aversions de nœud pour le pool de nœuds.

--node-vm-size -s

Taille de machine virtuelle pour les nœuds Kubernetes. Configurable uniquement lors de la mise à jour des paramètres de mise à l’échelle automatique d’un pool de nœuds VirtualMachines.

--os-sku

Référence os-sku du pool de nœuds de l’agent.

Propriété Valeur
Valeurs acceptées: AzureLinux, AzureLinux3, AzureLinux3OSGuard, AzureLinuxOSGuard, Flatcar, Ubuntu, Ubuntu2204, Ubuntu2404
--scale-down-mode

Décrit comment les machines virtuelles sont ajoutées ou supprimées des pools de nœuds.

Propriété Valeur
Valeurs acceptées: Deallocate, Delete
--ssh-access
Préversion

Mettez à jour le paramètre SSH pour le pool de nœuds. Utilisez « désactivé » pour désactiver l’accès SSH, « localuser » pour activer l’accès SSH à l’aide de la clé privée.

Propriété Valeur
Valeurs acceptées: disabled, entraid, localuser
--tags

Balises séparées par l’espace : key[=value] [key[=value] ...]. Utilisez « » pour effacer les balises existantes.

--undrainable-node-behavior

Définissez le comportement des nœuds indrainables pendant la mise à niveau. La valeur doit être « Cordon » ou « Schedule ». La valeur par défaut est « Schedule ».

--update-cluster-autoscaler -u

Mettez à jour le nombre minimal ou le nombre maximal pour la mise à l’échelle automatique du cluster.

Propriété Valeur
Valeur par défaut: False
--upgrade-strategy

Stratégie de mise à niveau pour le pool de nœuds. Les valeurs autorisées sont « Rolling » ou « BlueGreen ». La valeur par défaut est « Rolling ».

Propriété Valeur
Valeurs acceptées: BlueGreen, Rolling
--yes -y

N’invitez pas à confirmer.

Propriété Valeur
Valeur par défaut: False
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az aks nodepool upgrade

Mettre à niveau le pool de nœuds dans un cluster Kubernetes managé.

az aks nodepool upgrade --cluster-name
                        --name --nodepool-name
                        --resource-group
                        [--aks-custom-headers]
                        [--drain-timeout]
                        [--if-match]
                        [--if-none-match]
                        [--kubernetes-version]
                        [--max-surge]
                        [--max-unavailable]
                        [--no-wait]
                        [--node-image-only]
                        [--node-soak-duration]
                        [--snapshot-id]
                        [--undrainable-node-behavior]
                        [--yes]

Paramètres obligatoires

--cluster-name

Nom du cluster.

--name --nodepool-name -n

Nom du pool de nœuds.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--aks-custom-headers

Paires clé-valeur séparées par des virgules pour spécifier des en-têtes personnalisés.

--drain-timeout

Lorsque les nœuds vident la durée d’attente de tous les pods à supprimer.

--if-match

La valeur fournie est comparée à l’ETag du pool de nœuds, si elle correspond à l’opération se poursuit. S’il ne correspond pas, la demande est rejetée pour empêcher les remplacements accidentels. Cela ne doit pas être spécifié lors de la création d’un nouveau pool d’agents. Pour les demandes de version d’image de nœud de mise à niveau, elles seront ignorées.

--if-none-match

Définissez sur « * » pour autoriser la création d’un nouveau pool de nœuds, mais pour empêcher la mise à jour d’un pool de nœuds existant. D’autres valeurs seront ignorées.

--kubernetes-version -k

Version de Kubernetes pour mettre à niveau le pool de nœuds vers, par exemple « 1.16.9 ».

--max-surge

Nœuds supplémentaires utilisés pour accélérer la mise à niveau. Quand elle est spécifiée, elle représente le nombre ou le pourcentage utilisé, par exemple. 5 ou 33 % (mutuellement exclusif avec « --node-image-only ». Consultez « az aks nodepool update --max-surge » pour mettre à jour max surge before upgrade with « -node-image-only »).

--max-unavailable

Nombre maximal ou pourcentage de nœuds qui peuvent être simultanément indisponibles pendant la mise à niveau. Quand elle est spécifiée, elle représente le nombre ou le pourcentage utilisé, par exemple. 1 ou 5%.

--no-wait

Ne pas attendre la fin de l’opération de longue durée.

Propriété Valeur
Valeur par défaut: False
--node-image-only

Mise à niveau uniquement de l’image de nœud du pool d’agents.

Propriété Valeur
Valeur par défaut: False
--node-soak-duration

Durée (en minutes) d’attente après le drainage d’un nœud et avant de la réimager et passer au nœud suivant.

--snapshot-id

ID d’instantané source utilisé pour mettre à niveau ce pool de nœuds.

--undrainable-node-behavior

Définissez le comportement des nœuds indrainables pendant la mise à niveau. La valeur doit être « Cordon » ou « Schedule ». La valeur par défaut est « Schedule ».

--yes -y

N’invitez pas à confirmer.

Propriété Valeur
Valeur par défaut: False
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az aks nodepool upgrade (aks-preview extension)

Mettre à niveau le pool de nœuds dans un cluster Kubernetes managé.

az aks nodepool upgrade --cluster-name
                        --name --nodepool-name
                        --resource-group
                        [--aks-custom-headers]
                        [--batch-soak-duration]
                        [--drain-batch-size]
                        [--drain-timeout]
                        [--drain-timeout-bg]
                        [--final-soak-duration]
                        [--if-match]
                        [--if-none-match]
                        [--kubernetes-version]
                        [--max-blocked-nodes]
                        [--max-surge]
                        [--max-unavailable]
                        [--no-wait]
                        [--node-image-only]
                        [--node-soak-duration]
                        [--snapshot-id]
                        [--undrainable-node-behavior]
                        [--upgrade-strategy {BlueGreen, Rolling}]
                        [--yes]

Paramètres obligatoires

--cluster-name

Nom du cluster.

--name --nodepool-name -n

Nom du pool de nœuds.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--aks-custom-headers

Envoyer des en-têtes personnalisés. Lorsqu’il est spécifié, le format doit être Key1=Value1,Key2=Value2.

--batch-soak-duration

Temps d’attente (en minutes) après avoir vidé un lot de nœuds avant de passer au lot suivant. La valeur par défaut est de 15 minutes. Uniquement pour les mises à niveau bleu-vert.

--drain-batch-size

Nombre ou pourcentage de nœuds à vider par lot pendant les mises à niveau bleu-vert. Accepte un entier (par exemple, « 5 ») ou un pourcentage (par exemple, « 50%»). La valeur par défaut est 10%.

Spécifie le nombre de nœuds à vider dans chaque lot pendant une mise à niveau bleu-vert. Doit être une valeur non nulle, soit sous la forme d’un entier (par exemple, « 5 ») soit d’un pourcentage (par exemple, « 50%») du nombre total de nœuds bleus au début de la mise à niveau. Les nœuds fractionnaires sont arrondis. Pour plus d’informations et des bonnes pratiques, consultez : https://learn.microsoft.com/en-us/azure/aks/upgrade-cluster.

--drain-timeout

Lorsque les nœuds vident le nombre de minutes à attendre que tous les pods soient supprimés.

--drain-timeout-bg

Délai d’expiration (en minutes) pour supprimer les pods et terminer correctement par nœud pendant les mises à niveau bleues vertes. La valeur par défaut est de 30 minutes.

Durée maximale (en minutes) d’attente de l’éviction du pod et de l’arrêt normal par nœud pendant les mises à niveau bleu-vert. Honore les budgets d’interruption des pods. Si elle est dépassée, la mise à niveau échoue. La valeur par défaut est de 30 minutes.

--final-soak-duration

Temps d’attente (en minutes) après que tous les anciens nœuds sont vidés avant de les supprimer. La valeur par défaut est de 60 minutes. Uniquement pour les mises à niveau bleu-vert.

--if-match

La valeur fournie est comparée à l’ETag du pool de nœuds, si elle correspond à l’opération se poursuit. S’il ne correspond pas, la demande est rejetée pour empêcher les remplacements accidentels. Cela ne doit pas être spécifié lors de la création d’un nouveau pool d’agents. Pour les demandes de version d’image de nœud de mise à niveau, elles seront ignorées.

--if-none-match

Définissez sur « * » pour autoriser la création d’un nouveau pool de nœuds, mais pour empêcher la mise à jour d’un pool de nœuds existant. D’autres valeurs seront ignorées.

--kubernetes-version -k

Version de Kubernetes pour mettre à niveau le pool de nœuds vers, par exemple « 1.11.12 ».

--max-blocked-nodes

Nombre maximal ou pourcentage de nœuds supplémentaires autorisés à être bloqués dans le pool d’agents lors d’une mise à niveau lorsque le comportement de nœud indrainable est Cordon. Quand elle est spécifiée, elle représente le nombre ou le pourcentage utilisé, par exemple. 1 ou 5%.

--max-surge

Nœuds supplémentaires utilisés pour accélérer la mise à niveau. Quand elle est spécifiée, elle représente le nombre ou le pourcentage utilisé, par exemple. 5 ou 33 %.

--max-unavailable

Nombre maximal ou pourcentage de nœuds qui peuvent être simultanément indisponibles pendant la mise à niveau. Quand elle est spécifiée, elle représente le nombre ou le pourcentage utilisé, par exemple. 1 ou 5%.

--no-wait

Ne pas attendre la fin de l’opération de longue durée.

Propriété Valeur
Valeur par défaut: False
--node-image-only

Mise à niveau uniquement de l’image de nœud du pool d’agents.

Propriété Valeur
Valeur par défaut: False
--node-soak-duration

Durée (en minutes) d’attente après le drainage d’un nœud et avant de la réimager et passer au nœud suivant.

--snapshot-id

ID d’instantané source utilisé pour mettre à niveau ce pool de nœuds. Doit utiliser le type de pool d’agents VMSS.

--undrainable-node-behavior

Définissez le comportement des nœuds indrainables pendant la mise à niveau. La valeur doit être « Cordon » ou « Schedule ». La valeur par défaut est « Schedule ».

--upgrade-strategy

Stratégie de mise à niveau pour le pool de nœuds. Les valeurs autorisées sont « Rolling » ou « BlueGreen ». La valeur par défaut est « Rolling ».

Propriété Valeur
Valeurs acceptées: BlueGreen, Rolling
--yes -y

N’invitez pas à confirmer.

Propriété Valeur
Valeur par défaut: False
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az aks nodepool wait

Attendez qu’un pool de nœuds atteigne un état souhaité.

Si une opération sur un pool de nœuds a été interrompue ou a été démarrée --no-wait, utilisez cette commande pour attendre qu’elle se termine.

az aks nodepool wait --cluster-name
                     --name --nodepool-name
                     --resource-group
                     [--created]
                     [--custom]
                     [--deleted]
                     [--exists]
                     [--interval]
                     [--timeout]
                     [--updated]

Exemples

Attendez qu’un pool de nœuds atteigne un état souhaité, interrogez toutes les minutes jusqu’à trente minutes.

az aks nodepool wait --created --interval 60 --cluster-name MyManagedCluster --resource-group MyResourceGroup --nodepool-name MyNodePool --timeout 1800

Paramètres obligatoires

--cluster-name

Nom du cluster.

--name --nodepool-name -n

Nom du pool de nœuds.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--created

Attendez la création avec « provisioningState » sur « Succeeded ».

Propriété Valeur
Groupe de paramètres: Wait Condition Arguments
Valeur par défaut: False
--custom

Attendez que la condition réponde à une requête JMESPath personnalisée. Par exemple, provisioningState !='InProgress', instanceView.statuses[ ?code=='PowerState/running'].

Propriété Valeur
Groupe de paramètres: Wait Condition Arguments
--deleted

Attendez la suppression.

Propriété Valeur
Groupe de paramètres: Wait Condition Arguments
Valeur par défaut: False
--exists

Attendez que la ressource existe.

Propriété Valeur
Groupe de paramètres: Wait Condition Arguments
Valeur par défaut: False
--interval

Intervalle d’interrogation en secondes.

Propriété Valeur
Groupe de paramètres: Wait Condition Arguments
Valeur par défaut: 30
--timeout

Délai maximal d’attente en secondes.

Propriété Valeur
Groupe de paramètres: Wait Condition Arguments
Valeur par défaut: 3600
--updated

Attendez la mise à jour avec provisioningState sur « Réussi ».

Propriété Valeur
Groupe de paramètres: Wait Condition Arguments
Valeur par défaut: False
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False