Compartilhar via


az aksarc

Observação

Essa referência faz parte da extensão aksarc para a CLI do Azure (versão 2.32.0 ou superior). A extensão é instalada automaticamente na primeira vez que você executa um comando az aksarc . Saiba mais sobre extensões.

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

Gerenciar clusters provisionados.

Comandos

Nome Description Tipo Status
az aksarc create

Cria o cluster provisionado.

Extensão Visualizar
az aksarc delete

Exclui o cluster provisionado.

Extensão Visualizar
az aksarc get-credentials

Obtém kubeconfig local do cluster provisionado.

Extensão Visualizar
az aksarc list

Lista os clusters provisionados em um grupo de recursos ou em uma assinatura.

Extensão Visualizar
az aksarc logs

Coleta logs de clusters provisionados.

Extensão Visualizar
az aksarc logs hci

Coleta logs de clusters provisionados no ambiente HCI.

Extensão Visualizar
az aksarc nodepool

Gerencia pools de nós em um cluster provisionado.

Extensão Visualizar
az aksarc nodepool add

Adiciona um pool de nós no cluster provisionado.

Extensão Visualizar
az aksarc nodepool delete

Exclui o nodepool no cluster provisionado.

Extensão Visualizar
az aksarc nodepool list

Lista todos os pools de nós no cluster provisionado.

Extensão Visualizar
az aksarc nodepool scale

Dimensiona o pool de nós no cluster provisionado.

Extensão Visualizar
az aksarc nodepool show

Obtém o pool de nós no cluster provisionado.

Extensão Visualizar
az aksarc notice

Gera o arquivo NOTICE para o caminho de arquivo especificado pelo usuário.

Extensão Visualizar
az aksarc show

Obtém o cluster provisionado.

Extensão Visualizar
az aksarc update

Atualiza o cluster provisionado.

Extensão Visualizar
az aksarc vmsize

Gerencia SKUs de máquina virtual para clusters provisionados.

Extensão Visualizar
az aksarc vmsize list

Lista os tamanhos de máquina virtual com suporte no local personalizado especificado.

Extensão Visualizar
az aksarc vnet

Gerencia redes virtuais para clusters provisionados.

Extensão Visualizar
az aksarc vnet create

Cria a rede virtual.

Extensão Visualizar
az aksarc vnet delete

Excluir a rede virtual.

Extensão Visualizar
az aksarc vnet list

Lista as redes virtuais por grupo de recursos ou assinatura.

Extensão Visualizar
az aksarc vnet show

Obtém a rede virtual.

Extensão Visualizar

az aksarc create

Versão Prévia

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

Cria o cluster provisionado.

az aksarc create --custom-location
                 --name
                 --resource-group
                 [--aad-admin-group-object-ids]
                 [--control-plane-count]
                 [--control-plane-ip]
                 [--control-plane-vm-size]
                 [--enable-ahub]
                 [--enable-azure-rbac]
                 [--generate-ssh-keys]
                 [--kubernetes-version]
                 [--load-balancer-count]
                 [--location]
                 [--no-wait]
                 [--node-count]
                 [--node-vm-size]
                 [--pod-cidr]
                 [--ssh-key-value]
                 [--tags]
                 [--vnet-ids]

Exemplos

PutProvisionedCluster

az aksarc create -g sample-rg --custom-location sample-cl -n sample-aksarccluster --vnet-ids "vnet-arm-id"

Parâmetros Exigidos

--custom-location

Nome ou ID do local personalizado a ser usado para o cluster provisionado.

--name -n

Nome do cluster provisionado.

--resource-group -g

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

Parâmetros Opcionais

--aad-admin-group-object-ids -i

Lista separada por vírgulas de IDs de objeto do grupo aad que serão definidas como administrador de cluster no cluster provisionado.

--control-plane-count --control-plane-node-count

Número de nós do plano de controle.

--control-plane-ip

Endereço IP do servidor de API para o plano de controle.

--control-plane-vm-size

Tamanho da VM do plano de controle.

--enable-ahub

Habilite os Benefícios do Usuário Híbrido do Azure (AHUB) para o cluster provisionado.

Valor padrão: False
--enable-azure-rbac

Habilite o RBAC do Azure para controlar as verificações de autorização no cluster.

Valor padrão: False
--generate-ssh-keys

Gere o par de chaves ssh se não estiver presente.

Valor padrão: False
--kubernetes-version -k

A versão Kubernetes do cluster provisionado.

--load-balancer-count

Número de nós do balanceador de carga.

--location -l

Local. Valores de: az account list-locations. Você pode configurar o local padrão usando az configure --defaults location=<location>.

--no-wait

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

Valor padrão: False
--node-count -c

Número de nós a serem criados no pool de nós.

Valor padrão: 1
--node-vm-size

