Schnellstart: Bereitstellen Ihres ersten IoT Edge-Moduls auf einem Linux-GerätQuickstart: Deploy your first IoT Edge module to a Linux device

Mit Azure IoT Edge werden die Vorteile der Cloud auf Ihre IoT-Geräte übertragen.Azure IoT Edge moves the power of the cloud to your Internet of Things devices. In dieser Schnellstartanleitung erfahren Sie, wie Sie die Cloudschnittstelle für die Remotebereitstellung von vordefiniertem Code auf einem IoT Edge-Gerät verwenden.In this quickstart, learn how to use the cloud interface to deploy prebuilt code remotely to an IoT Edge device.

In dieser Schnellstartanleitung wird Folgendes vermittelt:In this quickstart you learn how to:

  1. Erstellen Sie einen IoT Hub.Create an IoT Hub.
  2. Registrieren eines IoT Edge-Geräts für Ihren IoT HubRegister an IoT Edge device to your IoT hub.
  3. Installieren und Starten der IoT Edge-Runtime auf Ihrem GerätInstall and start the IoT Edge runtime on your device.
  4. Durchführen der Remotebereitstellung eines Moduls auf einem IoT Edge-GerätRemotely deploy a module to an IoT Edge device.

Diagramm – Schnellstart-Architektur für Geräte und Cloud

In dieser Schnellstartanleitung erfahren Sie Schritt für Schritt, wie Sie einen virtuellen Azure-Computer erstellen, der als IoT Edge-Gerät konfiguriert ist.This quickstart walks you through creating an Azure virtual machine that's configured to be IoT Edge device. Anschließend können Sie ein Modul aus dem Azure-Portal auf Ihrem Gerät bereitstellen.Then you can deploy a module from the Azure portal to your device. Das Modul, das Sie in dieser Schnellstartanleitung bereitstellen, ist ein simulierter Sensor, mit dem Daten zu Temperatur, Luftfeuchtigkeit und Luftdruck generiert werden.The module that you deploy in this quickstart is a simulated sensor that generates temperature, humidity, and pressure data. Die anderen Tutorials zu Azure IoT Edge bauen darauf auf und erläutern die Bereitstellung von Modulen, mit denen die simulierten Daten analysiert werden, um geschäftsrelevante Erkenntnisse zu gewinnen.The other Azure IoT Edge tutorials build upon the work you do here by deploying modules that analyze the simulated data for business insights.

Wenn Sie über kein aktives Azure-Abonnement verfügen, können Sie ein kostenloses Konto erstellen, bevor Sie beginnen.If you don't have an active Azure subscription, create a free account before you begin.

Öffnen von Azure Cloud ShellOpen Azure Cloud Shell

Azure Cloud Shell ist eine kostenlose interaktive Shell, mit der Sie die Schritte in diesem Artikel ausführen können.Azure Cloud Shell is a free, interactive shell that you can use to run the steps in this article. Allgemeine Tools sind in Cloud Shell vorinstalliert und für die Verwendung mit Ihrem Konto konfiguriert.Common Azure tools are preinstalled and configured in Cloud Shell for you to use with your account. Wählen Sie Kopieren aus, um den Code zu kopieren. Fügen Sie ihn anschließend in Cloud Shell ein, und drücken Sie die EINGABETASTE, um ihn auszuführen.Select Copy to copy the code, paste it in Cloud Shell, and then press Enter to run it. Cloud Shell kann auf mehrere Arten geöffnet werden:There are a few ways to open Cloud Shell:

Klicken Sie in der rechten oberen Ecke eines Codeblocks auf Ausprobieren.Select Try It in the upper-right corner of a code block. Beispiel für „Testen Sie es.“ für Azure Cloud Shell
Öffnen Sie Cloud Shell in Ihrem Browser.Open Cloud Shell in your browser. Schaltfläche zum Starten von Azure Cloud ShellLaunch Azure Cloud Shell button
Klicken Sie im Azure-Portal rechts oben im Menü auf die Schaltfläche Cloud Shell:Select the Cloud Shell button on the menu in the upper-right corner of the Azure portal. Cloud Shell-Schaltfläche im Azure-Portal

