Ativar a Extensão do Kubernetes para Operadores do AKS Arc (pré-visualização)

Artigo
03/29/2024

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

Para utilizar o AKS Arc na pré-visualização do VMware, primeiro tem de integrar o VMware vSphere compatível com o Arc ao ligar o vCenter ao Azure através da Bridge de Recursos do Arc Existem dois cenários disponíveis para aceder a esta pré-visualização:

Se implementar a Bridge de Recursos do Arc com a Extensão do Kubernetes para Operadores do Arc do AKS instalada, só deverá seguir o Passo 1: registar a funcionalidade/fornecedor pela primeira vez e o Passo 2: instalar a extensão da aksarc CLI.
Se implementar a Bridge de Recursos do Arc sem instalar a Extensão do Kubernetes para Operadores do AKS Arc, siga todos os passos neste artigo.

Antes de começar

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

Passo 1. Registar funcionalidade/fornecedor pelo utilizador pela primeira vez

Se a sua subscrição estiver a implementar a Extensão do Kubernetes para Operadores do AKS Arc (pré-visualização) pela primeira vez, tem de registar as funcionalidades de pré-visualização.

Preparar a sua conta do Azure:

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

Efetuar um registo de funcionalidades ú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

Efetuar um registo de fornecedor ú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

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

Instale a extensão da CLI. Utilize 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. 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

Passo 4: Preparar a sua localização personalizada

A localização personalizada foi criada durante a implementação da Bridge de Recursos do Arc.

Obtenha os IDs para configurar a localização personalizada:

### $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 criou durante a implementação da Bridge de Recursos do Arc:

$customLocationResourceGroupName = '$resourceGroup from Arc Resource Bridge deployment'
$customLocationName = '$customLocationName from Arc Resource Bridge deployment'

Corrigir a localização personalizada: 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 aprovisionamento da localização personalizada foi efetuado com êxito: ProvisioningState: "Succeeded":
```
az customlocation show -g $customLocationResourceGroupName -n $customLocationName 
```

Agora que ativou com êxito a Extensão do Kubernetes para Operadores do AKS Arc (pré-visualização), pode avançar para os passos seguintes para criar um cluster do Kubernetes.

Limpar o ambiente das implementações do AKS Arc no VMware

Depois de concluir a avaliação da pré-visualização do AKS Arc no VMware, pode seguir estes passos para limpar o seu ambiente:

Elimine o cluster do AKS. Para eliminar o cluster de cargas de trabalho, utilize o comando az aksarc delete ou aceda ao portal do Azure:
```
az aksarc delete -n '<cluster name>' -g $applianceResourceGroupName
```
Desinstale a Extensão do Kubernetes. Pode desinstalar a Extensão do Kubernetes para Operadores do AKS Arc com o comando az extension remove :
```
az extension remove -n aksarc
az extension remove -n connectedk8s
```

Passos seguintes

Se estiver a começar a avaliar a pré-visualização do AKS Arc no VMware e tiver concluído a ativação da Extensão do Kubernetes para Operadores do AKS Arc, pode criar um cluster do Kubernetes ao seguir as instruções no Início Rápido: Implementar um cluster do AKS com a CLI do Azure.
Se concluiu a avaliação do AKS Arc no VMware, pode partilhar o seu feedback connosco através do GitHub.

Partilhar via