Tamanho da VM dos nós no pool de nós.

--pod-cidr

O IP de notação CIDR varia a partir do qual atribuir IPs de pod.

--ssh-key-value

Caminho para a chave pública SSH a ser injetada no plano de controle.

Valor padrão: ~\.ssh\id_rsa.pub
--tags

Tags separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar as tags existentes.

--vnet-ids

ID(s) de recurso do Azure Resource Manager das VNets.

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 aksarc delete

Versão Prévia

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

Exclui o cluster provisionado.

az aksarc delete --name
                 --resource-group
                 [--no-wait]
                 [--yes]

Exemplos

DeleteProvisionedCluster

az aksarc delete --name "sample-aksarccluster" --resource-group "sample-rg"

Parâmetros Exigidos

--name -n

Nome do cluster provisionado.

--resource-group -g

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

Parâmetros Opcionais

--no-wait

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

Valor padrão: False
--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 aksarc get-credentials

Versão Prévia

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

Obtém kubeconfig local do cluster provisionado.

az aksarc get-credentials --name
                          --resource-group
                          [--admin]
                          [--context]
                          [--file]
                          [--overwrite-existing]

Exemplos

GetAdminCredential

az aksarc get-credentials --name "sample-aksarccluster" --resource-group "sample-rg" --admin

GetAADUserCredential

az aksarc get-credentials --name "sample-aksarccluster" --resource-group "sample-rg"

Parâmetros Exigidos

--name -n

Nome do cluster provisionado.

--resource-group -g

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

Parâmetros Opcionais

--admin -a

Obtém credenciais de administrador de cluster.

Valor padrão: False
--context

Se especificado, substitui o nome de contexto padrão.

--file -f

Arquivo de configuração do Kubernetes a ser atualizado. Se não for fornecido, atualiza o arquivo '~/.kube/config'.

Valor padrão: ~\.kube\config
--overwrite-existing

Substitui qualquer entrada de cluster existente com o mesmo nome.

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 aksarc list

Versão Prévia

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

Lista os clusters provisionados em um grupo de recursos ou em uma assinatura.

az aksarc list [--resource-group]

Exemplos

ListProvisionedClusterByResourceGroup

az aksarc list --resource-group "sample-rg"

ListProvisionedClusterBySubscription

az aksarc list

Parâmetros Opcionais

--resource-group -g

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

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 aksarc notice

Versão Prévia

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

Gera o arquivo NOTICE para o caminho de arquivo especificado pelo usuário.

az aksarc notice --output-filepath

Exemplos

GetNoticeFile

az aksarc notice --output-filepath "./Notice"

Parâmetros Exigidos

--output-filepath

Saídas filepath para o arquivo NOTICE.

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 aksarc show

Versão Prévia

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

Obtém o cluster provisionado.

az aksarc show --name
               --resource-group

Exemplos

GetProvisionedCluster

az aksarc show --name "sample-aksarccluster" --resource-group "sample-rg"

Parâmetros Exigidos

--name -n

Nome do cluster provisionado.

--resource-group -g

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

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 aksarc update

Versão Prévia

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

Atualiza o cluster provisionado.

az aksarc update --name
                 --resource-group
                 [--aad-admin-group-object-ids]
                 [--control-plane-count]
                 [--disable-ahub]
                 [--enable-ahub]
                 [--tags]

Exemplos

UpdateProvisionedCluster

az aksarc update --tags additionalProperties="sample" --name "sample-aksarccluster" --resource-group "sample-rg"

Habilite o recurso Benefícios do Usuário Híbrido do Azure para um cluster provisionado.

az aksarc update --name "sample-aksarccluster" --resource-group "sample-rg" --enable-ahub

Desabilita o recurso Benefícios do Usuário Híbrido do Azure para um cluster provisionado.

az aksarc update --name "sample-aksarccluster" --resource-group "sample-rg"--disable-ahub

Amplia os nós do Plano de Controle.

az aksarc update --name "sample-aksarccluster" --resource-group "sample-rg" --control-plane-node-count 5

Parâmetros Exigidos

--name -n

Nome do cluster provisionado.

--resource-group -g

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

Parâmetros Opcionais

--aad-admin-group-object-ids -i

Lista separada por vírgulas de IDs de objeto do grupo aad que serão definidas como administrador de cluster no cluster provisionado.

--control-plane-count --control-plane-node-count

Número de nós para os quais dimensionar o Plano de Controle.

--disable-ahub

Desabilita os Benefícios do Usuário Híbrido do Azure (AHUB) para o cluster provisionado.

Valor padrão: False
--enable-ahub

Habilita os Benefícios do Usuário Híbrido do Azure (AHUB) para o cluster provisionado.

Valor padrão: False
--tags

Tags separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar tags.commands existentes:

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.