Share via


az networkcloud kubernetescluster agentpool

Nota

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 comandos 'az networkcloud' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Gerencie o pool de agentes do cluster Kubernetes.

Comandos

Name Description Tipo Estado
az networkcloud kubernetescluster agentpool create

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

Extensão Pré-visualizar
az networkcloud kubernetescluster agentpool delete

Exclua o pool de agentes de cluster do Kubernetes fornecido.

Extensão Pré-visualizar
az networkcloud kubernetescluster agentpool list

Listar pools de agentes para o cluster Kubernetes fornecido.

Extensão Pré-visualizar
az networkcloud kubernetescluster agentpool show

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

Extensão Pré-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 atualizações de propriedades e tags podem ser feitas de forma independente.

Extensão Pré-visualizar
az networkcloud kubernetescluster agentpool wait

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

Extensão Pré-visualizar

az networkcloud kubernetescluster agentpool create

Pré-visualizar

O grupo de comandos 'az networkcloud' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: 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 Obrigatórios

--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, seja como um pool de sistema ou um pool de usuários. Os pools de sistemas 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 dos usuários. Cada cluster Kubernetes deve conter pelo menos um pool de nós do sistema com pelo menos um nó.

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

o 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 neste pool de agentes. Suporta sintaxe taquigráfica, json-file e yaml-file. Tente "??" para mostrar mais.

--attached-network-configuration

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

--availability-zones

A lista de zonas de disponibilidade do cluster 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. Suporta sintaxe taquigráfica, json-file e yaml-file. Tente "??" para mostrar mais.

--extended-location

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

--generate-ssh-keys

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

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

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

--location -l

A localização geográfica onde o recurso reside Quando não especificada, a localização do grupo de recursos será usada.

--no-wait

Não espere que a operação de longa duração termine.

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

A lista de caminhos separados por espaço para ssh chaves públicas. 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. Suporta sintaxe taquigráfica, json-file e yaml-file. Tente "??" para mostrar mais.

--ssh-key-values

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

--tags

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

--taints

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

--upgrade-settings

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

Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

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

--verbose

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

az networkcloud kubernetescluster agentpool delete

Pré-visualizar

O grupo de comandos 'az networkcloud' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: 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

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

--kubernetes-cluster-name

O nome do cluster Kubernetes.

--no-wait

Não espere que a operação de longa duração termine.

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

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

--subscription

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

--yes -y

Não solicite confirmação.

valor predefinido: False
Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

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

--verbose

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

az networkcloud kubernetescluster agentpool list

Pré-visualizar

O grupo de comandos 'az networkcloud' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: 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 Kubernetes

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

Parâmetros Obrigatórios

--kubernetes-cluster-name

O nome do cluster Kubernetes.

--resource-group -g

o 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 por onde começar a paginar. Este é o valor de token de uma resposta truncada anteriormente.

Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

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

--verbose

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

az networkcloud kubernetescluster agentpool show

Pré-visualizar

O grupo de comandos 'az networkcloud' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: 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

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

--kubernetes-cluster-name

O nome do cluster Kubernetes.

--resource-group -g

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

--subscription

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

Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

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

--verbose

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

az networkcloud kubernetescluster agentpool update

Pré-visualizar

O grupo de comandos 'az networkcloud' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: 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 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 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 arquivos de chave pública e privada SSH, se faltar. As chaves serão armazenadas em '~/.ssh'.

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

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

--kubernetes-cluster-name

O nome do cluster Kubernetes.

--no-wait

Não espere que a operação de longa duração termine.

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

o 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 ssh chaves públicas. 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. Suporta sintaxe taquigráfica, json-file e yaml-file. Tente "??" para mostrar mais.

--ssh-key-values

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

--subscription

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

--tags

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

--upgrade-settings

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

Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

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

--verbose

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

az networkcloud kubernetescluster agentpool wait

Pré-visualizar

O grupo de comandos 'az networkcloud' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: 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é ser criado com 'provisioningState' em 'Succeeded'.

valor predefinido: 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 predefinido: False
--exists

Aguarde até que o recurso exista.

valor predefinido: False
--ids

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

--interval

Intervalo de sondagem em segundos.

valor predefinido: 30
--kubernetes-cluster-name

O nome do cluster Kubernetes.

--resource-group -g

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

--subscription

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

--timeout

Espera máxima em segundos.

valor predefinido: 3600
--updated

Aguarde até ser atualizado com provisioningState em 'Succeeded'.

valor predefinido: False
Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

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

--verbose

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