Démarrage rapide : déployer un cluster Kubernetes à l’aide d’un modèle Azure Resource Manager

Article
01/06/2025

S’applique à : Azure Local, version 23H2

Ce guide de démarrage rapide montre comment déployer un cluster Kubernetes dans AKS Arc à l’aide d’un modèle Azure Resource Manager (ARM). Azure Arc étend les fonctionnalités de gestion Azure aux clusters Kubernetes n’importe où, en fournissant une approche unifiée de la gestion de différents environnements.

Avant de commencer

Cet article suppose une compréhension élémentaire des concepts liés à Kubernetes.

Pour déployer un modèle ARM, vous devez disposer d’un accès en écriture aux ressources que vous déployez et un accès à toutes les opérations sur le type de ressource Microsoft.Resources/deployments. Par exemple, pour déployer une machine virtuelle, vous avez besoin des autorisations Microsoft.Compute/virtualMachines/write et Microsoft.Resources/deployments/* . Pour obtenir la liste des rôles et autorisations, consultez Rôles intégrés Azure.

Prérequis

Compte Azure avec un abonnement actif.
Un cluster Azure Local version 23H2.
Dernière version d’Azure CLI.

Étape 1 : Préparer votre compte Azure

Connectez-vous à Azure : ouvrez votre terminal ou invite de commandes et connectez-vous à votre compte Azure à l’aide d’Azure CLI :
```
az login
```
Définissez votre abonnement : remplacez <your-subscription-id> par votre ID d’abonnement :
```
az account set --subscription "<your-subscription-id>"
```

Étape 2 : Créer une paire de clés SSH à l’aide d’Azure CLI

az sshkey create --name "mySSHKey" --resource-group "myResourceGroup"

ou créez une paire de clés SSH à l’aide de ssh-keygen :

ssh-keygen -t rsa -b 4096

Pour déployer le modèle, vous devez fournir la clé publique de la paire SSH. Pour récupérer la clé publique, utilisez la az sshkey show commande :

az sshkey show --name "mySSHKey" --resource-group "myResourceGroup" --query "publicKey"

Par défaut, les fichiers de la clé SSH sont créés dans le répertoire ~/.ssh. Exécutez la ou az sshkey create la ssh-keygen commande pour remplacer toute paire de clés SSH existante portant le même nom.

Pour plus d’informations sur la création de clés SSH, consultez Créer et gérer les clés SSH pour l’authentification dans Azure.

Étape 3 : Passer en revue le modèle

Téléchargez le modèle et les fichiers de paramètres à partir du dépôt AKSArc sur votre ordinateur local. Passez en revue toutes les valeurs par défaut et vérifiez qu’elles sont correctes.

Étape 4 : déployer le modèle

Pour déployer le cluster Kubernetes, exécutez la commande suivante :

az deployment group create \
--name "<deployment-name>" \
--resource-group "<resource-group-name>" \
--template-file "azuredeploy.json" \
--parameters "azuredeploy.parameters.json"

La création du cluster ne prend que quelques minutes. Attendez que le cluster soit correctement déployé pour passer à l’étape suivante.

Étape 5 : Vérifier le déploiement

Une fois le déploiement terminé, utilisez la commande suivante pour vérifier que votre cluster Kubernetes est opérationnel :

az aksarc show --resource-group "<resource-group-name>" --name "<cluster-name>" --output table

Étape 6 : Se connecter au cluster

Pour vous connecter au cluster, exécutez la az connectedk8s proxy commande. La commande télécharge et exécute un fichier binaire proxy sur l’ordinateur client et extrait un fichier kubeconfig associé au cluster :
```
az connectedk8s proxy --name <cluster name> -g <resource group>
```
Vous pouvez également utiliser le client de ligne de commande Kubernetes, kubectl. Si vous utilisez Azure Cloud Shell, kubectl est déjà installé. Pour installer et exécuter kubectl localement, exécutez la az aksarc install-cli commande.

Configurez kubectl pour vous connecter à votre cluster Kubernetes à l’aide de la az aksarc get-credentials commande. Cette commande télécharge les informations d’identification et configure l’interface CLI Kubernetes pour les utiliser :
```
az aksarc get-credentials --resource-group "<resource-group-name>" --name "<cluster-name>"
```

Pour vérifier la connexion à votre cluster, exécutez la commande kubectl get. Cette commande retourne une liste des nœuds de cluster :

kubectl get nodes -A --kubeconfig .\<path to kubecofig>

L'exemple suivant présente les trois nœuds créés dans les étapes précédentes. Assurez-vous que l’état du nœud est Prêt :

NAME                                STATUS   ROLES   AGE   VERSION
aks-agentpool-27442051-vmss000000   Ready    agent   10m   v1.27.7
aks-agentpool-27442051-vmss000001   Ready    agent   10m   v1.27.7
aks-agentpool-27442051-vmss000002   Ready    agent   11m   v1.27.7

Étape 7 : Déployer un pool de nœuds à l’aide d’un modèle Azure Resource Manager (facultatif)

Similaire à l’étape 3, téléchargez le modèle et les paramètres du pool de nœuds à partir du dépôt AKS Arc et passez en revue les valeurs par défaut.

Déployer le modèle et valider les résultats à l’aide d’Azure CLI (facultatif)

Passez en revue et appliquez le modèle. Ce processus prend quelques minutes. Vous pouvez utiliser Azure CLI pour vérifier que le pool de nœuds est créé avec succès :

az deployment group create \
--name "<deployment-name>" \
--resource-group "<resource-group-name>" \
--template-file "azuredeploy.json" \
--parameters "azuredeploy.parameters.json"

az aksarc nodepool show --cluster-name "<cluster-name>" --resource-group "<resource-group-name>" --name "<nodepool-name>"

Ressources de modèle

connectedClusters

Nom	Description	active
`type`	Type de ressource.	Microsoft.Kubernetes/ConnectedClusters
`apiVersion`	Version de l’API de ressource.	2024-01-01
`name`	Nom de la ressource.	Chaîne (obligatoire) Limite de caractères : 1 à 63 Caractères valides : alphanumériques, traits de soulignement et traits d’union. Doit commencer et se terminer par un caractère alphanumérique.
`location`	Emplacement géographique dans lequel la ressource réside.	Chaîne (obligatoire).
`tags`	Balises de ressource.	Dictionnaire de noms et de valeurs d’étiquettes. Voir Balises dans les modèles.
`extendedLocation`	Emplacement étendu de la machine virtuelle.	ExtendedLocation
`identity`	Identité du cluster connecté, s’il est configuré.
`properties`	Propriétés d’un cluster connecté.

ProvisionedClusterInstances

Nom	Description	active
`type`	Type de ressource	microsoft.hybridcontainerservice/provisionedclusterinstances
`apiVersion`	Version de l’API de ressource	2024-01-01
`name`	Nom de la ressource	Chaîne (obligatoire). Ne changez pas cette valeur par défaut.
`properties`	Propriétés d’un cluster connecté.
`extendedLocation`	Emplacement étendu du cluster.	ExtendedLocation

ExtendedLocation

Nom	Description	active
`name`	ID de l’emplacement étendu.	string
`type`	Type de l’emplacement étendu.	CustomLocation

Étapes suivantes

Vue d’ensemble d’AKS Arc

Partager via