Habilitar a extensão do Kubernetes para operadores de arco do AKS (versão prévia)

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

Para usar a versão prévia do AKS Arc no VMware, você deve primeiro 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 essa versão prévia:

• Se você implantar a Ponte de Recursos do Arc com a Extensão do Kubernetes para Operadores do AKS Arc instalada, siga apenas a Etapa #1: registrar o recurso/provedor para o usuário pela primeira vez e a Etapa #2: instalar a extensão da aksarc CLI.
• Se você implantar a Ponte de Recursos do Arc sem instalar a Extensão do Kubernetes para Operadores do AKS Arc, siga todas as etapas neste artigo.

Antes de começar

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

Etapa 1. Registrar recurso/provedor pela primeira vez usuário

Se sua assinatura estiver implantando a Extensão do Kubernetes para Operadores de Arc do AKS (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. Execute um registro de feição ú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. Execute um registro único do provedor:

   ### 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 do Kubernetes para operadores do 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 seu local personalizado

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 da Ponte de Recursos do Arc:

   $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 do local personalizado foi bem-sucedido: ProvisioningState: "Succeeded"

   az customlocation show -g $customLocationResourceGroupName -n $customLocationName 
   

Agora que você habilitou com êxito a Extensão do 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ê pode seguir estas etapas para limpar seu ambiente:

1. Exclua o cluster do AKS. Para excluir o cluster de carga de trabalho, use o comando az aksarc delete ou acesse 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 do Kubernetes para operadores de arco do AKS 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 a versão prévia do AKS Arc no VMware e tiver concluído a habilitação da 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.