Sie verwenden die Azure CLI für viele Schritte in dieser Schnellstartanleitung, und Azure IoT verfügt über eine Erweiterung zur Aktivierung der zusätzlichen Funktionalität.You use the Azure CLI to complete many of the steps in this quickstart, and Azure IoT has an extension to enable additional functionality.

Fügen Sie die Azure IoT-Erweiterung der Cloud Shell-Instanz hinzu.Add the Azure IoT extension to the cloud shell instance.

az extension add --name azure-cli-iot-ext

VoraussetzungenPrerequisites

Cloudressourcen:Cloud resources:

  • Eine Ressourcengruppe zum Verwalten aller Ressourcen, die Sie in dieser Schnellstartanleitung verwenden.A resource group to manage all the resources you use in this quickstart.

    az group create --name IoTEdgeResources --location westus2
    

IoT Edge-Gerät:IoT Edge device:

  • Ein Linux-Gerät oder ein virtueller Linux-Computer als IoT Edge-Gerät.A Linux device or virtual machine to act as your IoT Edge device. Verwenden Sie den von Microsoft bereitgestellten virtuellen Computer Azure IoT Edge unter Ubuntu, der alles vorinstalliert, was Sie zum Ausführen von IoT Edge auf einem Gerät benötigen.You should use the Microsoft-provided Azure IoT Edge on Ubuntu virtual machine, which preinstalls everything you need to run IoT Edge on a device. Erstellen Sie diesen virtuellen Computer mit dem folgenden Befehl:Create this virtual machine using the following command:

    az vm create --resource-group IoTEdgeResources --name EdgeVM --image microsoft_iot_edge:iot_edge_vm_ubuntu:ubuntu_1604_edgeruntimeonly:latest --admin-username azureuser --generate-ssh-keys --size Standard_DS1_v2
    

    Das Erstellen und Starten des neuen virtuellen Computers kann ein paar Minuten in Anspruch nehmen.It may take a few minutes to create and start the new virtual machine.

    Unter Umständen tritt an dieser Stelle ein Fehler vom Typ MarketplacePurchaseEligibilityFailed auf.You may get a MarketplacePurchaseEligibilityFailed error at this point. In diesem Fall müssen Sie die Bedingungen akzeptieren, indem Sie zu Azure IoT Edge on Ubuntu (Azure IoT Edge unter Ubuntu) navigieren und auf Get It Now klicken.If this happens, you need to accept the terms by going to Azure IoT Edge on Ubuntu and clicking Get It Now. Melden Sie sich an, akzeptieren Sie die Bedingungen, und wiederholen Sie anschließend den Befehl.Sign in and accept the terms there before retrying the command.

    Notieren Sie sich beim Erstellen eines neuen virtuellen Computers den Wert für publicIpAddress, der im Rahmen der Befehlsausgabe für die Erstellung bereitgestellt wird.When you create a new virtual machine, make a note of the publicIpAddress, which is provided as part of the create command output. Mit dieser öffentlichen IP-Adresse stellen Sie später in dieser Schnellstartanleitung eine Verbindung mit dem virtuellen Computer her.You will use this public IP address to connect to the virtual machine later in the quickstart.

  • Falls Sie die Ausführung der Azure IoT Edge-Runtime auf Ihrem eigenen Gerät vorziehen, gehen Sie gemäß der Anleitung unter Installieren der Azure IoT Edge-Runtime unter Linux (x64) oder Installieren der Azure IoT Edge-Runtime unter Linux (ARM32v7/armhf) vor.If you prefer to run the Azure IoT Edge runtime on your own device, follow instructions at Install the Azure IoT Edge runtime on Linux (x64) or Install Azure IoT Edge runtime on Linux (ARM32v7/armhf).

Erstellen eines IoT HubsCreate an IoT hub

Beginnen Sie den Schnellstart, indem Sie an der Azure-Befehlszeilenschnittstelle einen IoT-Hub erstellen.Start the quickstart by creating an IoT hub with Azure CLI.

Diagramm – Erstellen einer IoT Hub-Instanz in der Cloud

Der kostenlose IoT Hub kann für diesen Schnellstart verwendet werden.The free level of IoT Hub works for this quickstart. Wenn Sie den IoT Hub schon einmal genutzt und bereits einen kostenlosen Hub erstellt haben, können Sie diesen IoT Hub verwenden.If you've used IoT Hub in the past and already have a free hub created, you can use that IoT hub. Jedes Abonnement kann nur über einen kostenlosen IoT Hub verfügen.Each subscription can only have one free IoT hub.

