Activer l’extension Kubernetes pour les opérateurs AKS Arc (préversion)

Article
11/23/2024

S’applique à : AKS activé par Azure Arc sur VMware (préversion)

Pour utiliser la préversion d’AKS Arc sur VMware, vous devez d’abord intégrer VMware vSphere avec Arc en connectant vCenter à Azure via arc Resource Bridge , il existe deux scénarios disponibles pour accéder à cette préversion :

Si vous déployez Arc Resource Bridge avec l’extension Kubernetes pour les opérateurs AKS Arc installés, vous devez uniquement suivre l’étape 1 : inscrire la fonctionnalité/le fournisseur pour la première fois et l’étape 2 : installer l’extension aksarcCLI.
Si vous déployez Arc Resource Bridge sans installer l’extension Kubernetes pour les opérateurs AKS Arc, suivez toutes les étapes décrites dans cet article.

Avant de commencer

Avant de commencer, installez l’interface de ligne de commande Azure.

Étape 1. Inscrire la fonctionnalité/le fournisseur pour la première fois

Si votre abonnement déploie l’extension Kubernetes pour les opérateurs AKS Arc (préversion) pour la première fois, vous devez inscrire les fonctionnalités en préversion.

Préparez votre compte Azure :

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

Effectuez une inscription de fonctionnalité unique :

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

Effectuez une inscription à un fournisseur unique :

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

Étape 2. Installer l’extension CLI aksarc

Installez l’extension CLI . Utilisez la commande 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

Étape 3. Installer l’extension Kubernetes pour les opérateurs AKS Arc

Spécifiez la version de l’extension Kubernetes pour les opérateurs 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'

Spécifiez les $resource_group éléments suivants :$appliance_name

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

Installez l’extension Kubernetes pour les opérateurs 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

Étape 4. Préparer votre emplacement personnalisé

L’emplacement personnalisé a été créé pendant le déploiement du pont de ressources Arc.

Obtenez les ID pour configurer l’emplacement personnalisé :

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

Spécifiez le $customLocationResourceGroupName et $customLocationName, que vous avez créés pendant le déploiement du pont de ressources Arc :

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

Corrigez l’emplacement personnalisé : 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

Vérifiez que l’état d’approvisionnement de l’emplacement personnalisé est réussi : ProvisioningState: "Succeeded"
```
az customlocation show -g $customLocationResourceGroupName -n $customLocationName 
```

Maintenant que vous avez activé l’extension Kubernetes pour les opérateurs AKS Arc (préversion), vous pouvez passer aux étapes suivantes pour créer un cluster Kubernetes.

Nettoyer l’environnement à partir des déploiements d’AKS Arc sur VMware

Une fois que vous avez terminé l’évaluation de la préversion d’AKS Arc sur VMware, vous pouvez suivre ces étapes pour nettoyer votre environnement :

Supprimez le cluster AKS. Pour supprimer le cluster de charge de travail, utilisez la commande az aksarc delete ou accédez au Portail Azure :
```
az aksarc delete -n '<cluster name>' -g $applianceResourceGroupName
```
Désinstallez l’extension Kubernetes. Vous pouvez désinstaller l’extension Kubernetes pour les opérateurs AKS Arc à l’aide de la commande az extension remove :
```
az extension remove -n aksarc
az extension remove -n connectedk8s
```

Étapes suivantes

Si vous commencez à évaluer l’aperçu d’AKS Arc sur VMware et que vous avez terminé d’activer l’extension Kubernetes pour les opérateurs AKS Arc, vous pouvez créer un cluster Kubernetes en suivant les instructions du guide de démarrage rapide : Déployer un cluster AKS à l’aide d’Azure CLI.
Si vous avez terminé l’évaluation d’AKS Arc sur VMware, vous pouvez partager vos commentaires avec nous via GitHub.

Partager via