Compartilhar via

Início Rápido: Implantar um cluster do AKS usando a CLI do Azure (versão prévia)

Aplica-se a: AKS habilitado pelo Azure Arc no VMware (versão prévia)

Important

A Microsoft está desativando o AKS no VMware (versão prévia) em 16 de março de 2026. Recomendamos implantar o AKS no Azure Local para se beneficiar de seus recursos aprimorados. Após 16 de março de 2026, você não poderá mais implantar ou receber suporte para o Serviço de Kubernetes do Azure no VMware. Se você tiver dúvidas adicionais, entre em contato conosco por meio do AKS habilitado pelo repositório GitHub do Azure Arc.

Este guia de início rápido mostra como implantar um cluster do AKS no AKS habilitado pelo Azure Arc no VMware usando a CLI do Azure.

Prerequisites

Para concluir este guia de início rápido, você precisa fazer o seguinte:

Parâmetros do Azure

Parameter Detalhes do parâmetro
$aad_Group_Id A ID de um grupo cujos membros gerenciam o cluster de destino. Esse grupo também deve ter permissões de proprietário no grupo de recursos que contém o local personalizado e o cluster de destino.
$appliance_Name Nome da Ponte de Recursos do Arc criada para conectar o vCenter ao Azure.
$custom_Location Nome ou ID do local personalizado. Se você optar por Habilitar o Serviço do Kubernetes no VMware [versão prévia] ao conectar o vCenter ao Azureno portal do Azure, um local personalizado com o prefixo AKS- e um namespace padrão será criado para você implantar o AKS no VMware. Se você habilitar o Serviço do Kubernetes no VMware [versão prévia] usando o processo da CLI do Azure, poderá especificar o nome do local personalizado de sua escolha com o namespace padrão. Você deve usar o namespace padrão .
$resource_Group Nome ou ID do grupo de recursos para implantar a ponte de recursos do Arc.

Informações do servidor vCenter

Parameter Detalhes do parâmetro
$network_name Nome do recurso de rede VMware habilitado no Azure.
$control_plane_ip O IP do painel de controle do cluster de destino. Esse IP do plano de controle deve ser reservado/excluído no DHCP e diferente do endereço IP da Arc Resource Bridge

Etapa 1: Entrar no Azure

  1. Entre no Azure usando o seguinte comando:

    az login --use-device-code

  2. Defina a ID da assinatura do Azure como a assinatura usada para implantar a Ponte de Recursos do Arc e o local personalizado:

    az account set -s $subscriptionID

Etapa 2: Criar vNet para o cluster do AKS usando o segmento de rede VMware

  1. Defina o nome da rede como o nome do segmento de rede VMware:

    $network_name = '<Name of the VMware Network segment>'

  2. Crie uma vNet com a mesma $resource_group que você usou para implantar sua Arc Resource Bridge e $custom_location com o namespace padrão.

    az aksarc vnet create -n '<name of the vNet>' -g $resource_group --custom-location $custom_location --vsphere-segment-name $network_name

  3. Obtenha o ID da vNet:

    $vnet_id = az aksarc vnet show -n '<name of the vNET>'  -g $resource_group --query id -o tsv

  4. Passe o ponto de extremidade IP do painel de controle para o cluster de destino:

    $control_plane_ip = '<Control Plane IP endpoint for your target cluster>'

    Note

    Se a criação da vNet atingir o tempo limite, tente executar os comandos novamente para recriar a vNet.

    Note

    O IP do plano de controle deve ser reservado/excluído no DHCP e diferente do endereço IP da Arc Resource Bridge.

Etapa 3: Criar o cluster do AKS

Execute o comando a seguir para criar o cluster.

az aksarc create -n '<name of your cluster>' -g $resource_group --kubernetes-version '<Kubernetes version from the Arc Resource Bridge>' --custom-location $custom_location --aad-admin-group-object-ids $aad_group_id --vnet-ids $vnet_id --control-plane-ip $control_plane_ip --generate-ssh-keys --debug

Note

Nesta versão prévia, você só pode implantar a mesma versão do Kubernetes compatível com o Arc Resource Bridge. Atualmente, essa versão prévia dá suporte apenas ao Arc Resource Bridge versão 1.2.0 e anterior. A versão do Kubernetes fornecida no comando deve estar alinhada com a versão do Arc Resource Bridge. Você pode encontrar a versão do Resource Bridge do Arc no portal do Azure em Azure Arc > Management Resource > Bridge. Para determinar a versão correspondente do Kubernetes, confira Novidades na ponte de recursos do Azure Arc.

Excluir o cluster

Execute o az aksarc delete comando para limpar o cluster que você criou:

az aksarc delete -n '<name of your cluster>' -g $resource_group

Important

A operação de exclusão poderá falhar se suas credenciais do vCenter forem inválidas. Para evitar isso, verifique se você tem acesso administrativo adequado ao VMware vSphere com Arc habilitado. Para obter mais informações, consulte Atualizando as credenciais da conta do vSphere.

Próximas etapas

  • Last updated on