az networkcloud kubernetescluster
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 . 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 cluster Kubernetes.
Comandos
Nome | Description | Tipo | Status |
---|---|---|---|
az networkcloud kubernetescluster agentpool |
Gerenciar o pool de agentes do cluster Kubernetes. |
Extensão | Visualizar |
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 create |
Crie um novo cluster do Kubernetes ou atualize as propriedades do existente. |
Extensão | Visualizar |
az networkcloud kubernetescluster delete |
Exclua o cluster Kubernetes fornecido. |
Extensão | Visualizar |
az networkcloud kubernetescluster list |
Listar clusters do Kubernetes na assinatura fornecida. |
Extensão | Visualizar |
az networkcloud kubernetescluster restart-node |
Reinicie um nó de destino de um cluster Kubernetes. |
Extensão | Visualizar |
az networkcloud kubernetescluster show |
Obtenha as propriedades do cluster Kubernetes fornecido. |
Extensão | Visualizar |
az networkcloud kubernetescluster update |
Atualize as propriedades do cluster Kubernetes fornecido ou atualize as marcas associadas ao cluster Kubernetes. As atualizações de propriedades e tags 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 | Visualizar |
az networkcloud kubernetescluster create
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 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 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 Kubernetes. Suporte taquigráfico-sintaxe, json-file e yaml-file. Tente "??" para mostrar mais.
O local estendido do cluster associado ao recurso. Suporte taquigráfico-sintaxe, json-file e yaml-file. Tente "??" para mostrar mais.
Os pools de agentes criados com esse cluster do Kubernetes para executar cargas de trabalho e serviços 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 Kubernetes. Após a criação, o gerenciamento de pools de agentes é feito usando o subrecurso agentPools. Suporte taquigráfico-sintaxe, json-file e yaml-file. Tente "??" para mostrar mais.
O nome do cluster 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 utilizada será resolvida neste campo após a criação ou atualização.
A configuração da rede de cluster do Kubernetes, incluindo a conexão de redes que abrangem o cluster. Suporte taquigráfico-sintaxe, 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 Active Directory do Azure. Suporte taquigráfico-sintaxe, 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 gerenciado associado ao recurso. Suporte taquigráfico-sintaxe, 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, tentará carregar todas as chaves públicas (.pub) encontradas. Suporte taquigráfico-sintaxe, json-file e yaml-file. Tente "??" para mostrar mais.
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 de recursos. Suporte taquigráfico-sintaxe, 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
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 cluster 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 um ID de recurso completo contendo todas as informações dos argumentos 'Resource Id'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.
O nome do cluster 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
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 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 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.
Token para especificar onde iniciar a paginação. Esse é o valor de 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
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
Reinicie um nó de destino de um cluster 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ó do cluster 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 um ID de recurso completo contendo todas as informações dos argumentos 'Resource Id'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.
O nome do cluster 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
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 as propriedades do cluster 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 um ID de recurso completo contendo todas as informações dos argumentos 'Resource Id'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.
O nome do cluster 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
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 cluster Kubernetes fornecido ou atualize as marcas associadas ao cluster Kubernetes. As atualizações de propriedades e tags 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 Kubernetes cluster
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 taquigráfico-sintaxe, 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 um ID de recurso completo contendo todas as informações dos argumentos 'Resource Id'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.
O nome do cluster 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 utilizada 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, tentará carregar todas as chaves públicas (.pub) encontradas. Suporte taquigráfico-sintaxe, json-file e yaml-file. Tente "??" para mostrar mais.
A lista de chaves públicas SSH separadas por espaço. Suporte taquigráfico-sintaxe, 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 taquigráfico-sintaxe, 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
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 wait [--created]
[--custom]
[--deleted]
[--exists]
[--ids]
[--interval]
[--kubernetes-cluster-name]
[--resource-group]
[--subscription]
[--timeout]
[--updated]
Parâmetros Opcionais
Aguarde até criar 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 um ID de recurso completo contendo todas as informações dos argumentos 'Resource Id'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.
Intervalo de sondagem em segundos.
O nome do cluster 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é que seja 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.