Mit dem folgenden Code wird ein kostenloser F1-Hub in der Ressourcengruppe IoTEdgeResources erstellt.The following code creates a free F1 hub in the resource group IoTEdgeResources. Ersetzen Sie {hub_name} durch einen eindeutigen Namen für Ihren IoT Hub.Replace {hub_name} with a unique name for your IoT hub.

az iot hub create --resource-group IoTEdgeResources --name {hub_name} --sku F1

Wenn Sie eine Fehlermeldung erhalten, da bereits ein kostenloser Hub in Ihrem Abonnement vorhanden ist, ändern Sie die SKU auf S1.If you get an error because there's already one free hub in your subscription, change the SKU to S1. Sollten Sie eine Fehlermeldung mit dem Hinweis erhalten, dass der IoT Hub-Name nicht verfügbar ist, ist bereits ein Hub mit diesem Namen vorhanden.If you get an error that the IoT Hub name isn't available, it means that someone else already has a hub with that name. Probieren Sie einen neuen Namen aus.Try a new name.

Registrieren eines IoT Edge-GerätsRegister an IoT Edge device

Registrieren Sie ein IoT Edge-Gerät bei Ihrem neu erstellten IoT Hub.Register an IoT Edge device with your newly created IoT hub.

Diagramm – Registrieren eines Geräts mit einer IoT Hub-Identität

Erstellen Sie eine Geräteidentität für das IoT Edge-Gerät, sodass es mit dem IoT Hub kommunizieren kann.Create a device identity for your IoT Edge device so that it can communicate with your IoT hub. Die Geräteidentität befindet sich in der Cloud, und Sie verwenden eine eindeutige Geräte-Verbindungszeichenfolge, um einem physischen Gerät eine Geräteidentität zuzuordnen.The device identity lives in the cloud, and you use a unique device connection string to associate a physical device to a device identity.

Da IoT Edge-Geräte sich von typischen IoT-Geräten unterscheiden und auf unterschiedliche Weise verwaltet werden können, deklarieren Sie diese Identität mit dem Flag --edge-enabled für ein IoT Edge-Gerät.Since IoT Edge devices behave and can be managed differently than typical IoT devices, declare this identity to be for an IoT Edge device with the --edge-enabled flag.

  1. Geben Sie in Azure Cloud Shell den folgenden Befehl ein, um in Ihrem Hub ein Gerät mit dem Namen myEdgeDevice zu erstellen.In the Azure cloud shell, enter the following command to create a device named myEdgeDevice in your hub.

    az iot hub device-identity create --hub-name {hub_name} --device-id myEdgeDevice --edge-enabled
    

    Falls Sie eine Fehlermeldung zu iothubowner-Richtlinienschlüsseln erhalten, überprüfen Sie, ob in Ihrer Cloud Shell-Instanz die aktuelle Version der Erweiterung „azure-cli-iot-ext“ ausgeführt wird.If you get an error about iothubowner policy keys, make sure that your cloud shell is running the latest version of the azure-cli-iot-ext extension.

  2. Rufen Sie die Verbindungszeichenfolge für Ihr Gerät ab, über die Ihr physisches Gerät mit seiner Identität auf dem IoT Hub verknüpft wird.Retrieve the connection string for your device, which links your physical device with its identity in IoT Hub.

    az iot hub device-identity show-connection-string --device-id myEdgeDevice --hub-name {hub_name}
    
  3. Kopieren Sie den Wert des Schlüssels connectionString aus der JSON-Ausgabe, und speichern Sie ihn.Copy the value of the connectionString key from the JSON output and save it. Dieser Wert ist die Verbindungszeichenfolge des Geräts.This value is the device connection string. Sie verwenden ihn im nächsten Abschnitt zum Konfigurieren der IoT Edge-Runtime.You'll use this connection string to configure the IoT Edge runtime in the next section.

    Abrufen der Verbindungszeichenfolge aus der CLI-Ausgabe

Konfigurieren Sie Ihr IoT Edge-GerätConfigure your IoT Edge device

Starten Sie die Azure IoT Edge-Runtime auf Ihrem IoT Edge-Gerät.Start the Azure IoT Edge runtime on your IoT Edge device.

