Ativar a extensão Kubernetes para operadores de arco AKS (visualização)

Artigo
11/23/2024

Aplica-se a: AKS habilitado pelo Azure Arc no VMware (visualização)

Para usar o AKS Arc na visualização do VMware, você deve primeiro integrar o VMware vSphere habilitado para Arc conectando o vCenter ao Azure por meio do Arc Resource Bridge Há dois cenários disponíveis para acessar essa visualização:

Se você implantar o Arc Resource Bridge com a extensão Kubernetes para AKS Arc Operators instalada, você só deve seguir a Etapa #1: registrar o recurso/provedor pela primeira vez e a Etapa #2: instalar a extensão CLIaksarc.
Se você implantar o Arc Resource Bridge sem instalar a extensão Kubernetes para operadores de arco AKS, siga todas as etapas neste artigo.

Antes de começar

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

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

Se sua assinatura estiver implantando a Extensão Kubernetes para Operadores de Arco AKS (visualização) pela primeira vez, você deverá registrar os recursos de visualização.

Prepare sua conta do Azure:

 az login --use-device-code
 az account set -s '<$subscriptionID>'

Execute um registro único de recurso:

### 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

Realize um registro único de 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

Passo 2. Instale a extensão aksarc CLI

Instale a extensão 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

Passo 3. Instale a extensão Kubernetes para operadores de arco AKS

Especifique a versão da extensão Kubernetes para operadores 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'

Especifique o $resource_group e $appliance_name:

$resource_group = '$resourceGroup from Arc Resource Bridge deployment'
$appliance_name = '$applianceName from Arc Resource Bridge deployment'

Instale a extensão Kubernetes para operadores 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

Passo 4. Prepare a sua localização personalizada

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

Obtenha os 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)

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'

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

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 de Arco AKS (visualização), você pode prosseguir para as próximas etapas para criar um cluster Kubernetes.

Ambiente de limpeza de implantações do AKS Arc no VMware

Depois de concluir a avaliação do AKS Arc na visualização do VMware, você pode seguir estas etapas para limpar seu ambiente:

Exclua o cluster 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
```
Desinstale a extensão Kubernetes. Você pode desinstalar a extensão Kubernetes para AKS Arc Operators usando o comando az extension remove :
```
az extension remove -n aksarc
az extension remove -n connectedk8s
```

Próximos passos

Se você estiver começando a avaliar o AKS Arc na visualização do VMware e tiver terminado de habilitar a extensão do Kubernetes para operadores do AKS Arc, poderá criar um cluster do Kubernetes seguindo as instruções no Guia de início rápido: implantar um cluster AKS usando a CLI do Azure.
Se você concluiu a avaliação do AKS Arc no VMware, você pode compartilhar seu feedback conosco através do GitHub.

Partilhar via