Partager via

az aks loadbalancer

Note

Cette référence fait partie de l’extension aks-preview pour Azure CLI (version 2.73.0 ou ultérieure). L’extension installe automatiquement la première fois que vous exécutez une commande az aks loadbalancer . Apprenez-en davantage sur les extensions.

Commandes pour gérer les configurations de l’équilibreur de charge dans un cluster Kubernetes managé.

Ces commandes permettent la fonctionnalité de plusieurs équilibreurs de charge standard pour les clusters Azure Kubernetes Service.

Commandes

Nom Description Type État
az aks loadbalancer add

Ajoutez une configuration d’équilibreur de charge à un cluster Kubernetes managé.

 Extension GA
az aks loadbalancer delete

Supprimez une configuration d’équilibreur de charge d’un cluster Kubernetes managé.

 Extension GA
az aks loadbalancer list

Répertoriez toutes les configurations d’équilibreur de charge dans un cluster Kubernetes managé.

 Extension GA
az aks loadbalancer rebalance-nodes

Rééquilibrer les nœuds entre des équilibreurs de charge spécifiques.

 Extension GA
az aks loadbalancer show

Afficher les détails d’une configuration d’équilibreur de charge spécifique dans un cluster Kubernetes managé.

 Extension GA
az aks loadbalancer update

Mettez à jour une configuration d’équilibreur de charge dans un cluster Kubernetes managé.

 Extension GA

az aks loadbalancer add

Ajoutez une configuration d’équilibreur de charge à un cluster Kubernetes managé.

az aks loadbalancer add --cluster-name
                        --name
                        --primary-agent-pool-name
                        --resource-group
                        [--aks-custom-headers]
                        [--allow-service-placement {false, true}]
                        [--node-selector]
                        [--service-label-selector]
                        [--service-namespace-selector]

Exemples

Ajouter une configuration d’équilibreur de charge avec un pool d’agents principal spécifique

az aks loadbalancer add -g MyResourceGroup -n secondary --cluster-name MyManagedCluster --primary-agent-pool-name nodepool1

Ajouter une configuration d’équilibreur de charge avec le sélecteur d’étiquette de service

az aks loadbalancer add -g MyResourceGroup -n app-lb --cluster-name MyManagedCluster --primary-agent-pool-name nodepool2 --service-label-selector app=frontend

Ajouter une configuration d’équilibreur de charge qui ne place pas automatiquement les services

az aks loadbalancer add -g MyResourceGroup -n restricted-lb --cluster-name MyManagedCluster --primary-agent-pool-name nodepool3 --allow-service-placement false

Ajouter une configuration d’équilibreur de charge avec des en-têtes d’API AKS personnalisés

az aks loadbalancer add -g MyResourceGroup -n api-lb --cluster-name MyManagedCluster --primary-agent-pool-name nodepool1 --aks-custom-headers CustomHeader=Value

Paramètres obligatoires

--cluster-name

Nom du cluster géré.

--name -n

Nom de la configuration de l’équilibreur de charge.

Nom de l’équilibreur de charge utilisé pour l’identification. Il doit y avoir une configuration nommée « kubernetes » dans le cluster.

--primary-agent-pool-name -p

Nom du pool d’agents principal pour cet équilibreur de charge.

Champ obligatoire. Valeur de chaîne qui doit spécifier l’ID d’un pool d’agents existant. Tous les nœuds du pool donné sont toujours ajoutés à cet équilibreur de charge.

--resource-group -g

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

Paramètres facultatifs

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

--aks-custom-headers

Envoyez des en-têtes personnalisés à l’API AKS.

Lorsqu’il est spécifié, le format doit être Key1=Value1,Key2=Value2.

--allow-service-placement -a

Indique s’il faut placer automatiquement des services sur l’équilibreur de charge.

S’il n’est pas fourni, la valeur par défaut est true. Si la valeur est false manuellement, l’équilibreur de charge externe et interne ne sera pas sélectionné pour les services, sauf s’ils le ciblent explicitement.

Propriété Valeur
Valeurs acceptées: false, true
--node-selector -d

