Share via


Habilitar a extensão kubernetes para operadores do AKS Arc (versão prévia)

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

Para usar o AKS Arc na versão prévia do VMware, primeiro você deve integrar o VMware vSphere habilitado para Arc conectando o vCenter ao Azure por meio da Ponte de Recursos do Arc Há dois cenários disponíveis para acessar esta versão prévia:

Antes de começar

Antes de começar, instale a CLI do Azure.

Etapa 1. Registrar recurso/provedor pela primeira vez

Se sua assinatura estiver implantando a Extensão kubernetes para operadores do AKS Arc (versão prévia) pela primeira vez, você deverá registrar os recursos de visualização.

  1. Prepare sua conta do Azure:

     az login --use-device-code
     az account set -s '<$subscriptionID>'
    
  2. Executar um registro de recurso único:

    ### Register your subscription ID with the feature
    az feature register --namespace Microsoft.HybridConnectivity --name hiddenPreviewAccess
    
    ### Check feature registrationState -o tsv == Registered
    az feature show --name hiddenPreviewAccess --namespace Microsoft.HybridConnectivity
    
  3. Executar um registro de provedor único:

    ### Register your subscription ID with the provider
    az provider register --namespace "Microsoft.HybridContainerService" 
    az provider register --namespace "Microsoft.HybridConnectivity"
    
    ### Check provider registrationState -o tsv == Registered
    az provider show -n Microsoft.HybridContainerService --query registrationState
    az provider show -n Microsoft.HybridConnectivity --query registrationState
    

Etapa 2. Instalar a extensão da CLI do aksarc

Instale a extensão da CLI. Use o comando az extension add :

az extension add -n aksarc --version 1.0.0b1
az extension add -n connectedk8s
az extension add -n k8s-extension
az extension add -n arcappliance
az extension add -n customlocation

Etapa 3. Instalar a extensão kubernetes para operadores aks arc

  1. Especifique a versão da extensão do Kubernetes para operadores do AKS Arc:

    $extension_name = 'hybridaksopext'
    $extension_version = '0.4.5'
    $extension_release_train = 'preview'
    
    export extension_name='hybridaksopext'
    export extension_version='0.4.5'
    export extension_release_train='preview'
    
  2. Especifique o $resource_group e $appliance_name:

    $resource_group = '$resourceGroup from Arc Resource Bridge deployment'
    $appliance_name = '$applianceName from Arc Resource Bridge deployment'
    
  3. Instale a extensão do Kubernetes para operadores do AKS Arc:

    az k8s-extension create -g $resource_group -c $appliance_name --cluster-type appliances --name $extension_name --extension-type Microsoft.HybridAKSOperator --version $extension_version --release-train $extension_release_train --config Microsoft.CustomLocation.ServiceAccount="default" --auto-upgrade false 
    

Etapa 4. Preparar sua localização personalizada

O local personalizado foi criado durante a implantação do Arc Resource Bridge.

  1. Obtenha as IDs para configurar o local personalizado:

    ### $extension_name = 'hybridaksopext'
    $ArcApplianceResourceId = (az arcappliance show -g $resource_group -n $appliance_name --query id -o tsv)
    $ClusteraksExtensionId = (az k8s-extension show -g $resource_group -c $appliance_name --cluster-type appliances --name $extension_name --query id -o tsv)
    
  2. Especifique o $customLocationResourceGroupName e $customLocationName, que você criou durante a implantação do Arc Resource Bridge:

    $customLocationResourceGroupName = '$resourceGroup from Arc Resource Bridge deployment'
    $customLocationName = '$customLocationName from Arc Resource Bridge deployment'
    
  3. Corrija o local personalizado: ProvisioningState: "Patching".

    ### Use the same custom location information from the Arc Resource Bridge deployment
    az customlocation patch -g $customLocationResourceGroupName -n $customLocationName --cluster-extension-ids $clusteraksExtensionId
    
  4. Verifique se o estado de provisionamento de local personalizado foi bem-sucedido: ProvisioningState: "Succeeded":

    az customlocation show -g $customLocationResourceGroupName -n $customLocationName 
    

Agora que você habilitou com êxito a Extensão kubernetes para operadores do AKS Arc (versão prévia), você pode prosseguir para as próximas etapas para criar um cluster do Kubernetes.

Limpar o ambiente de implantações do AKS Arc no VMware

Depois de concluir a avaliação do AKS Arc na versão prévia do VMware, você poderá seguir estas etapas para limpo seu ambiente:

  1. Exclua o cluster do AKS. Para excluir o cluster de carga de trabalho, use o comando az aksarc delete ou vá para o portal do Azure:

    az aksarc delete -n '<cluster name>' -g $applianceResourceGroupName
    
  2. Desinstale a Extensão do Kubernetes. Você pode desinstalar a Extensão kubernetes para operadores aks arc usando o comando az extension remove :

    az extension remove -n aksarc
    az extension remove -n connectedk8s
    

Próximas etapas

  • Se você estiver começando a avaliar o AKS Arc na versão prévia do VMware e terminar de habilitar a Extensão do Kubernetes para Operadores do AKS Arc, poderá criar um cluster do Kubernetes seguindo as instruções no Início Rápido: Implantar um cluster do AKS usando a CLI do Azure.
  • Se você concluiu a avaliação do AKS Arc no VMware, poderá compartilhar seus comentários conosco por meio do GitHub.