az networkcloud kubernetescluster
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 . Saiba mais sobre extensões.
Gerenciar cluster do Kubernetes.
Comandos
Nome | Description | Tipo | Status |
---|---|---|---|
az networkcloud kubernetescluster agentpool |
Gerencie o pool de agentes do cluster do Kubernetes. |
Extensão | GA |
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 create |
Crie um novo cluster do Kubernetes ou atualize as propriedades do existente. |
Extensão | Visualizar |
az networkcloud kubernetescluster delete |
Exclua o cluster do Kubernetes fornecido. |
Extensão | Visualizar |
az networkcloud kubernetescluster feature |
Gerencie o recurso do cluster do Kubernetes. |
Extensão | GA |
az networkcloud kubernetescluster feature create |
Crie um novo recurso de cluster do Kubernetes ou atualize as propriedades do recurso de cluster do Kubernetes, se ele existir. |
Extensão | Visualizar |
az networkcloud kubernetescluster feature delete |
Exclua o recurso de cluster do Kubernetes fornecido. |
Extensão | Visualizar |
az networkcloud kubernetescluster feature list |
Liste uma lista de recursos para o cluster do Kubernetes fornecido. |
Extensão | Visualizar |
az networkcloud kubernetescluster feature show |
Obtenha as propriedades do recurso de cluster do Kubernetes fornecido. |
Extensão | Visualizar |
az networkcloud kubernetescluster feature update |
Atualize as propriedades do recurso de cluster do Kubernetes fornecido. |
Extensão | Visualizar |
az networkcloud kubernetescluster feature wait |
Coloque a CLI em um estado de espera até que uma condição seja atendida. |
Extensão | GA |
az networkcloud kubernetescluster list |
Liste os clusters do Kubernetes na assinatura fornecida. |
Extensão | Visualizar |
az networkcloud kubernetescluster restart-node |
Reinicie um nó de destino de um cluster do Kubernetes. |
Extensão | Visualizar |
az networkcloud kubernetescluster show |
Obtenha as propriedades do cluster do Kubernetes fornecido. |
Extensão | Visualizar |
az networkcloud kubernetescluster update |
Atualize as propriedades do cluster do Kubernetes fornecido ou atualize as tags associadas ao cluster do Kubernetes. As propriedades e as atualizações de marca podem ser feitas de forma independente. |
Extensão | Visualizar |
az networkcloud kubernetescluster wait |
Coloque a CLI em um estado de espera até que uma condição seja atendida. |
Extensão | GA |
az networkcloud kubernetescluster create
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 cluster do Kubernetes ou atualize as propriedades do existente.
az networkcloud kubernetescluster create --control-plane-node-configuration
--extended-location
--initial-agent-pool-configurations
--kubernetes-cluster-name
--kubernetes-version
--network-configuration
--resource-group
[--aad-configuration]
[--admin-username]
[--generate-ssh-keys {0, 1, f, false, n, no, t, true, y, yes}]
[--location]
[--managed-resource-group-configuration]
[--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
[--ssh-dest-key-path]
[--ssh-key-values]
[--tags]
Exemplos
Criar ou atualizar o cluster do Kubernetes
az networkcloud kubernetescluster create --name "kubernetesClusterName" --resource-group "resourceGroupName" --location "location" --kubernetes-version "1.XX.Y" --extended-location name="/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.ExtendedLocation/customLocations/clusterExtendedLocationName" type=CustomLocation --aad-configuration admin-group-object-ids=["f110271b-XXXX-4163-9b99-214d91660f0e"] --admin-username "azureuser" --ssh-key-values "ssh-rsa AAAAB3NzaC1yc2EAAAADAQAt5SjWU= admin@vm" --initial-agent-pool-configurations "[{count:1,mode:'System',name:'systemPool-1',vmSkuName:'NC-XXXXX',agentOptions:{hugepagesCount:96,hugepagesSize:1G},upgradeSettings:{maxSurge:'10%'},adminUsername:'azureuser',ssh-key-values:['ssh-rsa AAAAB3NzaC1yc2EAAAADAQAt5SjWU= admin@vm']}]" --control-plane-node-configuration count=1 vmSkuName='NC-YYYYY' adminUsername='azureuser' ssh-key-values="['ssh-rsa AAAAB3NzaC1yc2EAAAADAQAt5SjWU= admin@vm']" --network-configuration cloud-services-network-id="/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/cloudServicesNetworks/cloudServicesNetworkName" cni-network-id="/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/l3Networks/l3NetworkName" pod-cidrs=["10.244.0.0/16"] service-cidrs=["10.96.0.0/16"] dns-service-ip="10.96.0.10" attached-network-configuration.l2-networks="[{networkId:'/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/l2Networks/l2NetworkName',pluginType:'DPDK'}]" attached-network-configuration.l3-networks="[{networkId:'/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/l3Networks/l3NetworkName',pluginType:'SRIOV',ipamEnabled:'False'}]" attached-network-configuration.trunked-networks="[{networkId:'/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/trunkedNetworks/trunkedNetworkName',pluginType:'MACVLAN'}]" bgp-service-load-balancer-configuration.bgp-advertisements="[{advertiseToFabric:'True',communities:['64512:100'],ipAddressPools:['pool1'],peers:['peer1']}]" bgp-service-load-balancer-configuration.fabric-peering-enabled="True" bgp-service-load-balancer-configuration.bgp-peers="[{bfdEnabled:'False',bgpMultiHop:'False',holdTime:'P300s',keepAliveTime:'P300s',myAsn:64512,name:'peer1',peerAddress:'203.0.113.254',peerAsn:64497,peerPort:179}]" bgp-service-load-balancer-configuration.ip-address-pools="[{addresses:['198.51.102.0/24'],autoAssign:'True',name:'pool1',onlyUseHostIps:'True'}]"
Parâmetros Exigidos
As características definidoras do plano de controle para este cluster do Kubernetes. Suporte a sintaxe abreviada, json-file e yaml-file. Tente "??" para mostrar mais.
O local estendido do cluster associado ao recurso. Suporte a sintaxe abreviada, json-file e yaml-file. Tente "??" para mostrar mais.
Os pools de agentes criados com esse cluster do Kubernetes para executar serviços e cargas de trabalho críticos do sistema. Esses dados nesse campo são usados apenas durante a criação, e o campo ficará vazio após a criação do cluster do Kubernetes. Após a criação, o gerenciamento de pools de agentes é feito usando o sub-recurso agentPools. Suporte a sintaxe abreviada, json-file e yaml-file. Tente "??" para mostrar mais.
O nome do cluster do Kubernetes.
A versão do Kubernetes para este cluster. Aceita os formatos n.n, n.n.n e n.n.n-n. A versão interpretada usada será resolvida neste campo após a criação ou atualização.
A configuração da rede do cluster do Kubernetes, incluindo a conexão de redes que abrangem o cluster. Suporte a sintaxe abreviada, json-file e yaml-file. Tente "??" para mostrar mais.
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>
.
Parâmetros Opcionais
As propriedades de integração do Azure Active Directory. Suporte a sintaxe abreviada, json-file e yaml-file. Tente "??" para mostrar mais.
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.
Gere os arquivos de chave pública e privada de SSH, se estiverem ausentes. As chaves serão armazenadas em '~/.ssh'.
A localização geográfica onde o recurso reside Quando não especificado, o local do grupo de recursos será usado.
A configuração do grupo de recursos gerenciados associado ao recurso. Suporte a sintaxe abreviada, json-file e yaml-file. Tente "??" para mostrar mais.
Não aguarde a conclusão da operação de execução longa.
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.
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 de recursos. Suporte a sintaxe abreviada, json-file e yaml-file. Tente "??" para mostrar mais.
Parâmetros Globais
Aumente o detalhamento do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
.
Aumentar o detalhamento do log. Use --debug para logs de depuração completos.
az networkcloud kubernetescluster delete
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 cluster do Kubernetes fornecido.
az networkcloud kubernetescluster delete [--ids]
[--kubernetes-cluster-name]
[--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
[--resource-group]
[--subscription]
[--yes]
Exemplos
Excluir cluster do Kubernetes
az networkcloud kubernetescluster delete --name "kubernetesClusterName" --resource-group "resourceGroupName"
Parâmetros Opcionais
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".
O nome do cluster do Kubernetes.
Não aguarde a conclusão da operação de execução longa.
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>
.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
.
Não solicite confirmação.
Parâmetros Globais
Aumente o detalhamento do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
.
Aumentar o detalhamento do log. Use --debug para logs de depuração completos.
az networkcloud kubernetescluster list
Esse comando está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus
Liste os clusters do Kubernetes na assinatura fornecida.
az networkcloud kubernetescluster list [--max-items]
[--next-token]
[--resource-group]
Exemplos
Listar clusters do Kubernetes para assinatura
az networkcloud kubernetescluster list
Listar clusters do Kubernetes para o grupo de recursos
az networkcloud kubernetescluster list --resource-group "resourceGroupName"
Parâmetros Opcionais
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.
Token para especificar por onde começar a paginar. Esse é o valor do token de uma resposta truncada anteriormente.
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>
.
Parâmetros Globais
Aumente o detalhamento do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
.
Aumentar o detalhamento do log. Use --debug para logs de depuração completos.
az networkcloud kubernetescluster restart-node
Esse comando está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus
Reinicie um nó de destino de um cluster do Kubernetes.
az networkcloud kubernetescluster restart-node --node-name
[--ids]
[--kubernetes-cluster-name]
[--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
[--resource-group]
[--subscription]
Exemplos
Reiniciar o nó de cluster do Kubernetes
az networkcloud kubernetescluster restart-node --node-name "nodeName" --kubernetes-cluster-name "kubernetesClusterName" --resource-group "resourceGroupName"
Parâmetros Exigidos
O nome do nó a ser reiniciado.
Parâmetros Opcionais
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".
O nome do cluster do Kubernetes.
Não aguarde a conclusão da operação de execução longa.
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>
.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
.
Parâmetros Globais
Aumente o detalhamento do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
.
Aumentar o detalhamento do log. Use --debug para logs de depuração completos.
az networkcloud kubernetescluster show
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 cluster do Kubernetes fornecido.
az networkcloud kubernetescluster show [--ids]
[--kubernetes-cluster-name]
[--resource-group]
[--subscription]
Exemplos
Obter cluster do Kubernetes
az networkcloud kubernetescluster show --name "kubernetesClusterName" --resource-group "resourceGroupName"
Parâmetros Opcionais
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".
O nome do cluster do Kubernetes.
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>
.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
.
Parâmetros Globais
Aumente o detalhamento do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
.
Aumentar o detalhamento do log. Use --debug para logs de depuração completos.
az networkcloud kubernetescluster update
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 cluster do Kubernetes fornecido ou atualize as tags associadas ao cluster do Kubernetes. As propriedades e as atualizações de marca podem ser feitas de forma independente.
az networkcloud kubernetescluster update [--control-plane-node-configuration]
[--generate-ssh-keys {0, 1, f, false, n, no, t, true, y, yes}]
[--ids]
[--kubernetes-cluster-name]
[--kubernetes-version]
[--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
[--resource-group]
[--ssh-dest-key-path]
[--ssh-key-values]
[--subscription]
[--tags]
Exemplos
Patch do cluster do Kubernetes
az networkcloud kubernetescluster update --name "kubernetesClusterName" --resource-group "resourceGroupName" --kubernetes-version "1.25.4" --control-plane-node-configuration count="3" --tags key1="myvalue1" key2="myvalue2"
Atualizar credenciais de administrador de cluster do Kubernetes
az networkcloud kubernetescluster update --name "kubernetesClusterName" --resource-group "resourceGroupName" --ssh-key-values 'ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABgt5SjWU= admin@vm'
Atualizar credenciais de administrador do nó de controle de cluster do Kubernetes
az networkcloud kubernetescluster update --name "kubernetesClusterName" --resource-group "resourceGroupName" --control-plane-node-configuration ssh-key-values="['ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABgt5SjWU= admin@vm']"
Parâmetros Opcionais
As características definidoras do plano de controle que podem ser corrigidas para esse cluster do Kubernetes. Suporte a sintaxe abreviada, json-file e yaml-file. Tente "??" para mostrar mais.
Gere os arquivos de chave pública e privada de SSH, se estiverem ausentes. As chaves serão armazenadas em '~/.ssh'.
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".
O nome do cluster do Kubernetes.
A versão do Kubernetes para este cluster. Aceita os formatos n.n, n.n.n e n.n.n-n. A versão interpretada usada será resolvida neste campo após a criação ou atualização.
Não aguarde a conclusão da operação de execução longa.
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>
.
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.
A lista de chaves públicas SSH separadas por espaço. Suporte a sintaxe abreviada, json-file e yaml-file. Tente "??" para mostrar mais.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
.
As marcas de recurso do Azure que substituirão as existentes. Suporte a sintaxe abreviada, json-file e yaml-file. Tente "??" para mostrar mais.
Parâmetros Globais
Aumente o detalhamento do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
.
Aumentar o detalhamento do log. Use --debug para logs de depuração completos.
az networkcloud kubernetescluster wait
Coloque a CLI em um estado de espera até que uma condição seja atendida.
az networkcloud kubernetescluster wait [--created]
[--custom]
[--deleted]
[--exists]
[--ids]
[--interval]
[--kubernetes-cluster-name]
[--resource-group]
[--subscription]
[--timeout]
[--updated]
Parâmetros Opcionais
Aguarde até ser criado com 'provisioningState' em 'Succeeded'.
Aguarde até que a condição satisfaça uma consulta JMESPath personalizada. Por exemplo, provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].
Aguarde até ser excluído.
Aguarde até que o recurso exista.
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".
Intervalo de sondagem em segundos.
O nome do cluster do Kubernetes.
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>
.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
.
Espera máxima em segundos.
Aguarde até ser atualizado com provisioningState em 'Succeeded'.
Parâmetros Globais
Aumente o detalhamento do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID
.
Aumentar o detalhamento do log. Use --debug para logs de depuração completos.