Sélecteur d’étiquette de nœud pour les nœuds qui peuvent être membres de cet équilibreur de charge.

Les nœuds qui correspondent à ce sélecteur seront les membres possibles de cet équilibreur de charge. Mettre en forme comme paires clé=valeur séparées par des virgules.

--service-label-selector -l

Sélecteur d’étiquette pour les services qui peuvent être placés sur cet équilibreur de charge.

Seuls les services qui correspondent à ce sélecteur peuvent être placés sur cet équilibreur de charge. Mettez en forme comme paires clé=valeur séparées par des virgules ou des expressions telles que « key In value1,value2 ».

--service-namespace-selector -s

Sélecteur d’étiquette d’espace de noms pour les services qui peuvent être placés sur cet équilibreur de charge.

Les services créés dans des espaces de noms qui correspondent au sélecteur peuvent être placés sur cet équilibreur de charge. Mettre en forme comme paires clé=valeur séparées par des virgules.

Paramètres globaux
--debug

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

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

Affichez ce message d’aide et quittez-le.

--only-show-errors

Affiche uniquement les erreurs, en supprimant les avertissements.

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

Format de sortie.

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

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

--subscription

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

--verbose

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

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

az aks loadbalancer delete

Supprimez une configuration d’équilibreur de charge d’un cluster Kubernetes managé.

az aks loadbalancer delete --cluster-name
                           --name
                           --resource-group

Exemples

Supprimer une configuration d’équilibreur de charge

az aks loadbalancer delete -g MyResourceGroup -n secondary --cluster-name MyManagedCluster

Paramètres obligatoires

--cluster-name

Nom du cluster géré.

--name -n

Nom de la configuration de l’équilibreur de charge à supprimer.

L’équilibreur de charge « kubernetes » ne peut pas être supprimé, car il est nécessaire pour l’opération de cluster.

--resource-group -g

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

Paramètres globaux
--debug

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

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

Affichez ce message d’aide et quittez-le.

--only-show-errors

Affiche uniquement les erreurs, en supprimant les avertissements.

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

Format de sortie.

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

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

--subscription

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

--verbose

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

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

az aks loadbalancer list

Répertoriez toutes les configurations d’équilibreur de charge dans un cluster Kubernetes managé.

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

Exemples

Répertorier toutes les configurations de l’équilibreur de charge

az aks loadbalancer list -g MyResourceGroup --cluster-name MyManagedCluster

Répertorier toutes les configurations de l’équilibreur de charge au format de tableau

az aks loadbalancer list -g MyResourceGroup --cluster-name MyManagedCluster -o table

Paramètres obligatoires

--cluster-name

Nom du cluster géré.

--resource-group -g

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

Paramètres globaux
--debug

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

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

Affichez ce message d’aide et quittez-le.

--only-show-errors

Affiche uniquement les erreurs, en supprimant les avertissements.

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

Format de sortie.

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

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

--subscription

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

--verbose

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

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

az aks loadbalancer rebalance-nodes

Rééquilibrer les nœuds entre des équilibreurs de charge spécifiques.

az aks loadbalancer rebalance-nodes --name
                                    --resource-group
                                    [--lb-names --load-balancer-names]

Paramètres obligatoires

--name -n

Nom du cluster géré.

--resource-group -g

Nom du groupe de ressources.

Paramètres facultatifs

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

--lb-names --load-balancer-names

Liste séparée par l’espace des noms d’équilibreur de charge à rééquilibrer. S’il n’est pas spécifié, tous les équilibreurs de charge sont rééquilibrés.

Paramètres globaux
--debug

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

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

Affichez ce message d’aide et quittez-le.

--only-show-errors

Affiche uniquement les erreurs, en supprimant les avertissements.

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

Format de sortie.

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

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

--subscription

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

--verbose

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

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

az aks loadbalancer show

Afficher les détails d’une configuration d’équilibreur de charge spécifique dans un cluster Kubernetes managé.

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

Exemples

Afficher les détails d’une configuration d’équilibreur de charge spécifique

az aks loadbalancer show -g MyResourceGroup -n secondary --cluster-name MyManagedCluster

Afficher les détails d’une configuration d’équilibreur de charge au format de tableau

