Guide de démarrage rapide AKS Edge Essentials

Ce guide de démarrage rapide explique comment configurer un cluster Azure Kubernetes Service (AKS) Edge Essentials à machine unique K3S Linux.

Prérequis

• Consultez la configuration système requise. Pour ce guide de démarrage rapide, vérifiez que vous disposez d’un minimum de 4,5 Go de RAM, 4 processeurs virtuels et 20 Go d’espace disque libre.
• Configuration requise pour le système d’exploitation : installez Windows 10/11 IoT Enterprise/Enterprise/Pro sur votre ordinateur et activez Windows. Utilisez la dernière version cliente 22H2 (build du système d’exploitation 19045) ou Server 2022 (build de système d’exploitation 20348). Vous pouvez télécharger une version de Windows 10 ici ou Windows 11 ici.
• Consultez les termes du contrat de licence logiciel Microsoft tel qu’ils s’appliquent à votre utilisation du logiciel. En utilisant le AksEdgeQuickStart script, vous acceptez les termes du contrat de licence logiciel Microsoft et l’indicateur AcceptEULA est défini pour true indiquer l’acceptation des termes du contrat de licence.
• Obtenez vos paramètres d’abonnement Azure : pour connecter votre cluster à Azure Arc, vous devez fournir ces paramètres. Si vous ignorez ces paramètres, la connexion Arc est ignorée, mais le cluster est toujours déployé :
  • Informations d’identification de connexion : requis pour l’authentification interactive dans Azure à l’aide d’Azure CLI. Votre compte doit avoir l’un de ces rôles Owner, Contributorou Administrator.
  • VOTRE ID d’abonnement<subscription-id>: dans le Portail Azure, sélectionnez l’abonnement que vous utilisez et recherchez l’ID d’abonnement (GUID).
  • Votre ID<tenant-id> de locataire : dans le portail Azure, recherchez l’ID Microsoft Entra, qui vous dirige vers la page Répertoire par défaut . Recherchez l’ID de locataire (GUID).
  • Emplacement (région Azure)<location>: où vous souhaitez que vos ressources soient créées. Consultez Azure Arc par région pour connaître les emplacements pris en charge par les services Azure Arc enabled servers et Azure Arc enabled Kubernetes. Choisissez une région dans laquelle les deux sont prises en charge.

Étape 1 : Télécharger le script pour un déploiement facile

Téléchargez le AksEdgeQuickStart.ps1 script dans un dossier de travail. Selon la configuration de la stratégie sur votre ordinateur, vous devrez peut-être débloquer le fichier avant de l’exécuter et l’exécuter Set-ExecutionPolicy pour autoriser l’exécution du script.

Ouvrez une fenêtre PowerShell avec élévation de privilèges et remplacez le répertoire par un dossier de travail :

$url = "https://raw.githubusercontent.com/Azure/AKS-Edge/main/tools/scripts/AksEdgeQuickStart/AksEdgeQuickStart.ps1"
Invoke-WebRequest -Uri $url -OutFile .\AksEdgeQuickStart.ps1
Unblock-File .\AksEdgeQuickStart.ps1
Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope Process -Force

Ce script automatise les étapes suivantes :

• Dans le dossier de travail, le script télécharge l’archive GitHub d’Azure/AKS-Edge et décompresse dans un dossier AKS-Edge-main (ou <).> Par défaut, cette étape télécharge la branche principale actuelle.
• Utilise le script AksEdgeAzureSetup pour inviter l’utilisateur à se connecter au portail Azure avec ses informations d’identification Azure et effectue les tâches suivantes :
  • Installe Azure CLI.
  • Crée un groupe de ressources aksedge-rp.
  • Crée un principal de service nommé aksedge-sp avec le rôle Contributeur limité à l’étendue du groupe de ressources aksedge-rp. Si le principal de service existe déjà, son mot de passe est réinitialisé. Ce principal de service est utilisé pour se connecter à Azure Arc.
  • Inscrit les fournisseurs de ressources Microsoft.HybridCompute, Microsoft.GuestConfiguration, Microsoft.HybridConnectivity, Microsoft.Kubernetes, Microsoft.KubernetesConfiguration et Microsoft.ExtendedLocation.
• Appelle la fonction Start-AideWorkflow qui effectue les tâches suivantes :
  • Télécharge et installe le MSI AKS Edge Essentials.
  • Installe les fonctionnalités requises du système d’exploitation hôte (Install-AksEdgeHostFeatures). L’ordinateur peut redémarrer lorsque Hyper-V est activé et vous devez redémarrer le script à nouveau.
  • Déploie un seul cluster d’ordinateurs avec commutateur interne (nœud Linux uniquement).
• Appelle la Connect-AideArc fonction si les paramètres Azure sont fournis. Cette fonction effectue les tâches suivantes :
  • Installe Azure Connected Machine Agent et connecte l’ordinateur hôte à Arc pour serveurs.
  • Connecte le cluster déployé à Arc pour les clusters Kubernetes connectés.

Étape 2 : Déployer AKS Edge Essentials

Dans une invite PowerShell avec élévation de privilèges, exécutez le script AksEdgeQuickStart.ps1. Ce script affiche un cluster K3s :

.\AksEdgeQuickStart.ps1 -SubscriptionId "<subscription-id>" -TenantId "<tenant-id>" -Location "<location>"

Pour installer la version de Kubernetes, spécifiez l’indicateur -UseK8s :

.\AksEdgeQuickStart.ps1 -SubscriptionId "<subscription-id>" -TenantId "<tenant-id>" -Location "<location>" -UseK8s

Le script installe AKS Edge Essentials et connecte votre cluster à Azure à l’aide d’Azure Arc.

Étape 3 : Vérifier le déploiement

1. Vérifiez que le déploiement a réussi en exécutant :

   kubectl get nodes -o wide
   kubectl get pods -A -o wide
   

   L’image suivante montre des pods sur un cluster K3S :

   

2. Vous pouvez afficher votre cluster dans le Portail Azure si vous accédez à votre groupe de ressources :

   

3. Dans le volet gauche, sélectionnez les espaces de noms sous ressources Kubernetes (préversion) :

   

4. Pour afficher vos ressources Kubernetes, vous avez besoin d’un jeton d'accès.

   

5. Exécutez Get-AksEdgeManagedServiceToken pour récupérer votre jeton de service :

   

6. Vous pouvez maintenant voir les ressources sur votre cluster. Le volet Charges de travail montre les pods en cours d’exécution sur votre cluster.

   kubectl get pods --all-namespaces
   

   

Vous disposez maintenant d’un cluster AKS Edge Essentials K3S connecté à Arc avec un nœud Linux. Vous pouvez explorer le déploiement d’un exemple d’application Linux sur ce cluster.

Étapes suivantes

• Comprendre les options de déploiement.
• Déployez une application Linux.
• Ajoutez un nœud Windows.
• Vue d’ensemble
• Désinstaller un cluster AKS