Freigeben über


Ausführen von virtuellen Computern vom Typ „Azure IoT Edge unter Ubuntu“

Gilt für:Häkchen für IoT Edge 1.5 IoT Edge 1.5

Wichtig

IoT Edge 1.5 LTS ist das unterstützte Release. IoT Edge 1.4 LTS wurde am 12. November 2024 eingestellt. Wenn Sie ein früheres Release verwenden, finden Sie weitere Informationen unter Aktualisieren von IoT Edge.

Die Azure IoT Edge-Laufzeit wandelt ein Gerät in ein IoT Edge-Gerät um. Stellen Sie die Laufzeit auf Geräten so klein wie ein Raspberry Pi oder so groß wie ein Industrieserver bereit. Nachdem Sie die IoT Edge-Laufzeit eingerichtet haben, stellen Sie Geschäftslogik aus der Cloud auf dem Gerät bereit.

Weitere Informationen zur Funktionsweise der IoT Edge-Laufzeit und der zugehörigen Komponenten finden Sie unter Azure IoT Edge-Runtime und deren Architektur.

In diesem Artikel werden die Schritte zum Bereitstellen eines virtuellen Ubuntu-Computers mit der Azure IoT Edge-Laufzeit aufgeführt, die mithilfe einer bereitgestellten Geräteverbindungszeichenfolge installiert und konfiguriert ist. Die Bereitstellung verwendet eine cloud-init-basierteAzure Resource Manager-Vorlage aus dem Projektarchiv „iotedge-vm-deploy“.

Beim ersten Start installiert der virtuelle Computer die neueste Version der Azure IoT Edge-Laufzeit mit Cloud-init. Außerdem wird vor dem Start der Laufzeit eine bereitgestellte Verbindungszeichenfolge festgelegt, sodass Sie das IoT Edge-Gerät schnell einrichten und verbinden können, ohne eine SSH- oder Remotedesktopsitzung zu starten.

Bereitstellen mithilfe der Schaltfläche „In Azure bereitstellen“

Mit der Schaltfläche "Bereitstellen in Azure" können Sie Azure Resource Manager-Vorlagen schnell von GitHub bereitstellen. In diesem Abschnitt wird gezeigt, wie Sie die Schaltfläche "Bereitstellen in Azure " im Projekt-Repository "iotedge-vm-deploy " verwenden.

  1. Stellen Sie eine azure IoT Edge-fähige Linux-VM mithilfe der Vorlage "iotedge-vm-deploy Azure Resource Manager" bereit. Wählen Sie zunächst die folgende Schaltfläche aus:

    Schaltfläche

  2. Geben Sie im neuen Fenster Werte für die verfügbaren Formularfelder ein:

    Screenshot der Vorlage

    Feld BESCHREIBUNG
    Abonnement Das aktive Azure-Abonnement, in dem der virtuelle Computer bereitgestellt werden soll.
    Ressourcengruppe Eine vorhandene oder neue Ressourcengruppe, die den virtuellen Computer und die zugehörigen Ressourcen enthält.
    Region Die geografische Region , in der Sie den virtuellen Computer bereitstellen. Dieser Wert ist standardmäßig der Speicherort der ausgewählten Ressourcengruppe.
    Präfix der DNS-Bezeichnung Ein erforderlicher Wert, den Sie als Präfix für den Hostnamen des virtuellen Computers auswählen.
    Benutzername des Administrators Ein Benutzername mit Root-Rechten für die Bereitstellung.
    Verbindungszeichenfolge für das Gerät Eine Geräteverbindungszeichenfolge für ein Gerät, das Sie in Ihrem IoT-Hub erstellt haben.
    VM-Größe Die Größe des bereitzustellenden virtuellen Computers.
    Ubuntu-Betriebssystemversion Die Version des Ubuntu-Betriebssystems, die auf dem virtuellen Basiscomputer installiert werden soll.
    Authentifizierungstyp Wählen Sie sshPublicKey oder das Kennwort basierend auf Ihrer Einstellung aus.
    Administratorkennwort oder Schlüssel Der öffentliche SSH-Schlüssel oder der Kennwortwert, abhängig vom von Ihnen ausgewählten Authentifizierungstyp.

    Wählen Sie Next : Review + create aus, um die Bedingungen zu überprüfen, und wählen Sie dann Erstellen aus, um die Bereitstellung zu starten.

  3. Überprüfen Sie, ob die Bereitstellung erfolgreich abgeschlossen ist. Die Ressource des virtuellen Computers wird in der ausgewählten Ressourcengruppe bereitgestellt. Notieren Sie sich den Computernamen, der das Format vm-0000000000000 hat. Notieren Sie sich auch den zugeordneten DNS-Namen, der das Format „<dnsLabelPrefix>.<location>.cloudapp.azure.com“ hat.

    Den DNS-Namen finden Sie im Abschnitt "Übersicht" des neuen virtuellen Computers im Azure-Portal.

    Screenshot des DNS-Namens der IoT Edge-VM.

  4. Wenn Sie nach dem Setup eine SSH-Verbindung mit diesem virtuellen Computer herstellen möchten, verwenden Sie den zugeordneten DNS-Namen mit folgendem Befehl: ssh <adminUsername>@<DNS_Name>.