Diagramm – Starten der Runtime auf einem Gerät

Die IoT Edge-Runtime wird auf allen IoT Edge-Geräten bereitgestellt.The IoT Edge runtime is deployed on all IoT Edge devices. Sie besteht aus drei Komponenten.It has three components. Der Daemon für die IoT Edge-Sicherheit wird jedes Mal gestartet, wenn ein Edge-Gerät gestartet wird, und startet den IoT Edge-Agent, um einen Bootstrapvorgang durchzuführen.The IoT Edge security daemon starts each time an Edge device boots and bootstraps the device by starting the IoT Edge agent. Der IoT Edge-Agent erleichtert die Bereitstellung und Überwachung von Modulen auf dem IoT Edge-Gerät, einschließlich des IoT Edge-Hubs.The IoT Edge agent facilitates deployment and monitoring of modules on the IoT Edge device, including the IoT Edge hub. Der IoT Edge-Hub verwaltet die Kommunikation zwischen Modulen auf dem IoT Edge-Gerät sowie zwischen dem Gerät und IoT Hub.The IoT Edge hub manages communications between modules on the IoT Edge device, and between the device and IoT Hub.

Bei der Konfiguration der Runtime geben Sie eine Geräte-Verbindungszeichenfolge ein.During the runtime configuration, you provide a device connection string. Verwenden Sie die Zeichenfolge, die Sie über die Azure CLI abgerufen haben.Use the string that you retrieved from the Azure CLI. Diese Zeichenfolge ordnet Ihr physisches Gerät der IoT Edge-Geräteidentität in Azure zu.This string associates your physical device with the IoT Edge device identity in Azure.

Festlegen der Verbindungszeichenfolge auf dem Azure IoT Edge-GerätSet the connection string on the IoT Edge device

Wenn Sie den virtuellen Computer mit Azure IoT Edge unter Ubuntu verwenden, der in den Voraussetzungen beschrieben wurde, ist auf Ihrem Gerät die IoT Edge-Runtime bereits installiert.If you're using the Azure IoT Edge on Ubuntu virtual machine as described in the prerequisites, then your device already has the IoT Edge runtime installed. Sie brauchen Ihr Gerät lediglich mit der Verbindungszeichenfolge zu konfigurieren, die Sie im vorherigen Abschnitt abgerufen haben.You just need to configure your device with the device connection string that you retrieved in the previous section. Sie können dies remote erledigen, ohne eine Verbindung mit dem virtuellen Computer herstellen zu müssen.You can do this remotely without having to connect to the virtual machine. Führen Sie den folgenden Befehl aus, und ersetzen Sie dabei {device_connection_string} durch Ihre eigene Zeichenfolge.Run the following command, replacing {device_connection_string} with your own string.

az vm run-command invoke -g IoTEdgeResources -n EdgeVM --command-id RunShellScript --script "/etc/iotedge/configedge.sh '{device_connection_string}'"

Wenn Sie IoT Edge auf Ihrem lokalen Computer oder einem ARM32-Gerät ausführen, müssen Sie die IoT Edge-Runtime und deren Voraussetzungen auf Ihrem Gerät installieren.If you're running IoT Edge on your local machine or an ARM32 device, you need to install the IoT Edge runtime and its prerequisites on your device. Befolgen Sie die Anweisungen in Installieren von Azure IoT Edge-Runtime unter Linux (x64) oder Installieren von Azure IoT Edge-Runtime unter Linux (ARM32v7/armhf), und kehren Sie dann zu dieser Schnellstartanleitung zurück.Follow the instructions in Install the Azure IoT Edge runtime on Linux (x64) or Install Azure IoT Edge runtime on Linux (ARM32v7/armhf), then return to this quickstart.

Anzeigen des Status der IoT Edge-RuntimeView the IoT Edge runtime status

