az aks nodepool

Remarque

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. En savoir plus sur les extensions.

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

Commandes

Nom Description Type Statut
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é.

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 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é 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épertoriez les instantané de nodepool.

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

Répertoriez les instantané de nodepool.

Extension GA
az aks nodepool snapshot show

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

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

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

Extension GA
az aks nodepool snapshot update

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

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

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

Extension GA
az aks nodepool snapshot wait

Attendez qu’un pool de nœuds instantané 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
                    --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-ultra-ssd]
                    [--eviction-policy {Deallocate, Delete}]
                    [--gpu-instance-profile {MIG1g, MIG2g, MIG3g, MIG4g, MIG7g}]
                    [--host-group-id]
                    [--kubelet-config]
                    [--kubernetes-version]
                    [--labels]
                    [--linux-os-config]
                    [--max-count]
                    [--max-pods]
                    [--max-surge]
                    [--min-count]
                    [--mode {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, CBLMariner, Mariner, Ubuntu, Windows2019, Windows2022}]
                    [--os-type]
                    [--pod-subnet-id]
                    [--ppg]
                    [--priority {Regular, Spot}]
                    [--scale-down-mode {Deallocate, Delete}]
                    [--snapshot-id]
                    [--spot-max-price]
                    [--tags]
                    [--vnet-subnet-id]
                    [--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 de 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"

Paramètres obligatoires

--cluster-name

le 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 en utilisant az configure --defaults group=<name>.

Paramètres facultatifs

--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.

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.

valeur par défaut: False
--enable-encryption-at-host

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

valeur par défaut: False
--enable-fips-image

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

valeur par défaut: False
--enable-node-public-ip

Activez l’adresse IP publique du nœud VMSS.

valeur par défaut: False
--enable-ultra-ssd

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

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.

valeurs acceptées: Deallocate, Delete
valeur par défaut: Delete
--gpu-instance-profile

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

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.

--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 ».

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.

--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 %.

--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. Pour en savoir plus, rendez-vous sur https://aka.ms/aks/nodepool/mode.

valeurs acceptées: System, User
valeur par défaut: User
--no-wait

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

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.

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é'').

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.

--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.

--os-sku

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

valeurs acceptées: AzureLinux, CBLMariner, Mariner, Ubuntu, Windows2019, Windows2022
--os-type

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

--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.

valeurs acceptées: Regular, Spot
valeur par défaut: Regular
--scale-down-mode

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

valeurs acceptées: Deallocate, Delete
valeur par défaut: Delete
--snapshot-id

ID 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, ce qui indique que le prix par défaut doit être à la demande. Il ne peut inclure que jusqu’à 5 décimales.

valeur par défaut: nan
--tags

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

--vnet-subnet-id

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

--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 le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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

az aks nodepool add (aks-preview extension)

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

