Compartilhar via

az networkcloud kubernetescluster agentpool

  • Versão Prévia
  • Referência

Observação

Essa referência faz parte da extensão networkcloud para a CLI do Azure (versão 2.51.0 ou superior). A extensão será instalada automaticamente na primeira vez que você executar um comando az networkcloud kubernetescluster agentpool . Saiba mais sobre extensões.

O grupo de comando 'az networkcloud' está em pré-visualização e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Gerenciar o pool de agentes do cluster Kubernetes.

Comandos

Nome Description Tipo Status
az networkcloud kubernetescluster agentpool create

Crie um novo pool de agentes de cluster do Kubernetes ou atualize as propriedades do existente.

 Extensão Visualizar
az networkcloud kubernetescluster agentpool delete

Exclua o pool de agentes de cluster do Kubernetes fornecido.

 Extensão Visualizar
az networkcloud kubernetescluster agentpool list

Listar pools de agentes para o cluster Kubernetes fornecido.

 Extensão Visualizar
az networkcloud kubernetescluster agentpool show

Obtenha propriedades do pool de agentes de cluster do Kubernetes fornecido.

 Extensão Visualizar
az networkcloud kubernetescluster agentpool update

Atualize as propriedades do pool de agentes de cluster do Kubernetes fornecido ou atualize as marcas associadas ao pool de agentes de cluster do Kubernetes. As atualizações de propriedades e tags podem ser feitas de forma independente.

 Extensão Visualizar
az networkcloud kubernetescluster agentpool wait

Coloque a CLI em um estado de espera até que uma condição seja atendida.

 Extensão Visualizar

az networkcloud kubernetescluster agentpool create

Versão Prévia

O grupo de comando 'az networkcloud' está em pré-visualização e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Crie um novo pool de agentes de cluster do Kubernetes ou atualize as propriedades do existente.

