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 | É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é. |
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 |
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. |
Extension | GA |
az aks nodepool manual-scale add |
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é. |
Extension | GA |
az aks nodepool manual-scale update |
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
--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 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"
Paramètres obligatoires
le nom du cluster ;
Nom du pool de nœuds.
Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>
.
Paramètres facultatifs
Paires clé-valeur séparées par des virgules pour spécifier des en-têtes personnalisés.
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
.
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.
ID crg utilisé pour associer le nouveau nodepool à la ressource de groupe de réservations de capacité existant.
Désactivez Windows OutboundNAT sur le pool de nœuds de l’agent Windows.
Lorsque les nœuds vident le nombre de minutes à attendre que tous les pods soient supprimés.
Activez la mise à l’échelle automatique du cluster.
Activez EncryptionAtHost, la valeur par défaut est false.
Utilisez le système d’exploitation compatible FIPS sur les nœuds de l’agent.
Activez l’adresse IP publique du nœud VMSS.
Activez UltraSSD, la valeur par défaut est false.
Stratégie d’éviction du pool de nœuds Spot. Elle ne peut être définie que lorsque --priority est Spot.
Profil d’instance GPU pour partitionner des GPU Nvidia multi-gpu.
ID de groupe hôte dédié complet utilisé pour approvisionner le pool de nœuds de l’agent.
Chemin d’accès au fichier JSON contenant des configurations Kubelet pour les nœuds d’agent. https://aka.ms/aks/custom-node-config.
Version de Kubernetes à utiliser pour créer le cluster, par exemple « 1.16.9 ».
Étiquettes de nœud pour le pool de nœuds. Consultez https://aka.ms/node-labels la syntaxe des étiquettes.
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.
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.
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 ».
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 %.
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 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.
Ne pas attendre la fin de l’opération de longue durée.
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
.
Taille en Gio du disque du système d’exploitation pour chaque nœud du pool d’agents. Minimum 30 Gio.
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é'').
ID de préfixe IP public utilisé pour affecter des adresses IP publiques aux nœuds VMSS.
IpTags des adresses IP publiques du nœud.
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.
Les aversions de nœud pour le pool de nœuds.
Taille de Machines Virtuelles à créer en tant que nœuds Kubernetes.
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.
Type de système d’exploitation. Linux ou Windows.
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).
ID d’un PPG.
Priorité du pool de nœuds.
Décrivez comment les machines virtuelles sont ajoutées ou supprimées des pools de nœuds.
ID d’instantané source utilisé pour créer ce pool de nœuds.
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.
Balises séparées par l’espace : key[=value] [key[=value] ...]. Utilisez « » pour effacer les balises existantes.
ID de ressource d’un sous-réseau dans un réseau virtuel existant dans lequel déployer le cluster.
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
Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.
Affichez ce message d’aide et quittez.
Afficher uniquement les erreurs, en supprimant les avertissements.
Format de sortie.
Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID
.
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}]
[--gateway-prefix-size]
[--gpu-instance-profile {MIG1g, MIG2g, MIG3g, MIG4g, MIG7g}]
[--host-group-id]
[--if-match]
[--if-none-match]
[--kubelet-config]
[--kubernetes-version]
[--labels]
[--linux-os-config]
[--max-count]
[--max-pods]
[--max-surge]
[--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, 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]
[--vm-sizes]
[--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 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
Paramètres obligatoires
le nom du cluster ;
Nom du pool de nœuds.
Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>
.
Paramètres facultatifs
Envoyer des en-têtes personnalisés. Lorsqu’il est spécifié, le format doit être Key1=Value1,Key2=Value2.
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.
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 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.
Désactivez Windows OutboundNAT sur le pool de nœuds de l’agent Windows. Doit utiliser le type de pool d’agents VMSS.
Lorsque les nœuds vident le nombre de minutes à attendre que tous les pods soient supprimés.
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.
Activez la mise à l’échelle automatique du cluster. Doit utiliser le type de pool d’agents VMSS.
Activez l’approbation d’autorité de certification personnalisée sur le pool de nœuds de l’agent.
Activez EncryptionAtHost sur le pool de nœuds de l’agent.
Utilisez le système d’exploitation compatible FIPS sur les nœuds de l’agent.
Activez l’adresse IP publique du nœud VMSS. Doit utiliser le type de pool d’agents VMSS.
Activez le démarrage sécurisé sur le pool de nœuds de l’agent. Doit utiliser le type de pool d’agents VMSS.
Activez UltraSSD sur le pool de nœuds de l’agent. Doit utiliser le type de pool d’agents VMSS.
Activez vTPM sur le pool de nœuds de l’agent. Doit utiliser le type de pool d’agents VMSS.
Stratégie d’éviction du pool de nœuds Spot. Elle ne peut être définie que lorsque --priority est Spot.
Taille d’IPPrefix publique attachée au pool de nœuds en mode passerelle. Le pool de nœuds doit être en mode passerelle.
Profil d’instance GPU pour partitionner des GPU Nvidia multi-gpu.
(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.
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.
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.
Configurations Kubelet pour les nœuds d’agent.
Version de Kubernetes à utiliser pour créer le cluster, par exemple « 1.7.12 » ou « 1.8.7 ».
Étiquettes de nœud pour le pool de nœuds. Consultez https://aka.ms/node-labels la syntaxe des étiquettes.
Configurations du système d’exploitation pour les nœuds d’agent Linux.
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.
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 ».
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 %.
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.
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 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.
Ne pas attendre la fin de l’opération de longue durée.
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
.
Taille en Gio du disque du système d’exploitation pour chaque nœud du pool d’agents. Minimum 30 Gio.
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é'').
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.
IpTags des adresses IP publiques du nœud. Doit utiliser le type de pool d’agents VMSS.
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.
Les aversions de nœud pour le pool de nœuds.
Taille de Machines Virtuelles à créer en tant que nœuds Kubernetes.
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.
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 ».
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.
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).
ID d’un PPG. Doit utiliser le type de pool d’agents VMSS.
Priorité du pool de nœuds.
Décrit comment les machines virtuelles sont ajoutées ou supprimées des pools de nœuds.
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.
ID d’instantané source utilisé pour créer ce pool de nœuds. Doit utiliser le type de pool d’agents VMSS.
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.
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.
Balises séparées par l’espace : key[=value] [key[=value] ...]. Utilisez « » pour effacer les balises existantes.
Type de jeu de machines virtuelles du pool d’agents. VirtualMachineScaleSets, AvailabilitySet ou VirtualMachines(préversion).
Liste de tailles séparées par des virgules. Doit utiliser le type de pool d’agents VirtualMachines.
ID d’un sous-réseau d’un réseau virtuel existant dans lequel déployer le cluster.
Détermine le type de charge de travail qu’un nœud peut exécuter. Par défaut, OCIContainer.
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
Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.
Affichez ce message d’aide et quittez.
Afficher uniquement les erreurs, en supprimant les avertissements.
Format de sortie.
Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID
.
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
le nom du cluster ;
Nom du pool de nœuds.
Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>
.
Paramètres facultatifs
Ne pas attendre la fin de l’opération de longue durée.
Paramètres globaux
Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.
Affichez ce message d’aide et quittez.
Afficher uniquement les erreurs, en supprimant les avertissements.
Format de sortie.
Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID
.
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
[--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
le nom du cluster ;
Nom du pool de nœuds.
Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>
.
Paramètres facultatifs
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.
(PRÉVERSION) ignore-pod-disruption-budget supprime un pool de nœuds existant sans tenir compte du budget d’interruption de pod.
Ne pas attendre la fin de l’opération de longue durée.
Paramètres globaux
Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.
Affichez ce message d’aide et quittez.
Afficher uniquement les erreurs, en supprimant les avertissements.
Format de sortie.
Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID
.
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
le nom du cluster ;
Liste séparée par l’espace des noms d’ordinateurs du pool d’agents à supprimer.
Nom du pool de nœuds.
Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>
.
Paramètres facultatifs
Ne pas attendre la fin de l’opération de longue durée.
Paramètres globaux
Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.
Affichez ce message d’aide et quittez.
Afficher uniquement les erreurs, en supprimant les avertissements.
Format de sortie.
Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID
.
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
le nom du cluster ;
Nom du pool de nœuds.
Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>
.
Paramètres globaux
Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.
Affichez ce message d’aide et quittez.
Afficher uniquement les erreurs, en supprimant les avertissements.
Format de sortie.
Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID
.
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
le nom du cluster ;
Nom du pool de nœuds.
Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>
.
Paramètres globaux
Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.
Affichez ce message d’aide et quittez.
Afficher uniquement les erreurs, en supprimant les avertissements.
Format de sortie.
Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID
.
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
le nom du cluster ;
Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>
.
Paramètres globaux
Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.
Affichez ce message d’aide et quittez.
Afficher uniquement les erreurs, en supprimant les avertissements.
Format de sortie.
Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID
.
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
le nom du cluster ;
Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>
.
Paramètres globaux
Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.
Affichez ce message d’aide et quittez.
Afficher uniquement les erreurs, en supprimant les avertissements.
Format de sortie.
Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID
.
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
le nom du cluster ;
Nom du pool de nœuds.
Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>
.
Paramètres facultatifs
Ne pas attendre la fin de l’opération de longue durée.
Paramètres globaux
Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.
Affichez ce message d’aide et quittez.
Afficher uniquement les erreurs, en supprimant les avertissements.
Format de sortie.
Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID
.
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
le nom du cluster ;
Nom du pool de nœuds.
Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>
.
Paramètres facultatifs
Envoyer des en-têtes personnalisés. Lorsqu’il est spécifié, le format doit être Key1=Value1,Key2=Value2.
Ne pas attendre la fin de l’opération de longue durée.
Paramètres globaux
Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.
Affichez ce message d’aide et quittez.
Afficher uniquement les erreurs, en supprimant les avertissements.
Format de sortie.
Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID
.
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
le nom du cluster ;
Nom du pool de nœuds.
Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>
.
Paramètres facultatifs
Ne pas attendre la fin de l’opération de longue durée.
Nombre de nœuds dans le pool de nœuds Kubernetes.
Paramètres globaux
Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.
Affichez ce message d’aide et quittez.
Afficher uniquement les erreurs, en supprimant les avertissements.
Format de sortie.
Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID
.
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
le nom du cluster ;
Nom du pool de nœuds.
Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>
.
Paramètres facultatifs
Envoyer des en-têtes personnalisés. Lorsqu’il est spécifié, le format doit être Key1=Value1,Key2=Value2.
Ne pas attendre la fin de l’opération de longue durée.
Nombre de nœuds dans le pool de nœuds Kubernetes.
Paramètres globaux
Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.
Affichez ce message d’aide et quittez.
Afficher uniquement les erreurs, en supprimant les avertissements.
Format de sortie.
Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID
.
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
le nom du cluster ;
Nom du pool de nœuds.
Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>
.
Paramètres globaux
Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.
Affichez ce message d’aide et quittez.
Afficher uniquement les erreurs, en supprimant les avertissements.
Format de sortie.
Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID
.
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
le nom du cluster ;
Nom du pool de nœuds.
Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>
.
Paramètres globaux
Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.
Affichez ce message d’aide et quittez.
Afficher uniquement les erreurs, en supprimant les avertissements.
Format de sortie.
Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID
.
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
le nom du cluster ;
Nom du pool de nœuds.
Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>
.
Paramètres facultatifs
Envoyer des en-têtes personnalisés. Lorsqu’il est spécifié, le format doit être Key1=Value1,Key2=Value2.
Ne pas attendre la fin de l’opération de longue durée.
Paramètres globaux
Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.
Affichez ce message d’aide et quittez.
Afficher uniquement les erreurs, en supprimant les avertissements.
Format de sortie.
Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID
.
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
le nom du cluster ;
Nom du pool de nœuds.
Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>
.
Paramètres facultatifs
Envoyer des en-têtes personnalisés. Lorsqu’il est spécifié, le format doit être Key1=Value1,Key2=Value2.
Ne pas attendre la fin de l’opération de longue durée.
Paramètres globaux
Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.
Affichez ce message d’aide et quittez.
Afficher uniquement les erreurs, en supprimant les avertissements.
Format de sortie.
Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID
.
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
le nom du cluster ;
Nom du pool de nœuds.
Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>
.
Paramètres facultatifs
Envoyer des en-têtes personnalisés. Lorsqu’il est spécifié, le format doit être Key1=Value1,Key2=Value2.
Ne pas attendre la fin de l’opération de longue durée.
Paramètres globaux
Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.
Affichez ce message d’aide et quittez.
Afficher uniquement les erreurs, en supprimant les avertissements.
Format de sortie.
Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID
.
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
le nom du cluster ;
Nom du pool de nœuds.
Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>
.
Paramètres facultatifs
Envoyer des en-têtes personnalisés. Lorsqu’il est spécifié, le format doit être Key1=Value1,Key2=Value2.
Ne pas attendre la fin de l’opération de longue durée.
Paramètres globaux
Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.
Affichez ce message d’aide et quittez.
Afficher uniquement les erreurs, en supprimant les avertissements.
Format de sortie.
Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID
.
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]
[--os-sku {AzureLinux, CBLMariner, Mariner}]
[--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
le nom du cluster ;
Nom du pool de nœuds.
Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>
.
Paramètres facultatifs
Paires clé-valeur séparées par des virgules pour spécifier des en-têtes personnalisés.
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
.
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.
Désactivez la mise à l’échelle automatique du cluster.
Lorsque les nœuds vident le nombre de minutes à attendre que tous les pods soient supprimés.
Activez la mise à l’échelle automatique du cluster.
Étiquettes de nœud pour le pool de nœuds. Consultez https://aka.ms/node-labels la syntaxe des étiquettes.
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.
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 %.
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 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.
Ne pas attendre la fin de l’opération de longue durée.
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.
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.
Référence os-sku du pool de nœuds de l’agent.
Décrivez comment les machines virtuelles sont ajoutées ou supprimées des pools de nœuds.
Balises séparées par l’espace : key[=value] [key[=value] ...]. Utilisez « » pour effacer les balises existantes.
Mettez à jour le nombre minimal ou le nombre maximal pour la mise à l’échelle automatique du cluster.
Paramètres globaux
Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.
Affichez ce message d’aide et quittez.
Afficher uniquement les erreurs, en supprimant les avertissements.
Format de sortie.
Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID
.
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-fips-image]
[--disable-secure-boot]
[--disable-vtpm]
[--drain-timeout]
[--enable-artifact-streaming]
[--enable-cluster-autoscaler]
[--enable-custom-ca-trust]
[--enable-fips-image]
[--enable-secure-boot]
[--enable-vtpm]
[--if-match]
[--if-none-match]
[--labels]
[--max-count]
[--max-surge]
[--min-count]
[--mode {Gateway, 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
le nom du cluster ;
Nom du pool de nœuds.
Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>
.
Paramètres facultatifs
Envoyer des en-têtes personnalisés. Lorsqu’il est spécifié, le format doit être Key1=Value1,Key2=Value2.
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.
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.
Désactivez l’approbation d’autorité de certification personnalisée sur le pool de nœuds de l’agent.
Désactivez la mise à l’échelle automatique du cluster.
Basculez pour utiliser le système d’exploitation non compatible FIPS sur les nœuds de l’agent.
Désactivez le démarrage sécurisé sur un pool de nœuds d’agent activé pour le lancement approuvé existant.
Désactivez vTPM sur un pool de nœuds d’agent activé pour le lancement approuvé existant.
Lorsque les nœuds vident le nombre de minutes à attendre que tous les pods soient supprimés.
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.
Activez la mise à l’échelle automatique du cluster. Doit utiliser le type de pool d’agents VMSS.
Activez l’approbation d’autorité de certification personnalisée sur le pool de nœuds de l’agent.
Basculez pour utiliser le système d’exploitation compatible FIPS sur les nœuds de l’agent.
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.
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.
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.
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.
Étiquettes de nœud pour le pool de nœuds. Consultez https://aka.ms/node-labels la syntaxe des étiquettes.
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.
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 %.
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 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.
Ne pas attendre la fin de l’opération de longue durée.
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.
Les aversions de nœud pour le pool de nœuds.
Référence os-sku du pool de nœuds de l’agent.
Décrit comment les machines virtuelles sont ajoutées ou supprimées des pools de nœuds.
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.
Balises séparées par l’espace : key[=value] [key[=value] ...]. Utilisez « » pour effacer les balises existantes.
Mettez à jour le nombre minimal ou le nombre maximal pour la mise à l’échelle automatique du cluster.
Ne pas demander de confirmation.
Paramètres globaux
Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.
Affichez ce message d’aide et quittez.
Afficher uniquement les erreurs, en supprimant les avertissements.
Format de sortie.
Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID
.
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
le nom du cluster ;
Nom du pool de nœuds.
Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>
.
Paramètres facultatifs
Paires clé-valeur séparées par des virgules pour spécifier des en-têtes personnalisés.
Lorsque les nœuds vident la durée d’attente de tous les pods à supprimer.
Version de Kubernetes pour mettre à niveau le pool de nœuds vers, par exemple « 1.16.9 ».
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 »).
Ne pas attendre la fin de l’opération de longue durée.
Mise à niveau uniquement de l’image de nœud du pool d’agents.
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.
ID d’instantané source utilisé pour mettre à niveau ce pool de nœuds.
Ne pas demander de confirmation.
Paramètres globaux
Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.
Affichez ce message d’aide et quittez.
Afficher uniquement les erreurs, en supprimant les avertissements.
Format de sortie.
Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID
.
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]
[--if-match]
[--if-none-match]
[--kubernetes-version]
[--max-surge]
[--no-wait]
[--node-image-only]
[--node-soak-duration]
[--snapshot-id]
[--yes]
Paramètres obligatoires
le nom du cluster ;
Nom du pool de nœuds.
Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>
.
Paramètres facultatifs
Envoyer des en-têtes personnalisés. Lorsqu’il est spécifié, le format doit être Key1=Value1,Key2=Value2.
Lorsque les nœuds vident le nombre de minutes à attendre que tous les pods soient supprimés.
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.
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.
Version de Kubernetes pour mettre à niveau le pool de nœuds vers, par exemple « 1.11.12 ».
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 %.
Ne pas attendre la fin de l’opération de longue durée.
Mise à niveau uniquement de l’image de nœud du pool d’agents.
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.
ID d’instantané source utilisé pour mettre à niveau ce pool de nœuds. Doit utiliser le type de pool d’agents VMSS.
Ne pas demander de confirmation.
Paramètres globaux
Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.
Affichez ce message d’aide et quittez.
Afficher uniquement les erreurs, en supprimant les avertissements.
Format de sortie.
Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID
.
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
le nom du cluster ;
Nom du pool de nœuds.
Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>
.
Paramètres facultatifs
Attendez la création avec « provisioningState » sur « Succeeded ».
Attendez que la condition réponde à une requête JMESPath personnalisée. Par exemple, provisioningState !='InProgress', instanceView.statuses[ ?code=='PowerState/running'].
Attendez la suppression.
Attendez que la ressource existe.
Intervalle d’interrogation en secondes.
Délai maximal d’attente en secondes.
Attendez la mise à jour avec provisioningState sur « Réussi ».
Paramètres globaux
Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.
Affichez ce message d’aide et quittez.
Afficher uniquement les erreurs, en supprimant les avertissements.
Format de sortie.
Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID
.
Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.