Die verbleibenden Befehle in dieser Schnellstartanleitung werden auf Ihrem IoT Edge-Gerät ausgeführt, Sie können also sehen, was auf dem Gerät geschieht.The rest of the commands in this quickstart take place on your IoT Edge device itself, so that you can see what's happening on the device. Wenn Sie einen virtuellen Computer verwenden, stellen Sie jetzt mithilfe der öffentlichen IP-Adresse, die vom Erstellungsbefehl ausgegeben wurde, eine Verbindung mit diesem Computer her.If you're using a virtual machine, connect to that machine now using the public IP address that was output by the creation command. Die öffentliche IP-Adresse finden Sie auch auf der Seite „Übersicht“ Ihres virtuellen Computers im Azure-Portal.You can also find the public IP address on your virtual machine's overview page in the Azure portal. Verwenden Sie den folgenden Befehl, um eine Verbindung mit Ihrem virtuellen Computer herzustellen.Use the following command to connect to your virtual machine. Ersetzen Sie {azureuser}, wenn Sie einen anderen als den in den Voraussetzungen vorgeschlagenen Benutzernamen verwendet haben.Replace {azureuser} if you used a different username than the one suggested in the prerequisites. Ersetzen Sie {publicIpAddress} durch die Adresse Ihres Computers.Replace {publicIpAddress} with your machine's address.

ssh azureuser@{publicIpAddress}

Vergewissern Sie sich, dass die Runtime erfolgreich auf Ihrem IoT Edge-Gerät installiert und konfiguriert wurde.Verify that the runtime was successfully installed and configured on your IoT Edge device.

Tipp

Sie benötigen erhöhte Rechte zum Ausführen von iotedge-Befehlen.You need elevated privileges to run iotedge commands. Nachdem Sie sich bei Ihrem Computer abgemeldet und sich nach der Installation der IoT Edge-Runtime zum ersten Mal erneut angemeldet haben, werden Ihre Berechtigungen automatisch aktualisiert.Once you sign out of your machine and sign back in the first time after installing the IoT Edge runtime, your permissions are automatically updated. Verwenden Sie bis dahin sudo vor den Befehlen.Until then, use sudo in front of the commands.

  1. Überprüfen Sie, ob der Daemon für die Azure Edge-Sicherheit als Systemdienst ausgeführt wird.Check to see that the Edge Security Daemon is running as a system service.

    sudo systemctl status iotedge
    

    Anzeigen der Ausführung des Edge-Daemons als Systemdienst

  2. Sollte eine Problembehandlung für den Dienst erforderlich sein, rufen Sie die Dienstprotokolle ab.If you need to troubleshoot the service, retrieve the service logs.

    journalctl -u iotedge
    
  3. Zeigen Sie die Module an, die auf Ihrem Gerät ausgeführt werden.View the modules running on your device.

    sudo iotedge list
    

    Anzeigen eines Moduls auf Ihrem Gerät

Ihr IoT Edge-Gerät ist jetzt konfiguriert.Your IoT Edge device is now configured. Es kann nun zum Ausführen von in der Cloud bereitgestellten Modulen verwendet werden.It's ready to run cloud-deployed modules.

Bereitstellen eines ModulsDeploy a module

Verwalten Sie Ihr Azure IoT Edge-Gerät über die Cloud, um ein Modul bereitzustellen, das Telemetriedaten an die IoT Hub-Instanz sendet.Manage your Azure IoT Edge device from the cloud to deploy a module that will send telemetry data to IoT Hub. Diagramm – Bereitstellen eines Moduls aus der Cloud für das GerätDiagram - deploy module from cloud to device

Eine der wichtigen Funktionen von Azure IoT Edge ist die Möglichkeit, Code aus der Cloud auf IoT Edge-Geräten bereitzustellen.One of the key capabilities of Azure IoT Edge is being able to deploy code to your IoT Edge devices from the cloud. Bei IoT Edge-Modulen handelt es sich um ausführbare Pakete, die als Container implementiert werden.IoT Edge modules are executable packages implemented as containers. In diesem Abschnitt stellen Sie ein fertig erstelltes Modul aus dem Bereich mit den IoT Edge-Modulen im Azure Marketplace bereit.In this section, you deploy a pre-built module from the IoT Edge Modules section of the Azure Marketplace.

Mit dem in diesem Abschnitt bereitgestellten Modul wird ein Sensor simuliert, und es werden Daten generiert.The module that you deploy in this section simulates a sensor and sends generated data. Der Code dieses Moduls ist nützlich, wenn Sie die ersten Schritte mit IoT Edge ausführen, weil Sie die simulierten Daten für die Entwicklung und das Testen nutzen können.This module is a useful piece of code when you're getting started with IoT Edge because you can use the simulated data for development and testing. Wenn Sie genau sehen möchten, was mit diesem Modul durchgeführt wird, können Sie den Quellcode für den simulierten Temperatursensor anzeigen.If you want to see exactly what this module does, you can view the simulated temperature sensor source code.

