Freigeben über


Vorbereiten Ihres Azure Arc-aktivierten Kubernetes-Clusters

Wichtig

Die von Azure Arc unterstützte Vorschauversion von „Azure IoT Einsatz“ befindet sich derzeit in der Vorschauphase. Sie sollten diese Vorschausoftware nicht in Produktionsumgebungen verwenden.

Sie müssen eine neue Installation von „Azure IoT Einsatz“ bereitstellen, wenn ein allgemein verfügbares Release verfügbar wird. Sie werden kein Upgrade für eine Preview-Installation durchführen können.

Die zusätzlichen Nutzungsbestimmungen für Microsoft Azure-Vorschauen enthalten rechtliche Bedingungen. Sie gelten für diejenigen Azure-Features, die sich in der Beta- oder Vorschauversion befinden oder aber anderweitig noch nicht zur allgemeinen Verfügbarkeit freigegeben sind.

Ein Azure Arc-fähiger Kubernetes-Cluster ist eine Voraussetzung für die Bereitstellung von Azure IoT Einsatz Preview. In diesem Artikel wird beschrieben, wie Sie einen Azure Arc-fähigen Kubernetes-Cluster vorbereiten, bevor Sie Azure IoT Einsatz Preview für einen Arc-fähigen Kubernetes-Cluster bereitstellen, um Ihre eigenen Workloads auszuführen. Dieser Artikel enthält Anleitungen für Ubuntu- und Windows-Computer sowie Cloudumgebungen.

Tipp

Wenn Sie Azure IoT Einsatz bereitstellen und eine Beispielworkload ausführen möchten, lesen Sie den Schnellstart: Ausführen von Azure IoT Einsatz Preview in GitHub Codespaces mit K3s.

„Azure IoT Einsatz“ wird als eine Reihe von Kubernetes-Diensten mit Azure Arc-Unterstützung ausgeliefert und ist für die Verwendung mit CNCF-konformen Arc-überprüften Partnerprodukten vorgesehen. Derzeit hat Microsoft Azure IoT Einsatz anhand der folgenden festen Infrastruktur- und Umgebungen überprüft:

Environment Version
AKS-EE unter Windows 11 IoT Enterprise
auf einem Einzelknoten AMD Ryzen-7 (8 Kern, 3,3 GHz), 16 GB RAM
AksEdge-K3s-1.28.3-1.7.639.0
K3s unter Ubuntu 22.04.2
auf einem Einzelknoten AMD Ryzen-7 (8 Kern, 3,3 GHz), 16 GB RAM
K3s Version 1.28.5

Wichtig

Die zuvor aufgeführten Umgebungen sind produktionsähnliche Umgebungen, die von Microsoft überprüft wurden. Sie sind nicht die einzigen Umgebungen, auf denen Azure IoT Einsatz ausgeführt werden kann. Azure IoT Einsatz kann auf jedem Arc-fähigen Kubernetes-Cluster ausgeführt werden, der die systemanforderungen Azure Arc-fähigen Kubernetes-Systemanforderungenerfüllt.

Voraussetzungen

Zum Vorbereiten Ihres Azure Arc-aktivierten Kubernetes-Clusters benötigne Sie:

  • Ein Azure-Abonnement. Wenn Sie kein Azure-Abonnement besitzen, können Sie ein kostenloses Konto erstellen, bevor Sie beginnen.

  • Azure CLI, Version 2.46.0 oder höher, installiert auf Ihrem Entwicklungscomputer. Verwenden Sie az --version, um Ihre Version zu überprüfen. Bei Bedarf können Sie sie mithilfe von az upgrade aktualisieren. Weitere Informationen finden Sie unter Installieren der Azure CLI.

  • Die Azure IoT Einsatz-Erweiterung für die Azure CLI. Verwenden Sie den folgenden Befehl, um die Erweiterung hinzuzufügen oder auf die neueste Version zu aktualisieren:

    az extension add --upgrade --name azure-iot-ops
    
  • Hardware, die die Systemanforderungen erfüllt:

Erstellen eines Clusters

Dieser Abschnitt enthält Schritte zum Vorbereiten und Aktivieren von Clustern in validierten Umgebungen unter Linux und Windows sowie GitHub Codespaces in der Cloud.

Azure Kubernetes Service Edge Essentials ist eine lokale Kubernetes-Implementierung von Azure Kubernetes Service (AKS), mit dem ausgeführte Containeranwendungen im großen Stil automatisiert werden. AKS Edge Essentials enthält eine von Microsoft unterstützte Kubernetes-Plattform, die eine einfache Kubernetes-Verteilung mit geringem Platzbedarf und einfacher Installation umfasst, sodass Sie Kubernetes auf PC-Klasse oder „leichter“ Edgehardware bereitstellen können.

