Partager via

Démarrage rapide : Déployer un cluster AKS à l’aide d’Azure CLI (préversion)

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

Important

Microsoft retire AKS sur VMware (préversion) le 16 mars 2026. Nous vous recommandons de déployer AKS sur Azure Local pour tirer parti de ses fonctionnalités améliorées. Après le 16 mars 2026, vous ne pourrez plus déployer ou recevoir de support pour Azure Kubernetes Service sur VMware. Si vous avez des questions supplémentaires, contactez-nous via akS activé par le dépôt GitHub Azure Arc.

Ce guide de démarrage rapide vous montre comment déployer un cluster AKS dans AKS activé par Azure Arc sur VMware à l’aide d’Azure CLI.

Prerequisites

Pour suivre ce guide de démarrage rapide, vous devez effectuer les opérations suivantes :

Paramètres Azure

Parameter Détails des paramètres
$aad_Group_Id ID d’un groupe dont les membres gèrent le cluster cible. Ce groupe doit également disposer d’autorisations de propriétaire sur le groupe de ressources contenant l’emplacement personnalisé et le cluster cible.
$appliance_Name Nom du pont de ressources Arc créé pour connecter vCenter à Azure.
$custom_Location Nom ou ID d’emplacement personnalisé. Si vous choisissez d’activer Kubernetes Service sur VMware [préversion] lorsque vous connectez vCenter à Azureà partir du Portail Azure, un emplacement personnalisé avec le préfixe AKS et un espace de noms par défaut sont créés pour vous permettre de déployer AKS sur VMware. Si vous activez Kubernetes Service sur VMware [préversion] à l’aide du processus Azure CLI, vous pouvez spécifier le nom de l’emplacement personnalisé de votre choix avec l’espace de noms par défaut. Vous devez utiliser l’espace de noms par défaut .
$resource_Group Nom ou ID du groupe de ressources pour le déploiement du pont de ressources Arc.

Informations sur le serveur vCenter

Parameter Détails des paramètres
$network_name Nom de la ressource réseau VMware activée dans Azure.
$control_plane_ip Adresse IP du plan de contrôle de votre cluster cible. Cette adresse IP du plan de contrôle doit être réservée/exclue dans DHCP et différente de l’adresse IP du pont de ressources Arc

Étape 1 : Se connecter à Azure

  1. Connectez-vous à Azure en utilisant la commande suivante :

    az login --use-device-code

  2. Définissez l’ID d’abonnement Azure sur l’abonnement que vous avez utilisé pour déployer le pont de ressources Arc et l’emplacement personnalisé :

    az account set -s $subscriptionID

Étape 2 : Créer un réseau virtuel pour votre cluster AKS à l’aide du segment de réseau VMware

  1. Définissez le nom du réseau comme nom du segment de réseau VMware :

    $network_name = '<Name of the VMware Network segment>'

  2. Créez un réseau virtuel avec le même $resource_group que celui que vous avez utilisé pour déployer votre pont de ressources Arc et $custom_location avec l’espace de noms par défaut.

    az aksarc vnet create -n '<name of the vNet>' -g $resource_group --custom-location $custom_location --vsphere-segment-name $network_name

  3. Obtenez l’ID de réseau virtuel :

    $vnet_id = az aksarc vnet show -n '<name of the vNET>'  -g $resource_group --query id -o tsv

  4. Passez le point de terminaison IP du plan de contrôle pour votre cluster cible :

    $control_plane_ip = '<Control Plane IP endpoint for your target cluster>'

    Note

    Si la création du réseau virtuel expire, réessayez d’exécuter les commandes pour recréer le réseau virtuel.

    Note

    L’adresse IP du plan de contrôle doit être réservée/exclue dans DHCP et différente de l’adresse IP du pont de ressources Arc.

Étape 3 : Créer le cluster AKS

Exécutez la commande suivante pour créer le cluster.

az aksarc create -n '<name of your cluster>' -g $resource_group --kubernetes-version '<Kubernetes version from the Arc Resource Bridge>' --custom-location $custom_location --aad-admin-group-object-ids $aad_group_id --vnet-ids $vnet_id --control-plane-ip $control_plane_ip --generate-ssh-keys --debug

Note

Dans cette préversion, vous ne pouvez déployer que la même version kubernetes que celle prise en charge par Arc Resource Bridge. Actuellement, cette préversion prend uniquement en charge Arc Resource Bridge version 1.2.0 et antérieure. La version kubernetes que vous fournissez dans la commande doit être alignée sur la version de Pont des ressources Arc. Vous trouverez la version de Arc Resource Bridge dans le Portail Azure sous Azure Arc > Management > Resource Bridge. Pour déterminer la version de Kubernetes correspondante, consultez Les nouveautés du pont de ressources Azure Arc.

Supprimer le cluster

Exécutez la az aksarc delete commande pour nettoyer le cluster que vous avez créé :

az aksarc delete -n '<name of your cluster>' -g $resource_group

Important

L’opération de suppression peut échouer si vos informations d’identification vCenter ne sont pas valides. Pour éviter cela, vérifiez que vous disposez d’un accès administratif approprié pour VMware vSphere avec Arc. Pour plus d’informations, consultez Mise à jour des informations d’identification du compte vSphere.

Étapes suivantes

  • Last updated on