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

Artigo
11/23/2024

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.

Prepare sua conta do Azure:

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

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

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

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'

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

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)

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'

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

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
```
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.

Compartilhar via