Führen Sie die folgenden Schritte aus, um über den Azure Marketplace Ihr erstes Modul bereitzustellen:To deploy your first module from the Azure Marketplace, use the following steps:

  1. Geben Sie im Azure-Portal Simulated Temperature Sensor (Simulierter Temperatursensor) in das Suchfeld ein, und öffnen Sie das Marketplace-Ergebnis.In the Azure portal, enter Simulated Temperature Sensor into the search and open the Marketplace result.

    Simulierter Temperatursensor in der Suche im Azure-Portal

  2. Wählen Sie ein IoT Edge-Gerät aus, das dieses Modul empfangen soll.Choose an IoT Edge device to receive this module. Geben Sie auf der Seite Zielgeräte für IoT Edge-Modul die folgenden Informationen ein:On the Target Devices for IoT Edge Module page, provide the following information:

    1. Abonnement: Wählen Sie das Abonnement aus, das den von Ihnen verwendeten IoT-Hub enthält.Subscription: select the subscription that contains the IoT hub you're using.

    2. IoT Hub: Wählen Sie den Namen des verwendeten IoT-Hubs aus.IoT Hub: select the name of the IoT hub you're using.

    3. Name des IoT Edge-Geräts: Wenn Sie den Namen des vorgeschlagenen Geräts bereits zuvor in diesem Schnellstart verwendet haben, geben Sie meinEdgeGerät ein.IoT Edge Device Name: if you used the suggested device name earlier in this quickstart, enter myEdgeDevice. Wählen Sie andernfalls Gerät suchen, um aus einer Liste mit IoT Edge-Geräten auf Ihrem IoT-Hub ein Gerät auszuwählen.Or, select Find Device to choose from a list of IoT Edge devices in your IoT hub.

    4. Klicken Sie auf Erstellen.Select Create.

  3. Nachdem Sie nun ein IoT Edge-Modul im Azure Marketplace und ein IoT Edge-Gerät für das Modul ausgewählt haben, gelangen Sie zu einem aus drei Schritten bestehenden Assistenten, der Sie bei der genauen Definition der Modulbereitstellung unterstützt.Now that you've chosen an IoT Edge module from the Azure Marketplace, and chosen an IoT Edge device to receive the module, you're taken to a three-step wizard that helps you define exactly how to deploy the module. Beachten Sie im Schritt Module hinzufügen des Assistenten, dass das Modul SimulatedTemperatureSensor (Simulierter Temperatursensor) automatisch aufgefüllt wird.In the Add Modules step of the wizard, notice that the SimulatedTemperatureSensor module is autopopulated. In den Tutorials verwenden Sie diese Seite, um Ihrer Bereitstellung weitere Module hinzuzufügen.In the tutorials, you use this page to add additional modules to your deployment. Im Rahmen dieses Schnellstarts stellen Sie einfach dieses eine Modul bereit.For this quickstart, only deploy this one module. Wählen Sie Weiter aus, um mit dem nächsten Schritt des Assistenten fortzufahren.Select Next to continue to the next step of the wizard.

  4. Im Schritt Specify Routes (Routen festlegen) des Assistenten definierten Sie, wie Nachrichten zwischen Modulen und dem IoT Hub übergeben werden.In the Specify Routes step of the wizard, you define how messages are passed between modules and to IoT Hub. Im Rahmen des Schnellstarts sollen alle Nachrichten von allen Modulen an den IoT Hub ($upstream) gelangen.For the quickstart, you want all messages from all modules to go to IoT Hub ($upstream). Wenn er nicht automatisch aufgefüllt wurde, fügen Sie in diesem Schritt den folgenden Code hinzu, und wählen Sie dann Weiter aus:If it's not autopopulated, add the following code then select Next:

     {
     "routes": {
         "route": "FROM /messages/* INTO $upstream"
         }
     }
    
  5. Im Schritt Bereitstellung überprüfen des Assistenten können Sie eine Vorschau der JSON-Datei anzeigen, in der alle Module definiert sind, die auf Ihrem IoT Edge-Gerät bereitgestellt werden.In the Review Deployment step of the wizard, you can preview the JSON file that defines all the modules that get deployed to your IoT Edge device. Beachten Sie, dass hier das Modul SimulatedTemperatureSensor ebenso wie zwei zusätzliche Systemmodule mit den Namen edgeAgent und edgeHub enthalten sind.Notice that the SimulatedTemperatureSensor module is included, and two additional system modules called edgeAgent and edgeHub. Wählen Sie Übermitteln aus, wenn Sie die Überprüfung abgeschlossen haben.Select Submit when you're done reviewing.

    Wenn Sie eine neue Bereitstellung an ein IoT Edge-Gerät übermitteln, wird nichts per Push auf Ihr Gerät übertragen.When you submit a new deployment to an IoT Edge device, nothing is pushed to your device. Stattdessen fragt das Gerät den IoT Hub regelmäßig nach neuen Anweisungen ab.Instead, the device queries IoT Hub regularly for any new instructions. Wenn das Gerät ein aktualisiertes Bereitstellungsmanifest findet, werden die Informationen zur neuen Bereitstellung verwendet, um die Modulimages per Pullvorgang aus der Cloud abzurufen. Anschließend wird die lokale Ausführung der Module gestartet.If the device finds an updated deployment manifest, it uses the information about the new deployment to pull the module images from the cloud then starts running the modules locally. Dieser Vorgang kann einige Minuten in Anspruch nehmen.This process may take a few minutes.

  6. Nachdem Sie die Bereitstellungsdetails des Moduls übermittelt haben, werden Sie vom Assistenten zur Seite IoT Edge Ihres IoT Hubs zurück geführt.After you submit the module deployment details, the wizard returns you to the IoT Edge page of your IoT hub. Wählen Sie Ihr Gerät in der Liste der IoT Edge-Geräte aus, um seine Details anzuzeigen.Select your device from the list of IoT Edge devices to see its details.

  7. Scrollen Sie auf der Detailseite des Geräts nach unten zum Abschnitt Module.On the device details page, scroll down to the Modules section. Dort sollten drei Module aufgelistet sein: $edgeAgent, $edgeHub und SimulatedTemperatureSensor.Three modules should be listed: $edgeAgent, $edgeHub, and SimulatedTemperatureSensor. Wenn mindestens ein Modul als in der Bereitstellung angegeben aufgeführt ist, vom Gerät aber nicht gemeldet wird, ist Ihr IoT Edge-Gerät noch mit dem Startvorgang beschäftigt.If one or more of the modules are listed as specified in deployment but not reported by device, your IoT Edge device is still starting them. Warten Sie einige Minuten, und wählen Sie oben auf der Seite Aktualisieren aus.Wait a few moments and select Refresh at the top of the page.

    Anzeigen von „SimulatedTemperatureSensor“ in der Liste mit den bereitgestellten Modulen