az aks loadbalancer show -g MyResourceGroup -n kubernetes --cluster-name MyManagedCluster -o table

Paramètres obligatoires

--cluster-name

Nom du cluster géré.

--name -n

Nom de la configuration de l’équilibreur de charge à afficher.

--resource-group -g

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

Paramètres globaux
--debug

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

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

Affichez ce message d’aide et quittez-le.

--only-show-errors

Affiche uniquement les erreurs, en supprimant les avertissements.

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

Format de sortie.

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

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

--subscription

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

--verbose

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

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

az aks loadbalancer update

Mettez à jour une configuration d’équilibreur de charge dans un cluster Kubernetes managé.

az aks loadbalancer update --cluster-name
                           --name
                           --resource-group
                           [--aks-custom-headers]
                           [--allow-service-placement {false, true}]
                           [--node-selector]
                           [--primary-agent-pool-name]
                           [--service-label-selector]
                           [--service-namespace-selector]

Exemples

Mettre à jour le pool d’agents principal d’une configuration d’équilibreur de charge

az aks loadbalancer update -g MyResourceGroup -n secondary --cluster-name MyManagedCluster --primary-agent-pool-name nodepool2

Mettre à jour une configuration d’équilibreur de charge pour désactiver le placement automatique du service

az aks loadbalancer update -g MyResourceGroup -n app-lb --cluster-name MyManagedCluster --allow-service-placement false

Mettre à jour une configuration d’équilibreur de charge avec un nouveau sélecteur de service

az aks loadbalancer update -g MyResourceGroup -n app-lb --cluster-name MyManagedCluster --service-label-selector tier=frontend,environment=production

Mettre à jour une configuration d’équilibreur de charge avec des en-têtes d’API AKS personnalisés

az aks loadbalancer update -g MyResourceGroup -n api-lb --cluster-name MyManagedCluster --aks-custom-headers CustomHeader=Value

Paramètres obligatoires

--cluster-name

Nom du cluster géré.

--name -n

Nom de la configuration de l’équilibreur de charge à mettre à jour.

--resource-group -g

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

Paramètres facultatifs

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

--aks-custom-headers

Envoyez des en-têtes personnalisés à l’API AKS.

Lorsqu’il est spécifié, le format doit être Key1=Value1,Key2=Value2.

--allow-service-placement -a

Indique s’il faut placer automatiquement des services sur l’équilibreur de charge.

Si la valeur est false, l’équilibreur de charge externe et interne ne sera pas sélectionné pour les services, sauf s’ils le ciblent explicitement.

Propriété Valeur
Valeurs acceptées: false, true
--node-selector -d

Sélecteur d’étiquette de nœud pour les nœuds qui peuvent être membres de cet équilibreur de charge.

Les nœuds qui correspondent à ce sélecteur seront les membres possibles de cet équilibreur de charge. Mettre en forme comme paires clé=valeur séparées par des virgules.

--primary-agent-pool-name -p

Nom du pool d’agents principal pour cet équilibreur de charge.

Valeur de chaîne qui doit spécifier l’ID d’un pool d’agents existant. Tous les nœuds du pool donné sont toujours ajoutés à cet équilibreur de charge.

--service-label-selector -l

Sélecteur d’étiquette pour les services qui peuvent être placés sur cet équilibreur de charge.

Seuls les services qui correspondent à ce sélecteur peuvent être placés sur cet équilibreur de charge. Mettez en forme comme paires clé=valeur séparées par des virgules ou des expressions telles que « key In value1,value2 ».

--service-namespace-selector -s

Sélecteur d’étiquette d’espace de noms pour les services qui peuvent être placés sur cet équilibreur de charge.

Les services créés dans des espaces de noms qui correspondent au sélecteur peuvent être placés sur cet équilibreur de charge. Mettre en forme comme paires clé=valeur séparées par des virgules.

Paramètres globaux
--debug

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

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

Affichez ce message d’aide et quittez-le.

--only-show-errors

Affiche uniquement les erreurs, en supprimant les avertissements.

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

Format de sortie.

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

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

--subscription

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

--verbose

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

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