Schnellstartanleitung für AKS Edge Essentials

In dieser Schnellstartanleitung wird beschrieben, wie Sie einen Azure Kubernetes Service Edge Essentials-Einzelcomputer-K3S-Linux-Cluster einrichten.

Voraussetzungen

• Siehe die Systemanforderungen. Stellen Sie für diese Schnellstartanleitung sicher, dass Sie mindestens 4,5 GB ramfrei, 4 vCPUs und 20 GB freien Speicherplatz auf dem Datenträger haben.
• Betriebssystemanforderungen: Installieren Sie Windows 10/11 IoT Enterprise/Enterprise/Pro auf Ihrem Computer, und aktivieren Sie Windows. Es wird empfohlen, die neueste Clientversion 22H2 (Betriebssystembuild 19045) oder Server 2022 (Betriebssystembuild 20348) zu verwenden. Sie können hier eine Version von Windows 10 herunterladen oder hier Windows 11.
• Sehen Sie sich die Microsoft-Software-Lizenzbedingungen an, wie sie für Ihre Nutzung der Software gelten. Durch die Verwendung des AksEdgeQuickStart Skripts akzeptieren Sie die Microsoft-Software-Lizenzbedingungen, und das AcceptEULA Flag wird auf die Zustimmung zu true den Lizenzbedingungen festgelegt.
• Abrufen Ihrer Azure-Abonnementparameter: Zum Verbinden Ihres Clusters mit Azure Arc müssen Sie diese Parameter angeben. Wenn Sie diese Parameter überspringen, wird die Arc-Verbindung übersprungen, aber der Cluster wird weiterhin bereitgestellt.
  • Ihre Anmeldeinformationen: Erforderlich für die interaktive Anmeldung bei Azure mithilfe der Azure CLI. Ihr Konto sollte über eine dieser Rollen Owner oder oder Contributor verfügen Administrator.
  • Ihre Abonnement-ID<subscription-id>: Wählen Sie im Azure-Portal das abonnement aus, das Sie verwenden, und suchen Sie nach der Abonnement-ID (GUID).
  • Ihre Mandanten-ID<tenant-id>: Suchen Sie im Azure-Portal nach Microsoft Entra ID, sodass Sie zur Seite Standardverzeichnis gelangen sollten. Suchen Sie nach der Mandanten-ID (GUID).
  • Der Standort (Azure-Region):<location>Der Speicherort, an dem Ihre Ressourcen erstellt werden sollen. Unter Azure Arc nach Region finden Sie die von Azure Arc enabled servers und Azure Arc enabled Kubernetes Diensten unterstützten Standorte. Wählen Sie eine Region aus, in der beide unterstützt werden.

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

Laden Sie das AksEdgeQuickStart.ps1 Skript in einen Arbeitsordner herunter. Abhängig von der Richtlinieneinrichtung auf Ihrem Computer müssen Sie die Blockierung der Datei möglicherweise aufheben, bevor Sie ausführen und ausführen Set-ExecutionPolicy , 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 in einen Ordner AKS-Edge-Standard (oder AKS-Edge-tag<>). Standardmäßig wird dadurch der aktuelle Standard-Branch heruntergeladen.
• Verwendet das Skript AksEdgeAzureSetup, um den Benutzer aufzufordern, sich mit seinen Azure-Anmeldeinformationen beim Azure-Portal anzumelden, und führt die folgenden Aufgaben aus:
  • Installiert die Azure CLI.
  • Erstellt eine Ressourcengruppe aksedge-rp.
  • Erstellt einen Dienstprinzipal aksedge-sp mit der Rolle Mitwirkender , die auf den Ressourcengruppenbereich aksedge-rp 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 Start-AideWorkflow Funktion auf, die die folgenden Aufgaben ausführt:
  • Lädt die MSI von AKS Edge Essentials herunter und installiert sie.
  • Installiert die 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 Funktion auf Connect-AideArc , wenn die Azure-Parameter bereitgestellt werden. Diese Funktion führt die folgenden Aufgaben aus:
  • Installiert den Azure Connected Machine-Agent und verbindet den Hostcomputer mit Arc für Server.
  • Verbindet den bereitgestellten Cluster mit Arc für verbundene Kubernetes.

Schritt 2: Bereitstellen von AKS Edge Essentials

Führen Sie in einer PowerShell-Eingabeaufforderung mit erhöhten Rechten das AksEdgeQuickStart.ps1 Skript aus. Dadurch wird ein K3s-Cluster angezeigt:

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

Geben Sie für die Installation der K8s-Version 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 mithilfe von Azure Arc mit Azure.

Tipp

Wenn Hyper-V auf Ihrem Computer nicht aktiviert war, aktiviert das Schnellstartskript Hyper-V und startet Ihren Computer neu. Führen Sie das AksEdgeQuickStart Skript nach dem Neustart erneut aus.

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 in 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 unter Kubernetes-Ressourcen (Vorschau) die Namespaces aus:

   

4. Zum Anzeigen Ihrer Kubernetes-Ressourcen benötigen Sie ein Bearertoken:

   

5. Sie können ausführen Get-AksEdgeManagedServiceToken , um Ihr Diensttoken abzurufen:

   

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

   kubectl get pods --all-namespaces
   

   

Sie verfügen jetzt über einen mit Arc verbundenen AKS Edge Essentials K3S-Cluster mit einem Linux-Knoten. Sie können die Bereitstellung einer Linux-Beispielanwendung in diesem Cluster erkunden.

Tipp

Wenn Sie beim Ausführen des AksEdgeQuickStart.ps1 Skripts keine Azure-Abonnementdetails angegeben haben, können Sie weiterhin eine Verbindung mit Azure Arc herstellen, indem Sie die Schritte in diesem Artikel ausführen.

Nächste Schritte

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