Das Skript AksEdgeQuickStartForAio.ps1 automatisiert den Prozess der Erstellung und Verbindung eines Clusters und ist der empfohlene Weg für die Bereitstellung von Azure IoT Einsatz auf AKS Edge Essentials.

  1. Öffnen Sie ein PowerShell-Fenster mit erhöhten Rechten und wechseln Sie in das Verzeichnis eines Arbeitsordners.

  2. Führen Sie die folgenden Befehle aus und ersetzen Sie die Platzhalterwerte durch Ihre Informationen:

    Platzhalter Wert
    SUBSCRIPTION_ID Die ID Ihres Azure-Abonnements. Wenn Sie Ihre Abonnement-ID nicht kennen, lesen Sie So finden Sie Ihr Azure-Abonnement.
    TENANT_ID Die ID Ihres Microsoft Entra-Mandanten Wenn Sie Ihre Mandanten-ID nicht kennen, lesen Sie So finden Sie Ihren Microsoft Entra-Mandanten.
    RESOURCE_GROUP_NAME Der Name einer vorhandenen Ressourcengruppe oder ein Namen für eine neue zu erstellende Ressourcengruppe.
    LOCATION Eine Azure-Region in Ihrer Nähe. Die Liste aller aktuell unterstützten Azure-Regionen finden Sie unter Unterstützte Regionen.
    CLUSTER_NAME Ein Name für den zu erstellenden neuen Cluster.
    $url = "https://raw.githubusercontent.com/Azure/AKS-Edge/main/tools/scripts/AksEdgeQuickStart/AksEdgeQuickStartForAio.ps1"
    Invoke-WebRequest -Uri $url -OutFile .\AksEdgeQuickStartForAio.ps1
    Unblock-File .\AksEdgeQuickStartForAio.ps1
    Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope Process -Force
    .\AksEdgeQuickStartForAio.ps1 -SubscriptionId "<SUBSCRIPTION_ID>" -TenantId "<TENANT_ID>" -ResourceGroupName "<RESOURCE_GROUP_NAME>"  -Location "<LOCATION>"  -ClusterName "<CLUSTER_NAME>"
    

    Wenn während der Bereitstellung Probleme auftreten, z. B. wenn der Computer im Rahmen dieses Prozesses neu gestartet wird, führen Sie den gesamten Satz von Befehlen erneut aus.

  3. Führen Sie den folgenden Befehl aus, um zu überprüfen, ob die Bereitstellung erfolgreich war:

    Import-Module AksEdge
    Get-AksEdgeDeploymentInfo
    

    In der Ausgabe des Get-AksEdgeDeploymentInfo Befehls sollten Sie sehen, dass der Arc-Status des Clusters Connected ist.

Machen Sie Ihr Cluster Arc-fähig

Verbinden Sie Ihren Cluster mit Azure Arc, damit er remote verwaltet werden kann.

Das Skript AksEdgeQuickStartForAio.ps1, das Sie im vorherigen Abschnitt ausgeführt haben, hat die Schritte zur Verbindung Ihres Clusters übernommen. Sie müssen keine zusätzlichen Schritte zur Arc-Aktivierung ausführen.

Überprüfen Ihres Clusters

Um zu überprüfen, ob Ihr Cluster für die Bereitstellung von Azure IoT Einsatz bereit ist, können Sie den Hilfsbefehl verify-host in der Azure IoT Einsatz-Erweiterung für Azure CLI verwenden. Wenn Sie den Clusterhost ausführen, überprüft dieser Hilfsbefehl die Konnektivität mit Azure Resource Manager- und Microsoft Container-Registrierungsendpunkten.

az iot ops verify-host

Führen Sie den folgenden Befehl aus, um zu überprüfen, ob Ihr Kubernetes-Cluster jetzt Azure Arc-aktiviert ist:

kubectl get deployments,pods -n azure-arc

Die Ausgabe sieht wie folgt aus:

NAME                                         READY   UP-TO-DATE   AVAILABLE   AGE
deployment.apps/clusterconnect-agent         1/1     1            1           10m
deployment.apps/extension-manager            1/1     1            1           10m
deployment.apps/clusteridentityoperator      1/1     1            1           10m
deployment.apps/controller-manager           1/1     1            1           10m
deployment.apps/flux-logs-agent              1/1     1            1           10m
deployment.apps/cluster-metadata-operator    1/1     1            1           10m
deployment.apps/extension-events-collector   1/1     1            1           10m
deployment.apps/config-agent                 1/1     1            1           10m
deployment.apps/kube-aad-proxy               1/1     1            1           10m
deployment.apps/resource-sync-agent          1/1     1            1           10m
deployment.apps/metrics-agent                1/1     1            1           10m

NAME                                              READY   STATUS    RESTARTS        AGE
pod/clusterconnect-agent-5948cdfb4c-vzfst         3/3     Running   0               10m
pod/extension-manager-65b8f7f4cb-tp7pp            3/3     Running   0               10m
pod/clusteridentityoperator-6d64fdb886-p5m25      2/2     Running   0               10m
pod/controller-manager-567c9647db-qkprs           2/2     Running   0               10m
pod/flux-logs-agent-7bf6f4bf8c-mr5df              1/1     Running   0               10m
pod/cluster-metadata-operator-7cc4c554d4-nck9z    2/2     Running   0               10m
pod/extension-events-collector-58dfb78cb5-vxbzq   2/2     Running   0               10m
pod/config-agent-7579f558d9-5jnwq                 2/2     Running   0               10m
pod/kube-aad-proxy-56d9f754d8-9gthm               2/2     Running   0               10m
pod/resource-sync-agent-769bb66b79-z9n46          2/2     Running   0               10m
pod/metrics-agent-6588f97dc-455j8                 2/2     Running   0               10m

Erstellen von Websites

Eine Site ist eine Sammlung von Azure IoT Einsatz-Instanzen. Websites gruppieren in der Regel Instanzen nach physischem Standort und erleichtern OT-Benutzern das Auffinden und Verwalten von Ressourcen. Ein IT-Administrator erstellt Websites und weist ihnen Azure IoT Einsatz-Instanzen zu. Weitere Informationen finden Sie unter Was ist der Azure Arc-Website-Manager (Vorschau)?.

Nächste Schritte

Sie haben nun einen Azure Arc-fähigen Kubernetes-Cluster, den Sie für Azure IoT Einsatz bereitstellen können.