az networkcloud kubernetescluster agentpool create --agent-pool-name
                                                   --count
                                                   --kubernetes-cluster-name
                                                   --mode {NotApplicable, System, User}
                                                   --resource-group
                                                   --vm-sku-name
                                                   [--admin-username]
                                                   [--agent-options]
                                                   [--attached-network-configuration]
                                                   [--availability-zones]
                                                   [--extended-location]
                                                   [--generate-ssh-keys {0, 1, f, false, n, no, t, true, y, yes}]
                                                   [--labels]
                                                   [--location]
                                                   [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                                   [--ssh-dest-key-path]
                                                   [--ssh-key-values]
                                                   [--tags]
                                                   [--taints]
                                                   [--upgrade-settings]

Exemplos

Criar ou atualizar o pool de agentes do cluster do Kubernetes

az networkcloud kubernetescluster agentpool create --name "poolName" --kubernetes-cluster-name "kubernetesClusterName" --resource-group "resourceGroupName" --admin-username "azureuser" --ssh-key-values 'ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABgt5SjWU= admin@vm' --count 3 --mode "System" --vm-sku-name "NC-XXXXX" --agent-options hugepages-count=96 hugepages-size="1G" --attached-network-configuration l2-networks="[{networkId:'/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/l2Networks/l2NetworkName',pluginType:'DPDK'}]" l3-networks="[{networkId:'/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/l3Networks/l3NetworkName,pluginType:'SRIOV',ipamEnabled:'False'}]" trunked-networks="[{networkId:'/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/trunkedNetworks/trunkedNetworkName',pluginType:'MACVLAN'}]" --labels="[{key:'kubernetes.label',value:'true'}]" --taints="[{key:'kubernetes.taint',value:'true'}]" --upgrade-settings max-surge="1" --availability-zones="['zone1','zone2']"

Parâmetros Exigidos

--agent-pool-name --name -n

O nome do pool de agentes de cluster do Kubernetes.

--count

O número de máquinas virtuais que usam essa configuração.

--kubernetes-cluster-name

O nome do cluster Kubernetes.

--mode

A seleção de como esse pool de agentes é utilizado, como um pool de sistema ou um pool de usuários. Os pools de sistema executam os recursos e serviços críticos para o Cluster Kubernetes, enquanto os pools de usuários são dedicados às cargas de trabalho do usuário. Cada cluster do Kubernetes deve conter pelo menos um pool de nós do sistema com pelo menos um nó.

valores aceitos: NotApplicable, System, User
--resource-group -g

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

--vm-sku-name

O nome da SKU da VM que determina o tamanho dos recursos alocados para VMs de nó.

Parâmetros Opcionais

--admin-username

O nome de usuário do administrador que será aplicado aos sistemas operacionais que executam nós do Kubernetes. Se não for fornecido, um nome de usuário será escolhido pelo serviço.

--agent-options

As configurações que serão aplicadas a cada agente nesse pool de agentes. Suporte taquigráfico-sintaxe, json-file e yaml-file. Tente "??" para mostrar mais.

--attached-network-configuration

A configuração das redes que estão sendo conectadas ao pool de agentes para uso pelas cargas de trabalho executadas nesse cluster do Kubernetes. Essas redes são adicionais às redes conectadas na configuração de rede conectada ao cluster Kubernetes. Suporte taquigráfico-sintaxe, json-file e yaml-file. Tente "??" para mostrar mais.

--availability-zones

A lista de zonas de disponibilidade do cluster de Nuvem de Rede usado para o provisionamento de nós nesse pool de agentes. Se não for especificado, todas as zonas de disponibilidade serão usadas. Suporte taquigráfico-sintaxe, json-file e yaml-file. Tente "??" para mostrar mais.

--extended-location

O local estendido do cluster associado ao recurso. Suporte taquigráfico-sintaxe, json-file e yaml-file. Tente "??" para mostrar mais.

--generate-ssh-keys

Gere os arquivos de chave pública e privada de SSH, se estiverem ausentes. As chaves serão armazenadas em '~/.ssh'.

valores aceitos: 0, 1, f, false, n, no, t, true, y, yes
--labels

Os rótulos aplicados aos nós neste pool de agentes. Suporte taquigráfico-sintaxe, json-file e yaml-file. Tente "??" para mostrar mais.

--location -l

A localização geográfica onde o recurso reside Quando não especificado, o local do grupo de recursos será usado.

--no-wait

Não aguarde a conclusão da operação de execução longa.

valores aceitos: 0, 1, f, false, n, no, t, true, y, yes
--ssh-dest-key-path

A lista de caminhos separados por espaço para chaves públicas ssh. Um caminho de arquivo pode ser fornecido ou um diretório. Se um diretório for fornecido, tentará carregar todas as chaves públicas (.pub) encontradas. Suporte taquigráfico-sintaxe, json-file e yaml-file. Tente "??" para mostrar mais.

--ssh-key-values

A lista de chaves públicas SSH separadas por espaço. Suporte taquigráfico-sintaxe, json-file e yaml-file. Tente "??" para mostrar mais.

--tags

Tags de recursos. Suporte taquigráfico-sintaxe, json-file e yaml-file. Tente "??" para mostrar mais.

--taints

As manchas aplicadas aos nós neste pool de agentes. Suporte taquigráfico-sintaxe, json-file e yaml-file. Tente "??" para mostrar mais.

--upgrade-settings

A configuração do pool de agentes. Suporte taquigráfico-sintaxe, json-file e yaml-file. Tente "??" para mostrar mais.

Parâmetros Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter 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 o detalhamento do log. Use --debug para logs de depuração completos.

az networkcloud kubernetescluster agentpool delete

Versão Prévia

O grupo de comando 'az networkcloud' está em pré-visualização e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Exclua o pool de agentes de cluster do Kubernetes fornecido.

az networkcloud kubernetescluster agentpool delete [--agent-pool-name]
                                                   [--ids]
                                                   [--kubernetes-cluster-name]
                                                   [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                                   [--resource-group]
                                                   [--subscription]
                                                   [--yes]

Exemplos

Excluir pool de agentes do cluster do Kubernetes

az networkcloud kubernetescluster agentpool delete --name "poolName" --kubernetes-cluster-name "kubernetesClusterName" --resource-group "resourceGroupName"

Parâmetros Opcionais

--agent-pool-name --name -n

O nome do pool de agentes de cluster do Kubernetes.

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'Resource Id'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--kubernetes-cluster-name

O nome do cluster Kubernetes.

--no-wait

Não aguarde a conclusão da operação de execução longa.

valores aceitos: 0, 1, f, false, n, no, t, true, y, yes
--resource-group -g

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

--subscription

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

--yes -y

Não solicite confirmação.

valor padrão: False
Parâmetros Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter 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 o detalhamento do log. Use --debug para logs de depuração completos.

az networkcloud kubernetescluster agentpool list

Versão Prévia

O grupo de comando 'az networkcloud' está em pré-visualização e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Listar pools de agentes para o cluster Kubernetes fornecido.

az networkcloud kubernetescluster agentpool list --kubernetes-cluster-name
                                                 --resource-group
                                                 [--max-items]
                                                 [--next-token]

Exemplos

Listar pools de agentes do cluster do Kubernetes

az networkcloud kubernetescluster agentpool list --kubernetes-cluster-name "kubernetesClusterName" --resource-group "resourceGroupName"

Parâmetros Exigidos

--kubernetes-cluster-name

O nome do cluster Kubernetes.

--resource-group -g

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

Parâmetros Opcionais

--max-items

Número total de itens a serem retornados na saída do comando. Se o número total de itens disponíveis for maior do que o valor especificado, um token será fornecido na saída do comando. Para retomar a paginação, forneça o valor do token no --next-token argumento de um comando subsequente.

--next-token

Token para especificar onde iniciar a paginação. Esse é o valor de token de uma resposta truncada anteriormente.

Parâmetros Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter 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 o detalhamento do log. Use --debug para logs de depuração completos.

az networkcloud kubernetescluster agentpool show

Versão Prévia

O grupo de comando 'az networkcloud' está em pré-visualização e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Obtenha propriedades do pool de agentes de cluster do Kubernetes fornecido.

az networkcloud kubernetescluster agentpool show [--agent-pool-name]
                                                 [--ids]
                                                 [--kubernetes-cluster-name]
                                                 [--resource-group]
                                                 [--subscription]

Exemplos

Obter pool de agentes do cluster do Kubernetes

az networkcloud kubernetescluster agentpool show --name "poolName" --kubernetes-cluster-name "kubernetesClusterName" --resource-group "resourceGroupName"

Parâmetros Opcionais

--agent-pool-name --name -n

O nome do pool de agentes de cluster do Kubernetes.

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'Resource Id'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--kubernetes-cluster-name

O nome do cluster Kubernetes.

--resource-group -g

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

--subscription

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

Parâmetros Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter 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 o detalhamento do log. Use --debug para logs de depuração completos.

az networkcloud kubernetescluster agentpool update

Versão Prévia

O grupo de comando 'az networkcloud' está em pré-visualização e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Atualize as propriedades do pool de agentes de cluster do Kubernetes fornecido ou atualize as marcas associadas ao pool de agentes de cluster do Kubernetes. As atualizações de propriedades e tags podem ser feitas de forma independente.

az networkcloud kubernetescluster agentpool update [--agent-pool-name]
                                                   [--count]
                                                   [--generate-ssh-keys {0, 1, f, false, n, no, t, true, y, yes}]
                                                   [--ids]
                                                   [--kubernetes-cluster-name]
                                                   [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                                   [--resource-group]
                                                   [--ssh-dest-key-path]
                                                   [--ssh-key-values]
                                                   [--subscription]
                                                   [--tags]
                                                   [--upgrade-settings]

Exemplos

Pool de agentes de patch do cluster do Kubernetes

az networkcloud kubernetescluster agentpool update --name "poolName" --kubernetes-cluster-name "kubernetesClusterName" --resource-group "resourceGroupName" --count 3 --upgrade-settings max-surge="1"

Atualizar credenciais de administrador do pool do Agente

az networkcloud kubernetescluster agentpool update --name "poolName" --kubernetes-cluster-name "kubernetesClusterName" --resource-group "resourceGroupName" --ssh-key-values 'ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABgt5SjWU= admin@vm'

Parâmetros Opcionais

--agent-pool-name --name -n

O nome do pool de agentes de cluster do Kubernetes.

--count

O número de máquinas virtuais que usam essa configuração.

--generate-ssh-keys

Gere os arquivos de chave pública e privada de SSH, se estiverem ausentes. As chaves serão armazenadas em '~/.ssh'.

valores aceitos: 0, 1, f, false, n, no, t, true, y, yes
--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'Resource Id'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--kubernetes-cluster-name

O nome do cluster Kubernetes.

--no-wait

Não aguarde a conclusão da operação de execução longa.

valores aceitos: 0, 1, f, false, n, no, t, true, y, yes
--resource-group -g

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

--ssh-dest-key-path

A lista de caminhos separados por espaço para chaves públicas ssh. Um caminho de arquivo pode ser fornecido ou um diretório. Se um diretório for fornecido, tentará carregar todas as chaves públicas (.pub) encontradas. Suporte taquigráfico-sintaxe, json-file e yaml-file. Tente "??" para mostrar mais.

--ssh-key-values

A lista de chaves públicas SSH separadas por espaço. Suporte taquigráfico-sintaxe, json-file e yaml-file. Tente "??" para mostrar mais.

--subscription

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

--tags

As marcas de recurso do Azure que substituirão as existentes. Suporte taquigráfico-sintaxe, json-file e yaml-file. Tente "??" para mostrar mais.

--upgrade-settings

A configuração do pool de agentes. Suporte taquigráfico-sintaxe, json-file e yaml-file. Tente "??" para mostrar mais.

Parâmetros Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter 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 o detalhamento do log. Use --debug para logs de depuração completos.

az networkcloud kubernetescluster agentpool wait

Versão Prévia

O grupo de comando 'az networkcloud' está em pré-visualização e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Coloque a CLI em um estado de espera até que uma condição seja atendida.

az networkcloud kubernetescluster agentpool wait [--agent-pool-name]
                                                 [--created]
                                                 [--custom]
                                                 [--deleted]
                                                 [--exists]
                                                 [--ids]
                                                 [--interval]
                                                 [--kubernetes-cluster-name]
                                                 [--resource-group]
                                                 [--subscription]
                                                 [--timeout]
                                                 [--updated]

Parâmetros Opcionais

--agent-pool-name --name -n

O nome do pool de agentes de cluster do Kubernetes.

--created

Aguarde até criar com 'provisioningState' em 'Succeeded'.

valor padrão: False
--custom

Aguarde até que a condição satisfaça uma consulta JMESPath personalizada. Por exemplo, provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Aguarde até ser excluído.

valor padrão: False
--exists

Aguarde até que o recurso exista.

valor padrão: False
--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'Resource Id'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--interval

Intervalo de sondagem em segundos.

valor padrão: 30
--kubernetes-cluster-name

O nome do cluster Kubernetes.

--resource-group -g

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

--subscription

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

--timeout

Espera máxima em segundos.

valor padrão: 3600
--updated

Aguarde até que seja atualizado com provisioningState em 'Succeeded'.

valor padrão: False
Parâmetros Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter 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 o detalhamento do log. Use --debug para logs de depuração completos.