Partager via


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

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 :

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.

  1. Préparez votre compte Azure :

     az login --use-device-code
     az account set -s '<$subscriptionID>'
    
  2. 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
    
  3. 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

  1. 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'
    
  2. Spécifiez et $resource_group$appliance_name:

    $resource_group = '$resourceGroup from Arc Resource Bridge deployment'
    $appliance_name = '$applianceName from Arc Resource Bridge deployment'
    
  3. 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.

  1. 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)
    
  2. 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'
    
  3. 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
    
  4. 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 :

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