AKS Edge Essentials – Schnellstarthandbuch

In diesem Schnellstarthandbuch wird beschrieben, wie Sie einen Azure Kubernetes Service (AKS) Edge Essentials Single-Machine K3S Linux-Only-Cluster einrichten.

Voraussetzungen

• Siehe die Systemanforderungen. Stellen Sie für diese Schnellstartanleitung sicher, dass Sie mindestens 4,5 GB RAM frei, 4 vCPUs und 20 GB freien Speicherplatz haben.
• Betriebssystemanforderungen: Installieren Sie Windows 10/11 IoT Enterprise/Enterprise/Pro auf Ihrem Computer, und aktivieren Sie Windows. Verwenden Sie die neueste Clientversion 22H2 (Betriebssystembuild 19045) oder Server 2022 (Betriebssystembuild 20348). Sie können hier eine Version von Windows 10 oder Windows 11 herunterladen.
• Sehen Sie sich die Microsoft-Software-Lizenzbedingungen an, da sie für Ihre Nutzung der Software gelten. Durch die Verwendung des AksEdgeQuickStart Skripts akzeptieren Sie die Microsoft-Software-Lizenzbedingungen, und die AcceptEULA Kennzeichnung ist auf die Annahme der Lizenzbedingungen festgelegt true .
• Rufen Sie Ihre Azure-Abonnementparameter ab: Um Ihren Cluster mit Azure Arc zu verbinden, müssen Sie diese Parameter angeben. Wenn Sie diese Parameter überspringen, wird die Arc-Verbindung übersprungen, der Cluster wird jedoch weiterhin bereitgestellt:
  • Ihre Anmeldeinformationen: Erforderlich für die interaktive Authentifizierung in Azure mithilfe der Azure CLI. Ihr Konto sollte über eine dieser Rollen Owner, Contributor oder Administrator verfügen.
  • Ihre Abonnement-ID: Wählen Sie im Azure-Portal das verwendete Abonnement aus, und suchen Sie nach der Abonnement-ID<subscription-id>(GUID).
  • Ihre Mandanten-ID<tenant-id>: Suchen Sie im Azure-Portal nach Microsoft Entra-ID, die Sie zur Seite "Standardverzeichnis " führt. Suchen Sie nach der Mandanten-ID (GUID).
  • Der Standort (Azure-Region):<location>Wo Ihre Ressourcen erstellt werden sollen. Informationen zu den von und Diensten unterstützten Standorten finden Sie unter Azure Arc enabled servers.Azure Arc enabled Kubernetes Wählen Sie eine Region aus, in der beide unterstützt werden.

Schritt 1: Herunterladen eines Skripts für eine einfache Bereitstellung

Laden Sie das AksEdgeQuickStart.ps1 Skript in einen Arbeitsordner herunter. Je nach Richtliniensetup auf Ihrem Computer müssen Sie die Blockierung der Datei möglicherweise aufheben, bevor Sie sie ausführen, und dann Set-ExecutionPolicy ausführen, um die Skriptausführung zuzulassen.

Öffnen Sie ein PowerShell-Fenster mit erhöhten Rechten, und ändern Sie das Verzeichnis in einen Arbeitsordner:

$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

Dieses Skript automatisiert die folgenden Schritte:

• Im Arbeitsordner lädt das Skript das GitHub-Archiv von Azure/AKS-Edge herunter und entpackt den Ordner AKS-Edge-main (oder AKS-Edge-tag<>). In diesem Schritt wird standardmäßig die aktuelle Hauptverzweigung heruntergeladen.
• Verwendet das Skript AksEdgeAzureSetup , um den Benutzer aufzufordern, sich mit seinen Azure-Anmeldeinformationen beim Azure-Portal anzumelden und die folgenden Aufgaben auszuführen:
  • Installiert Azure CLI.
  • Erstellt eine Ressourcengruppe "aksedge-rp".
  • Erstellt einen Dienstprinzipal aksedge-sp mit mitwirkender Rolle, die auf den Aksedge-rp-Ressourcengruppenbereich beschränkt ist. Wenn der Dienstprinzipal bereits vorhanden ist, setzt er sein Kennwort zurück. Dieser Dienstprinzipal wird verwendet, um eine Verbindung mit Azure Arc herzustellen.
  • Registriert die Ressourcenanbieter Microsoft.HybridCompute, Microsoft.GuestConfiguration, Microsoft.HybridConnectivity, Microsoft.Kubernetes, Microsoft.KubernetesConfiguration und Microsoft.ExtendedLocation.
• Ruft die Funktion Start-AideWorkflow auf, die die folgenden Tasks ausführt:
  • Lädt die MSI-Datei von AKS Edge Essentials herunter und installiert sie.
  • Installieren der erforderlichen Hostbetriebssystemfeatures (Install-AksEdgeHostFeatures) Der Computer kann neu gestartet werden, wenn Hyper-V aktiviert ist, und Sie müssen das Skript erneut starten.
  • Stellt einen einzelnen Computercluster mit internem Switch bereit (nur Linux-Knoten).
• Ruft die Connect-AideArc Funktion auf, wenn die Azure-Parameter bereitgestellt werden. Diese Funktion führt die folgenden Aufgaben aus:
  • Installieren des Azure Connected Machine-Agents und Verbinden des Hostcomputers mit Arc für Servers
  • Verbinden des bereitgestellten Clusters mit Arc für verbundene Kubernetes-Instanzen

Schritt 2: Bereitstellen von AKS Edge Essentials

Führen Sie in einer PowerShell-Eingabeaufforderung mit erhöhten Rechten das AksEdgeQuickStart.ps1 Skript aus. Dieses Skript bringt einen K3s-Cluster auf:

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

Um die Kubernetes-Version zu installieren, geben Sie das -UseK8s Flag an:

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

Das Skript installiert AKS Edge Essentials und verbindet Ihren Cluster mit Azure Arc.

Schritt 3: Überprüfen der Bereitstellung

1. Vergewissern Sie sich, dass die Bereitstellung erfolgreich war, indem Sie Folgendes ausführen:

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

   Die folgende Abbildung zeigt Pods auf einem K3S-Cluster:

   

2. Sie können Ihren Cluster im Azure-Portal anzeigen, wenn Sie zu Ihrer Ressourcengruppe navigieren:

   

3. Wählen Sie im linken Bereich die Namespaces unter Kubernetes-Ressourcen (Vorschau) aus:

   

4. Um Ihre Kubernetes-Ressourcen anzuzeigen, benötigen Sie ein Bearertoken:

   

5. Führen Sie die Ausführung Get-AksEdgeManagedServiceToken aus, um Ihr Diensttoken abzurufen:

   

6. Jetzt können Sie Ressourcen in Ihrem Cluster anzeigen. Unter Workloads werden die Pods angezeigt, die in Ihrem Cluster ausgeführt werden.

   kubectl get pods --all-namespaces
   

   

Sie verfügen jetzt über einen arc-verbundenen AKS Edge Essentials K3S-Cluster mit einem Linux-Knoten. Sie können die Bereitstellung einer Beispiel-Linux-Anwendung auf diesem Cluster erkunden.

Nächste Schritte

• Grundlegendes zu Bereitstellungsoptionen.
• Stellen Sie eine Linux-Anwendung bereit.
• Fügen Sie einen Windows-Knoten hinzu.
• Übersicht
• Deinstallieren des AKS-Clusters