Compartilhar via

az aks loadbalancer

Note

Essa referência faz parte da extensão aks-preview para a CLI do Azure (versão 2.73.0 ou superior). A extensão instalará automaticamente na primeira vez que você executar um comando az aks loadbalancer . Saiba mais sobre extensões.

Comandos para gerenciar as configurações do balanceador de carga em um cluster do Kubernetes gerenciado.

Esses comandos habilitam o recurso de vários balanceadores de carga padrão para clusters do Serviço de Kubernetes do Azure.

Comandos

Nome Description Tipo Status
az aks loadbalancer add

Adicione uma configuração de balanceador de carga a um cluster do Kubernetes gerenciado.

 Extension GA
az aks loadbalancer delete

Exclua uma configuração de balanceador de carga de um cluster kubernetes gerenciado.

 Extension GA
az aks loadbalancer list

Liste todas as configurações do balanceador de carga em um cluster do Kubernetes gerenciado.

 Extension GA
az aks loadbalancer rebalance-nodes

Reequilibrar nós entre balanceadores de carga específicos.

 Extension GA
az aks loadbalancer show

Mostrar detalhes de uma configuração específica do balanceador de carga em um cluster do Kubernetes gerenciado.

 Extension GA
az aks loadbalancer update

Atualize uma configuração de balanceador de carga em um cluster kubernetes gerenciado.

 Extension GA

az aks loadbalancer add

Adicione uma configuração de balanceador de carga a um cluster do Kubernetes gerenciado.

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]

Exemplos

Adicionar uma configuração de balanceador de carga com um pool de agente primário específico

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

Adicionar uma configuração de balanceador de carga com o seletor de rótulo de serviço

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

Adicionar uma configuração de balanceador de carga que não coloca serviços automaticamente

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

Adicionar uma configuração de balanceador de carga com cabeçalhos personalizados da API do AKS

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

Parâmetros Exigidos

--cluster-name

Nome do cluster gerenciado.

--name -n

Nome da configuração do balanceador de carga.

Nome do balanceador de carga usado para identificação. Deve haver uma configuração chamada "kubernetes" no cluster.

--primary-agent-pool-name -p

Nome do pool de agentes primário para esse balanceador de carga.

Campo necessário. Um valor de cadeia de caracteres que deve especificar a ID de um pool de agentes existente. Todos os nós no pool especificado sempre serão adicionados a esse balanceador de carga.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--aks-custom-headers

Enviar cabeçalhos personalizados para a API do AKS.

Quando especificado, o formato deve ser Key1=Value1,Key2=Value2.

--allow-service-placement -a

Se os serviços serão colocados automaticamente no balanceador de carga.

Se não for fornecido, o valor padrão será true. Se definido como false manualmente, o balanceador de carga externo e interno não será selecionado para serviços, a menos que eles o direcionem explicitamente.

Propriedade Valor
Valores aceitos: false, true
--node-selector -d

Seletor de rótulo de nó para nós que podem ser membros desse balanceador de carga.

Os nós que corresponderem a esse seletor serão possíveis membros desse balanceador de carga. Formatar como pares key=value separados por vírgulas.

--service-label-selector -l

Seletor de rótulo para serviços que podem ser colocados neste balanceador de carga.

Somente os serviços que correspondem a esse seletor podem ser colocados nesse balanceador de carga. Formate como pares chave=valor separados por vírgulas ou expressões como "key In value1,value2".

--service-namespace-selector -s

Seletor de rótulo de namespace para serviços que podem ser colocados neste balanceador de carga.

Os serviços criados em namespaces que correspondem ao seletor podem ser colocados nesse balanceador de carga. Formatar como pares key=value separados por vírgulas.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az aks loadbalancer delete

Exclua uma configuração de balanceador de carga de um cluster kubernetes gerenciado.

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

Exemplos

Excluir uma configuração do balanceador de carga

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

Parâmetros Exigidos

--cluster-name

Nome do cluster gerenciado.

--name -n

Nome da configuração do balanceador de carga a ser excluída.

O balanceador de carga "kubernetes" não pode ser excluído, pois é necessário para a operação de cluster.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az aks loadbalancer list

Liste todas as configurações do balanceador de carga em um cluster do Kubernetes gerenciado.

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

Exemplos

Listar todas as configurações do balanceador de carga

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

Listar todas as configurações do balanceador de carga no formato de tabela

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

Parâmetros Exigidos

--cluster-name

Nome do cluster gerenciado.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az aks loadbalancer rebalance-nodes

Reequilibrar nós entre balanceadores de carga específicos.

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

Parâmetros Exigidos

--name -n

Nome do cluster gerenciado.

--resource-group -g

Nome do grupo de recursos.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

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

Lista separada por espaço de nomes de balanceador de carga para reequilibrar. Se não for especificado, todos os balanceadores de carga serão rebalanceados.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az aks loadbalancer show

Mostrar detalhes de uma configuração específica do balanceador de carga em um cluster do Kubernetes gerenciado.

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

Exemplos

Mostrar detalhes de uma configuração específica do balanceador de carga

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

Mostrar detalhes de uma configuração de balanceador de carga no formato de tabela

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

Parâmetros Exigidos

--cluster-name

Nome do cluster gerenciado.

--name -n

Nome da configuração do balanceador de carga a ser mostrada.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az aks loadbalancer update

Atualize uma configuração de balanceador de carga em um cluster kubernetes gerenciado.

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]

Exemplos

Atualizar o pool de agentes primários de uma configuração de balanceador de carga

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

Atualizar uma configuração do balanceador de carga para desabilitar o posicionamento automático do serviço

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

Atualizar uma configuração do balanceador de carga com o novo seletor de serviço

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

Atualizar uma configuração de balanceador de carga com cabeçalhos personalizados da API do AKS

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

Parâmetros Exigidos

--cluster-name

Nome do cluster gerenciado.

--name -n

Nome da configuração do balanceador de carga a ser atualizada.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--aks-custom-headers

Enviar cabeçalhos personalizados para a API do AKS.

Quando especificado, o formato deve ser Key1=Value1,Key2=Value2.

--allow-service-placement -a

Se os serviços serão colocados automaticamente no balanceador de carga.

Se definido como false, o balanceador de carga externo e interno não será selecionado para serviços, a menos que eles o direcionem explicitamente.

Propriedade Valor
Valores aceitos: false, true
--node-selector -d

Seletor de rótulo de nó para nós que podem ser membros desse balanceador de carga.

Os nós que corresponderem a esse seletor serão possíveis membros desse balanceador de carga. Formatar como pares key=value separados por vírgulas.

--primary-agent-pool-name -p

Nome do pool de agentes primário para esse balanceador de carga.

Um valor de cadeia de caracteres que deve especificar a ID de um pool de agentes existente. Todos os nós no pool especificado sempre serão adicionados a esse balanceador de carga.

--service-label-selector -l

Seletor de rótulo para serviços que podem ser colocados neste balanceador de carga.

Somente os serviços que correspondem a esse seletor podem ser colocados nesse balanceador de carga. Formate como pares chave=valor separados por vírgulas ou expressões como "key In value1,value2".

--service-namespace-selector -s

Seletor de rótulo de namespace para serviços que podem ser colocados neste balanceador de carga.

Os serviços criados em namespaces que correspondem ao seletor podem ser colocados nesse balanceador de carga. Formatar como pares key=value separados por vírgulas.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False