Anzeigen generierter DatenView generated data

In diesem Schnellstart haben Sie ein neues IoT Edge-Gerät erstellt und die IoT Edge-Runtime darauf installiert.In this quickstart, you created a new IoT Edge device and installed the IoT Edge runtime on it. Anschließend haben Sie das Azure-Portal verwendet, um ein IoT Edge-Modul zur Ausführung auf dem Gerät bereitzustellen, ohne Änderungen am Gerät selbst vornehmen zu müssen.Then, you used the Azure portal to deploy an IoT Edge module to run on the device without having to make changes to the device itself.

In diesem Fall erstellt das per Pushvorgang übertragene Modul Beispieldaten, die Sie für das Testen verwenden können.In this case, the module that you pushed creates sample data that you can use for testing. Mit dem simulierten Temperatursensormodul werden Umgebungsdaten generiert, die Sie später zum Testen verwenden können.The simulated temperature sensor module generates environment data that you can use for testing later. Der simulierte Sensor überwacht sowohl einen Computer als auch seine Umgebung.The simulated sensor is monitoring both a machine and the environment around the machine. Beispielsweise kann sich dieser Sensor in einem Serverraum, in einer Fabrik oder in einer Windturbine befinden.For example, this sensor might be in a server room, on a factory floor, or on a wind turbine. Er meldet die Umgebungstemperatur und Luftfeuchtigkeit, die Computertemperatur und den Druck sowie einen Zeitstempel.The message includes ambient temperature and humidity, machine temperature and pressure, and a timestamp. In den IoT Edge-Tutorials werden diese vom Modul erstellten Daten als Testdaten für die Analyse verwendet.The IoT Edge tutorials use the data created by this module as test data for analytics.

