Partilhar 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 será instalada automaticamente na primeira vez que você executar um comando az aks loadbalancer . Saiba mais sobre extensões.

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

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

Comandos

Nome Descrição Tipo Estado
az aks loadbalancer add

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

 Extension disponibilidade geral
az aks loadbalancer delete

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

 Extension disponibilidade geral
az aks loadbalancer list

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

 Extension disponibilidade geral
az aks loadbalancer rebalance-nodes

Reequilibre nós em balanceadores de carga específicos.

 Extension disponibilidade geral
az aks loadbalancer show

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

 Extension disponibilidade geral
az aks loadbalancer update

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

 Extension disponibilidade geral

az aks loadbalancer add

Adicione uma configuração de balanceador de carga a um cluster 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 agentes primários 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 seletor de etiqueta 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 coloque 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 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 Obrigatórios

--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ários para este balanceador de carga.

Campo obrigatório. Um valor de cadeia de caracteres que deve especificar a ID de um pool de agentes existente. Todos os nós no pool determinado serão sempre 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 parâmetros seguintes são opcionais, mas dependendo do contexto, podem ser necessários um ou mais para que o comando seja executado com sucesso.

--aks-custom-headers

Envie 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 devem ser 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 aceites: 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 este seletor serão possíveis membros deste balanceador de carga. Formate como pares chave=valor separados por vírgula.

--service-label-selector -l

Seletor de etiquetas para serviços que podem ser colocados neste balanceador de carga.

Apenas os serviços que correspondem a este seletor podem ser colocados neste balanceador de carga. Formate como pares key=value 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 nesse balanceador de carga.

Os serviços criados em namespaces que correspondem ao seletor podem ser colocados nesse balanceador de carga. Formate como pares chave=valor separados por vírgula.

Parâmetros globais
--debug

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

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

Mostrar esta mensagem de ajuda e sair.

--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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

Aumente a verbosidade do registro. 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 Obrigatórios

--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 do 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 do log para mostrar todos os logs de depuração.

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

Mostrar esta mensagem de ajuda e sair.

--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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

Aumente a verbosidade do registro. 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 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 em formato de tabela

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

Parâmetros Obrigatórios

--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 do log para mostrar todos os logs de depuração.

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

Mostrar esta mensagem de ajuda e sair.

--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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

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

Propriedade Valor
Valor padrão: False

az aks loadbalancer rebalance-nodes

Reequilibre nós em balanceadores de carga específicos.

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

Parâmetros Obrigatórios

--name -n

Nome do cluster gerenciado.

--resource-group -g

Nome do grupo de recursos.

Parâmetros Opcionais

Os parâmetros seguintes são opcionais, mas dependendo do contexto, podem ser necessários um ou mais para que o comando seja executado com sucesso.

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

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

Parâmetros globais
--debug

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

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

Mostrar esta mensagem de ajuda e sair.

--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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

Aumente a verbosidade do registro. 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 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 em formato de tabela

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

Parâmetros Obrigatórios

--cluster-name

Nome do cluster gerenciado.

--name -n

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

--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 do log para mostrar todos os logs de depuração.

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

Mostrar esta mensagem de ajuda e sair.

--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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

Aumente a verbosidade do registro. 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 desativar 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 de 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 AKS

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

Parâmetros Obrigatórios

--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 parâmetros seguintes são opcionais, mas dependendo do contexto, podem ser necessários um ou mais para que o comando seja executado com sucesso.

--aks-custom-headers

Envie 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 devem ser 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 aceites: 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 este seletor serão possíveis membros deste balanceador de carga. Formate como pares chave=valor separados por vírgula.

--primary-agent-pool-name -p

Nome do pool de agentes primários para este 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 determinado serão sempre adicionados a esse balanceador de carga.

--service-label-selector -l

Seletor de etiquetas para serviços que podem ser colocados neste balanceador de carga.

Apenas os serviços que correspondem a este seletor podem ser colocados neste balanceador de carga. Formate como pares key=value 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 nesse balanceador de carga.

Os serviços criados em namespaces que correspondem ao seletor podem ser colocados nesse balanceador de carga. Formate como pares chave=valor separados por vírgula.

Parâmetros globais
--debug

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

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

Mostrar esta mensagem de ajuda e sair.

--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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

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

Propriedade Valor
Valor padrão: False