Compartilhar via

az networkcloud kubernetescluster agentpool

  • Referência

Observação

Essa referência faz parte da extensão networkcloud para a CLI do Azure (versão 2.67.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.

Gerencie o pool de agentes do cluster do 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 do Kubernetes fornecido.

 Extensão Visualizar
az networkcloud kubernetescluster agentpool show

Obtenha as 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 tags associadas ao pool de agentes de cluster do Kubernetes. As propriedades e as atualizações de marca 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 GA

az networkcloud kubernetescluster agentpool create

Versão Prévia

Esse comando está em versão prévia 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
                                                   --kc-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.

--kc-name --kubernetes-cluster-name

O nome do cluster do Kubernetes.

--mode

A seleção de como esse pool de agentes é utilizado, seja como um pool de sistemas ou um pool de usuários. Os pools de sistemas executam os recursos e serviços críticos para o cluster do 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 do 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 neste pool de agentes. Suporte a sintaxe abreviada, json-file e yaml-file. Tente "??" para mostrar mais.

--attached-network-configuration

A configuração das redes que estão sendo anexadas 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 do Kubernetes. Suporte a sintaxe abreviada, json-file e yaml-file. Tente "??" para mostrar mais.

--availability-zones

A lista de zonas de disponibilidade do cluster do Network Cloud usado para o provisionamento de nós neste pool de agentes. Se não for especificado, todas as zonas de disponibilidade serão usadas. Suporte a sintaxe abreviada, json-file e yaml-file. Tente "??" para mostrar mais.

--extended-location

O local estendido do cluster associado ao recurso. Suporte a sintaxe abreviada, 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 a sintaxe abreviada, 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, tentaremos carregar todas as chaves públicas (.pub) encontradas. Suporte a sintaxe abreviada, json-file e yaml-file. Tente "??" para mostrar mais.

--ssh-key-values

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

--tags

Tags de recursos. Suporte a sintaxe abreviada, json-file e yaml-file. Tente "??" para mostrar mais.

--taints

Os taints aplicados aos nós neste pool de agentes. Suporte a sintaxe abreviada, json-file e yaml-file. Tente "??" para mostrar mais.

--upgrade-settings

A configuração do pool de agentes. Suporte a sintaxe abreviada, 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

Esse comando está em versão prévia 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]
                                                   [--kc-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 uma ID de recurso completa que contém todas as informações de argumentos de "ID do recurso". Você deve fornecer --ids ou outros argumentos de "ID do recurso".

--kc-name --kubernetes-cluster-name

O nome do cluster do 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

Esse comando está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Listar pools de agentes para o cluster do Kubernetes fornecido.

az networkcloud kubernetescluster agentpool list --kc-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

--kc-name --kubernetes-cluster-name

O nome do cluster do 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 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 por onde começar a paginar. Esse é o valor do 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

Esse comando está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

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

az networkcloud kubernetescluster agentpool show [--agent-pool-name]
                                                 [--ids]
                                                 [--kc-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 uma ID de recurso completa que contém todas as informações de argumentos de "ID do recurso". Você deve fornecer --ids ou outros argumentos de "ID do recurso".

--kc-name --kubernetes-cluster-name

O nome do cluster do 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

Esse comando está em versão prévia 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 tags associadas ao pool de agentes de cluster do Kubernetes. As propriedades e as atualizações de marca 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]
                                                   [--kc-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 de agentes

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 uma ID de recurso completa que contém todas as informações de argumentos de "ID do recurso". Você deve fornecer --ids ou outros argumentos de "ID do recurso".

--kc-name --kubernetes-cluster-name

O nome do cluster do 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, tentaremos carregar todas as chaves públicas (.pub) encontradas. Suporte a sintaxe abreviada, json-file e yaml-file. Tente "??" para mostrar mais.

--ssh-key-values

A lista de chaves públicas SSH separadas por espaço. Suporte a sintaxe abreviada, 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 a sintaxe abreviada, json-file e yaml-file. Tente "??" para mostrar mais.

--upgrade-settings

A configuração do pool de agentes. Suporte a sintaxe abreviada, 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

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]
                                                 [--kc-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é ser criado 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 uma ID de recurso completa que contém todas as informações de argumentos de "ID do recurso". Você deve fornecer --ids ou outros argumentos de "ID do recurso".

--interval

Intervalo de sondagem em segundos.

Valor padrão: 30
--kc-name --kubernetes-cluster-name

O nome do cluster do 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é ser 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.