Bereitstellen über die Azure-Befehlszeilenschnittstelle

  1. Vergewissern Sie sich wie folgt, dass die IoT-Erweiterung der Azure-Befehlszeilenschnittstelle installiert ist:

    az extension add --name azure-iot
    
  2. Wenn Sie die Azure-Befehlszeilenschnittstelle auf Ihrem Desktop verwenden, melden Sie sich als Nächstes an:

    az login
    
  3. Wenn Sie mehrere Abonnements haben, wählen Sie das Abonnement aus, das Sie verwenden möchten:

    1. Listen Sie Ihre Abonnements auf:

      az account list --output table
      
    2. Kopieren Sie das Feld "SubscriptionID" für das Abonnement, das Sie verwenden möchten.

    3. Legen Sie Ihr Arbeitsabonnement mit der ID fest, die Sie kopiert haben:

      az account set -s <SubscriptionId>
      
  4. Erstellen Sie eine neue Ressourcengruppe (oder geben Sie in den nächsten Schritten eine vorhandene Ressourcengruppe an):

    az group create --name IoTEdgeResources --location westus2
    
  5. Erstellen Sie einen neuen virtuellen Computer:

    Um einen authenticationType von passwordzu verwenden, verwenden Sie das folgende Beispiel:

    az deployment group create \
    --resource-group IoTEdgeResources \
    --template-uri "https://raw.githubusercontent.com/Azure/iotedge-vm-deploy/main/edgeDeploy.json" \
    --parameters dnsLabelPrefix='my-edge-vm1' \
    --parameters adminUsername='<REPLACE_WITH_USERNAME>' \
    --parameters deviceConnectionString=$(az iot hub device-identity connection-string show --device-id <REPLACE_WITH_DEVICE-NAME> --hub-name <REPLACE-WITH-HUB-NAME> -o tsv) \
    --parameters authenticationType='password' \
    --parameters adminPasswordOrKey="<REPLACE_WITH_SECRET_PASSWORD>"
    

    Wenn Sie sich mit einem SSH-Schlüssel authentifizieren möchten, geben Sie dazu einen authenticationType von sshPublicKey und dann den Wert des SSH-Schlüssels im Parameter adminPasswordOrKey an. Siehe folgendes Beispiel:

    #Generate the SSH Key
    ssh-keygen -m PEM -t rsa -b 4096 -q -f ~/.ssh/iotedge-vm-key -N ""
    
    #Create a VM using the iotedge-vm-deploy script
    az deployment group create \
    --resource-group IoTEdgeResources \
    --template-uri "https://raw.githubusercontent.com/Azure/iotedge-vm-deploy/main/edgeDeploy.json" \
    --parameters dnsLabelPrefix='my-edge-vm1' \
    --parameters adminUsername='<REPLACE_WITH_USERNAME>' \
    --parameters deviceConnectionString=$(az iot hub device-identity connection-string show --device-id <REPLACE_WITH_DEVICE-NAME> --hub-name <REPLACE-WITH-HUB-NAME> -o tsv) \
    --parameters authenticationType='sshPublicKey' \
    --parameters adminPasswordOrKey="$(< ~/.ssh/iotedge-vm-key.pub)"
    
  6. Überprüfen Sie, ob die Bereitstellung erfolgreich abgeschlossen wurde. In der ausgewählten Ressourcengruppe sollte eine VM-Ressource bereitgestellt sein. Notieren Sie sich den Computernamen, der sich im Format vm-0000000000000befindet. Notieren Sie sich auch den zugeordneten DNS-Namen, der das Format „<dnsLabelPrefix>.<location>.cloudapp.azure.com“ hat.

    Sie können den DNS-Namen aus der JSON-formatierten Ausgabe des vorherigen Schritts im Abschnitt für Ausgaben als Teil des öffentlichen SSH-Eintrags abrufen. Verwenden Sie diesen Wert, um SSH auf dem neu bereitgestellten Computer zu verwenden.

    "outputs": {
      "public SSH": {
        "type": "String",
        "value": "ssh <adminUsername>@<DNS_Name>"
      }
    }
    

    Sie können auch den DNS-Namen aus dem Abschnitt "Übersicht" des neu bereitgestellten virtuellen Computers im Azure-Portal abrufen.

    Screenshot des DNS-Namens der IoT Edge-VM.

  7. Wenn Sie nach dem Setup eine SSH-Verbindung mit diesem virtuellen Computer herstellen möchten, verwenden Sie den zugeordneten DNS-Namen mit folgendem Befehl: ssh <adminUsername>@<DNS_Name>.

Nächste Schritte

Nachdem Sie nun ein IoT Edge-Gerät mit installierter Laufzeit bereitgestellt haben, stellen Sie IoT Edge-Module bereit.

Wenn Sie Probleme beim Installieren der IoT Edge-Runtime haben, lesen Sie die Problembehandlungsseite .

Informationen zum Aktualisieren einer vorhandenen Installation auf die neueste Version von IoT Edge finden Sie unter Aktualisieren des IoT Edge-Sicherheitsdaemons und der Laufzeit.

Wenn Sie Ports öffnen möchten, um über SSH oder andere eingehende Verbindungen auf den virtuellen Computer zuzugreifen, lesen Sie die Dokumentation zu Azure Virtual Machines zum Öffnen von Ports und Endpunkten zu einer Linux-VM.