az aks nodepool add --cluster-name
                    --name
                    --resource-group
                    [--aks-custom-headers]
                    [--allowed-host-ports]
                    [--asg-ids]
                    [--crg-id]
                    [--disable-windows-outbound-nat]
                    [--drain-timeout]
                    [--enable-artifact-streaming]
                    [--enable-cluster-autoscaler]
                    [--enable-custom-ca-trust]
                    [--enable-encryption-at-host]
                    [--enable-fips-image]
                    [--enable-node-public-ip]
                    [--enable-secure-boot]
                    [--enable-ultra-ssd]
                    [--enable-vtpm]
                    [--eviction-policy {Deallocate, Delete}]
                    [--gpu-instance-profile {MIG1g, MIG2g, MIG3g, MIG4g, MIG7g}]
                    [--host-group-id]
                    [--kubelet-config]
                    [--kubernetes-version]
                    [--labels]
                    [--linux-os-config]
                    [--max-count]
                    [--max-pods]
                    [--max-surge]
                    [--message-of-the-day]
                    [--min-count]
                    [--mode {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, CBLMariner, Mariner, Ubuntu, Windows2019, Windows2022, WindowsAnnual}]
                    [--os-type]
                    [--pod-ip-allocation-mode {DynamicIndividual, StaticBlock}]
                    [--pod-subnet-id]
                    [--ppg]
                    [--priority {Regular, Spot}]
                    [--scale-down-mode {Deallocate, Delete}]
                    [--skip-gpu-driver-install]
                    [--snapshot-id]
                    [--spot-max-price]
                    [--ssh-access {disabled, localuser}]
                    [--tags]
                    [--vm-set-type]
                    [--vnet-subnet-id]
                    [--workload-runtime {KataCcIsolation, KataMshvVmIsolation, 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 de 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

Paramètres obligatoires

--cluster-name

le 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 en utilisant az configure --defaults group=<name>.

Paramètres facultatifs

--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.

--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.

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-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.

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.

valeur par défaut: False
--enable-custom-ca-trust

Activez l’approbation d’autorité de certification personnalisée sur le pool de nœuds de l’agent.

valeur par défaut: False
--enable-encryption-at-host

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

valeur par défaut: False
--enable-fips-image

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

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.

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.

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.

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.

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.

valeurs acceptées: Deallocate, Delete
valeur par défaut: Delete
--gpu-instance-profile

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

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.

--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 ».

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.

--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 ».

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 %.

--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. Pour en savoir plus, rendez-vous sur https://aka.ms/aks/nodepool/mode.

valeurs acceptées: System, User
valeur par défaut: User
--no-wait

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

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.

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.

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é'').

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.

--os-sku

Référence os-sku du pool de nœuds de l’agent. Ubuntu ou CBLMarinr quand 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 ou WindowsAnnual quand le type de système d’exploitation est Windows, la valeur par défaut actuelle est Windows2022 si elle n’est pas définie.

valeurs acceptées: AzureLinux, CBLMariner, Mariner, Ubuntu, Windows2019, Windows2022, 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.

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.

valeurs acceptées: Regular, Spot
valeur par défaut: Regular
--scale-down-mode

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

valeurs acceptées: Deallocate, Delete
valeur par défaut: Delete
--skip-gpu-driver-install
Préversion

Pour ignorer l’installation automatique du pilote GPU par AKS sur un pool de nœuds à l’aide de la taille de machine virtuelle GPU si les clients souhaitent gérer l’installation du pilote GPU par eux-mêmes. S’il n’est pas spécifié, la valeur par défaut est false.

valeur par défaut: False
--snapshot-id

ID 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, ce qui indique que le prix par défaut doit être à la demande. Il ne peut inclure que jusqu’à 5 décimales.

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.

valeurs acceptées: disabled, localuser
valeur par défaut: localuser
--tags

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

--vm-set-type

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

--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.

valeurs acceptées: KataCcIsolation, KataMshvVmIsolation, OCIContainer, WasmWasi
valeur par défaut: OCIContainer
--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 le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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

az aks nodepool delete

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

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

Paramètres obligatoires

--cluster-name

le 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 en utilisant az configure --defaults group=<name>.

Paramètres facultatifs

--no-wait

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

valeur par défaut: False
Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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

az aks nodepool delete (aks-preview extension)

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

az aks nodepool delete --cluster-name
                       --name
                       --resource-group
                       [--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

le 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 en utilisant az configure --defaults group=<name>.

Paramètres facultatifs

--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.

valeur par défaut: False
Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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

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
                                --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

le 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 en utilisant az configure --defaults group=<name>.

Paramètres facultatifs

--no-wait

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

valeur par défaut: False
Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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

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
                             --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

le 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 en utilisant az configure --defaults group=<name>.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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

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
                             --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

le 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 en utilisant az configure --defaults group=<name>.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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

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

le nom du cluster ;

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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

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

le nom du cluster ;

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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

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
                                --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

le 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 en utilisant az configure --defaults group=<name>.

Paramètres facultatifs

--no-wait

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

valeur par défaut: False
Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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

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
                                --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

le 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 en utilisant az configure --defaults group=<name>.

Paramètres facultatifs

--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.

valeur par défaut: False
Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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

az aks nodepool scale

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

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

Paramètres obligatoires

--cluster-name

le 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 en utilisant az configure --defaults group=<name>.

Paramètres facultatifs

--no-wait

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

valeur par défaut: False
--node-count -c

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

valeur par défaut: 3
Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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

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
                      --resource-group
                      [--aks-custom-headers]
                      [--no-wait]
                      [--node-count]

Paramètres obligatoires

--cluster-name

le 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 en utilisant az configure --defaults group=<name>.

Paramètres facultatifs

--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.

valeur par défaut: False
--node-count -c

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

valeur par défaut: 3
Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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

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
                     --resource-group

Paramètres obligatoires

--cluster-name

le 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 en utilisant az configure --defaults group=<name>.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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

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
                     --resource-group

Paramètres obligatoires

--cluster-name

le 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 en utilisant az configure --defaults group=<name>.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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

az aks nodepool start

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

az aks nodepool start --cluster-name
                      --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

le 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 en utilisant az configure --defaults group=<name>.

Paramètres facultatifs

--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.

valeur par défaut: False
Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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

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
                      --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

le 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 en utilisant az configure --defaults group=<name>.

Paramètres facultatifs

--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.

valeur par défaut: False
Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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

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
                     --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

le 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 en utilisant az configure --defaults group=<name>.

Paramètres facultatifs

--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.

valeur par défaut: False
Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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

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
                     --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

le 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 en utilisant az configure --defaults group=<name>.

Paramètres facultatifs

--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.

valeur par défaut: False
Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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

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
                       --resource-group
                       [--aks-custom-headers]
                       [--allowed-host-ports]
                       [--asg-ids]
                       [--disable-cluster-autoscaler]
                       [--drain-timeout]
                       [--enable-cluster-autoscaler]
                       [--labels]
                       [--max-count]
                       [--max-surge]
                       [--min-count]
                       [--mode {System, User}]
                       [--no-wait]
                       [--node-soak-duration]
                       [--node-taints]
                       [--scale-down-mode {Deallocate, Delete}]
                       [--tags]
                       [--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

le 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 en utilisant az configure --defaults group=<name>.

Paramètres facultatifs

--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.

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.

valeur par défaut: False
--labels

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

--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 %.

--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. Pour en savoir plus, rendez-vous sur https://aka.ms/aks/nodepool/mode.

valeurs acceptées: System, User
--no-wait

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

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.

--scale-down-mode

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

valeurs acceptées: Deallocate, Delete
--tags

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

--update-cluster-autoscaler -u

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

valeur par défaut: False
Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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

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
                       --resource-group
                       [--aks-custom-headers]
                       [--allowed-host-ports]
                       [--asg-ids]
                       [--dcat]
                       [--disable-cluster-autoscaler]
                       [--disable-secure-boot]
                       [--disable-vtpm]
                       [--drain-timeout]
                       [--enable-artifact-streaming]
                       [--enable-cluster-autoscaler]
                       [--enable-custom-ca-trust]
                       [--enable-secure-boot]
                       [--enable-vtpm]
                       [--labels]
                       [--max-count]
                       [--max-surge]
                       [--min-count]
                       [--mode {System, User}]
                       [--no-wait]
                       [--node-soak-duration]
                       [--node-taints]
                       [--os-sku {AzureLinux, Ubuntu}]
                       [--scale-down-mode {Deallocate, Delete}]
                       [--ssh-access {disabled, localuser}]
                       [--tags]
                       [--update-cluster-autoscaler]
                       [--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

Paramètres obligatoires

--cluster-name

le 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 en utilisant az configure --defaults group=<name>.

Paramètres facultatifs

--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.

--dcat --disable-custom-ca-trust

Désactivez l’approbation d’autorité de certification personnalisée sur le pool de nœuds de l’agent.

valeur par défaut: False
--disable-cluster-autoscaler -d

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

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.

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.

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-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.

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.

valeur par défaut: False
--enable-custom-ca-trust

Activez l’approbation d’autorité de certification personnalisée sur le pool de nœuds de l’agent.

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.

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.

valeur par défaut: False
--labels

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

--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 %.

--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. Pour en savoir plus, rendez-vous sur https://aka.ms/aks/nodepool/mode.

valeurs acceptées: System, User
--no-wait

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

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.

--os-sku

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

valeurs acceptées: AzureLinux, Ubuntu
--scale-down-mode

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

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.

valeurs acceptées: disabled, localuser
--tags

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

--update-cluster-autoscaler -u

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

valeur par défaut: False
--yes -y

Ne pas demander de confirmation.

valeur par défaut: False
Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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

az aks nodepool upgrade

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

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

Paramètres obligatoires

--cluster-name

le 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 en utilisant az configure --defaults group=<name>.

Paramètres facultatifs

--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.

--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 »).

--no-wait

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

valeur par défaut: False
--node-image-only

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

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 instantané source utilisé pour mettre à niveau ce pool de nœuds.

--yes -y

Ne pas demander de confirmation.

valeur par défaut: False
Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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

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
                        --resource-group
                        [--aks-custom-headers]
                        [--drain-timeout]
                        [--kubernetes-version]
                        [--max-surge]
                        [--no-wait]
                        [--node-image-only]
                        [--node-soak-duration]
                        [--snapshot-id]
                        [--yes]

Paramètres obligatoires

--cluster-name

le 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 en utilisant az configure --defaults group=<name>.

Paramètres facultatifs

--aks-custom-headers

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

--drain-timeout

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

--kubernetes-version -k

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

--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 %.

--no-wait

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

valeur par défaut: False
--node-image-only

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

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 instantané source utilisé pour mettre à niveau ce pool de nœuds. Doit utiliser le type de pool d’agents VMSS.

--yes -y

Ne pas demander de confirmation.

valeur par défaut: False
Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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

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
                     --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

le 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 en utilisant az configure --defaults group=<name>.

Paramètres facultatifs

--created

Attendez la création avec « provisioningState » sur « Succeeded ».

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'].

--deleted

Attendez la suppression.

valeur par défaut: False
--exists

Attendez que la ressource existe.

valeur par défaut: False
--interval

Intervalle d’interrogation en secondes.

valeur par défaut: 30
--timeout

Délai maximal d’attente en secondes.

valeur par défaut: 3600
--updated

Attendez la mise à jour avec provisioningState sur « Réussi ».

valeur par défaut: False
Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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