Öffnen Sie die Eingabeaufforderung erneut auf Ihrem IoT Edge-Gerät, oder verwenden Sie die SSH-Verbindung über die Azure CLI.Open the command prompt on your IoT Edge device again, or use the SSH connection from Azure CLI. Vergewissern Sie sich, dass das über die Cloud bereitgestellte Modul auf dem IoT Edge-Gerät ausgeführt wird:Confirm that the module deployed from the cloud is running on your IoT Edge device:

sudo iotedge list

Anzeigen von drei Modulen auf dem Gerät

Anzeigen der Nachrichten, die vom Temperatursensormodul gesendet werden:View the messages being sent from the temperature sensor module:

sudo iotedge logs SimulatedTemperatureSensor -f

Tipp

Bei IoT Edge-Befehlen werden beim Verweis auf Modulnamen Groß- und Kleinschreibung unterschieden.IoT Edge commands are case-sensitive when referring to module names.

Anzeigen der Daten von Ihrem Modul

Sie können die bei Ihrem IoT-Hub eingehenden Nachrichten auch mit der Azure IoT Hub-Toolkit-Erweiterung für Visual Studio Code (bisher als Azure IoT-Toolkit-Erweiterung bekannt) anzeigen.You can also watch the messages arrive at your IoT hub by using the Azure IoT Hub Toolkit extension for Visual Studio Code (formerly Azure IoT Toolkit extension).

Bereinigen von RessourcenClean up resources

Wenn Sie mit den IoT Edge-Tutorials fortfahren möchten, können Sie das Gerät verwenden, das Sie in dieser Schnellstartanleitung registriert und eingerichtet haben.If you want to continue on to the IoT Edge tutorials, you can use the device that you registered and set up in this quickstart. Andernfalls können Sie die Azure-Ressourcen löschen, die Sie erstellt haben, und die IoT Edge-Runtime von Ihrem Gerät entfernen.Otherwise, you can delete the Azure resources that you created and remove the IoT Edge runtime from your device.

Löschen von Azure-RessourcenDelete Azure resources

Wenn Sie Ihren virtuellen Computer und Azure IoT Hub in einer neuen Ressourcengruppe erstellt haben, können Sie diese Gruppe und alle zugehörigen Ressourcen löschen.If you created your virtual machine and IoT hub in a new resource group, you can delete that group and all the associated resources. Überprüfen Sie den Inhalt der Ressourcengruppe, um sicherzustellen, dass sie keine Elemente enthält, die Sie behalten möchten.Double check the contents of the resource group to make sure that there's nothing you want to keep. Wenn Sie nicht die gesamte Gruppe löschen möchten, können Sie stattdessen einzelne Ressourcen löschen.If you don't want to delete the whole group, you can delete individual resources instead.

Entfernen Sie die Gruppe IoTEdgeResources.Remove the IoTEdgeResources group.

az group delete --name IoTEdgeResources

Entfernen der IoT Edge-RuntimeRemove the IoT Edge runtime

Verwenden Sie die folgenden Befehle, wenn Sie die Installationen von Ihrem Gerät entfernen möchten.If you want to remove the installations from your device, use the following commands.

Entfernen Sie die IoT Edge-Runtime.Remove the IoT Edge runtime.

sudo apt-get remove --purge iotedge

Entfernen Sie die Containerruntime.Remove the container runtime.

sudo apt-get remove --purge moby-cli
sudo apt-get remove --purge moby-engine

Nächste SchritteNext steps

Diese Schnellstartanleitung ist die Voraussetzung für alle IoT Edge-Tutorials.This quickstart is the prerequisite for all of the IoT Edge tutorials. Sie können mit einem der anderen Tutorials fortfahren, um zu erfahren, wie Azure IoT Edge Ihnen beim Umwandeln dieser Daten in geschäftliche Erkenntnisse auf Edge-Ebene helfen kann.You can continue on to any of the other tutorials to learn how Azure IoT Edge can help you turn this data into business insights at the edge.