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

Article
03/29/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 le pont de ressources Arc . Deux scénarios sont disponibles pour accéder à cette préversion :

Si vous déployez le pont de ressources Arc avec l’extension Kubernetes pour les opérateurs AKS Arc installés, vous devez uniquement suivre l’étape 1 : inscrire la fonctionnalité/fournisseur pour la première fois, et l’étape n° 2 : installer l’extension aksarc CLI.
Si vous déployez le pont de ressources Arc 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 une fonctionnalité/un 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é à usage 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 de fournisseur à usage 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 et $resource_group$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 les $customLocationResourceGroupName et $customLocationNameque 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é a réussi : ProvisioningState: "Succeeded"
```
az customlocation show -g $customLocationResourceGroupName -n $customLocationName 
```

Maintenant que vous avez correctement activé l’extension Kubernetes pour aks Arc Operators (préversion), vous pouvez passer aux étapes suivantes pour créer un cluster Kubernetes.

Nettoyer l’environnement 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 propre votre environnement :

Supprimez le cluster AKS. Pour supprimer le cluster de charge de travail, utilisez la commande az aksarc delete ou accédez à la 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 la préversion 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 nous faire part de vos commentaires via GitHub.

Share via