Freigeben über

Bereitstellen des Azure Device Update for IoT Hub-Agents

  • Artikel

Der Modul-Agent für Device Update kann zusammen mit anderen Systemprozessen und IoT Edge-Modulen ausgeführt werden, die eine Verbindung mit Ihrem IoT Hub als Teil desselben logischen Geräts herstellen. In diesem Artikel wird beschrieben, wie Sie den Device Update-Agent als Modulkennung bereitstellen.

Hinweis

Wenn Sie den Device Update-Agent verwenden, sollten Sie sicherstellen, dass Sie die Version 1.0.0 zur allgemeinen Verfügbarkeit (General Availability, GA) nutzen. Sie können die installierten Versionen des Device Update-Agents und des Übermittlungsoptimierungs-Agents im Abschnitt Eigenschaften Ihres IoT-Gerätezwillings überprüfen. Weitere Informationen finden Sie unter Migrieren von Geräten und Gruppen zum neuesten Device Update-Release.

Modulkennung und Geräteidentität

Sie können unter jeder Azure IoT Hub-Geräteidentität bis zu 50 Modulkennungen erstellen. Jede Modulidentität generiert implizit einen Modulkennungszwilling. Auf der Geräteseite können Sie mithilfe der IoT Hub-Geräte-SDKs Module erstellen, die jeweils eine unabhängige Verbindung mit IoT Hub herstellen.

Modulkennung und Modulkennungszwilling bieten die gleichen Funktionen wie Geräteidentität und Gerätezwilling, aber mit einer höheren Granularität. Weitere Informationen finden Sie unter Verstehen und Verwenden von Modulzwillingen in IoT Hub.

Wenn Sie den Device Update-Agent als Modulkennung bereitstellen, muss die gesamte Kommunikation zwischen dem Gerät und dem Device Update-Dienst über den Modulzwilling erfolgen. Denken Sie daran, den Modulzwilling des Geräts zu markieren, wenn Sie Gerätegruppen erstellen. Wenn Sie von einem Agent auf Geräteebene migrieren, um den Agent als Modulkennung hinzuzufügen, entfernen Sie den älteren Agent, der über den Gerätezwilling kommuniziert hat.

Unterstützte Updatetypen

Device Update unterstützt die folgenden Arten von Over-the-Air-Updates für IoT-Geräte:

Vorbereiten der Paketupdates

Um ein IoT-Gerät oder IoT Edge-Gerät zur Installation von paketbasierten Updates einzurichten, fügen Sie packages.microsoft.com den Repositorys Ihres Computers hinzu, indem Sie die folgenden Schritte ausführen:

  1. Öffnen Sie ein Terminalfenster auf dem Computer oder IoT-Gerät, auf dem Sie den Device Update-Agent installieren möchten.

  2. Installieren Sie die Repositorykonfiguration, die dem Betriebssystem Ihres Geräts entspricht, zum Beispiel:

    curl https://packages.microsoft.com/config/ubuntu/18.04/multiarch/prod.list > ./microsoft-prod.list

  3. Kopieren Sie die generierte Liste in das Verzeichnis sources.list.d.

    sudo cp ./microsoft-prod.list /etc/apt/sources.list.d/

  4. Installieren Sie den öffentlichen Schlüssel von Microsoft GPG.

    curl https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > microsoft.gpg

    sudo cp ./microsoft.gpg /etc/apt/trusted.gpg.d/

Bereitstellen des Device Update-Agents

Sie können den Device Update-Agent als Modulkennung auf IoT Edge-aktivierten Geräten oder Nicht-IoT Edge-Geräten bereitstellen. Ob IoT Edge auf Ihrem Gerät aktiviert ist, können Sie unter Anzeigen registrierter Geräte und Abrufen von Bereitstellungsinformationen nachsehen.

Sie können Beispielbilder herunterladen, die sie im Abschnitt Assets auf der Seite Releases verwenden können. Die in Tutorial_RaspberryPi3.zip enthaltene Datei swUpdate ist das Basisimage, das Sie auf eine Raspberry Pi B3+-Platine einspielen können. Die Datei .gz ist das Update, das Sie über Device Update importieren können. Weitere Informationen finden Sie unter Azure Device Update for IoT Hub mithilfe eines Raspberry Pi-Images.

Auf IOT Edge aktivierten Geräten

Befolgen Sie diese Anweisungen, um den Device Update-Agent auf IoT Edge-aktivierten Geräten bereitzustellen:

  1. Führen Sie die Schritte unter Manuelles Bereitstellen eines einzelnen Linux-IoT Edge-Geräts aus.

  2. Installieren Sie den Device Update-Agent für Imageupdates, indem Sie den folgenden Befehl ausführen:

    sudo apt-get install deviceupdate-agent

  3. Installieren Sie den Device Update-Agent für Paketupdates.

    • Für die aktuellen Agent-Versionen von packages.microsoft.com: Aktualisieren Sie Paketlisten auf Ihrem Gerät, und installieren Sie das Device Update-Agent-Paket und seine Abhängigkeiten mit:

      sudo apt-get update

      sudo apt-get install deviceupdate-agent

    • Für Release Candidate (RC)-Agent-Versionen: Laden Sie die Datei .deb aus Releases auf den Computer herunter, auf dem Sie den Device Update-Agent installieren möchten, und führen Sie dann den folgenden Befehl aus:

      sudo apt-get install -y ./"<PATH TO FILE>"/"<.DEB FILE NAME>"

    • Wenn Sie einen Microsoft Connected Cache (MCC) für ein Szenario mit getrennten Geräten einrichten, installieren Sie das APT-Plug-In für die Übermittlungsoptimierung wie folgt:

      sudo apt-get install deliveryoptimization-plugin-apt

Auf Nicht-IoT Edge-aktivierten Geräten

Befolgen Sie diese Anweisungen, um den Device Update-Agent auf IoT-Linux-Geräten ohne Installation von IoT Edge bereitzustellen.

  1. Installieren Sie die neueste Version des IoT-Identitätsdiensts, indem Sie die Anweisungen zum Installieren des Azure IoT-Identitätsdiensts befolgen.

  2. Konfigurieren Sie den IoT-Identitätsdienst gemäß den Anweisungen zum Konfigurieren des Azure IoT-Identitätsdiensts.

  3. Installieren Sie den Device Update-Agent, indem Sie den folgenden Befehl ausführen:

    sudo apt-get install deviceupdate-agent

Hinweis

Wenn Ihr IoT-Gerät den IoT-Identitätsdienst oder IoT Edge, wo der IoT-Identitätsdienst gebündelt wird, nicht ausführen kann, können Sie dennoch den Device Update Agent installieren und ihn mithilfe einer Verbindungszeichenfolge konfigurieren.

Konfigurieren des Device Update-Agents

Nachdem Sie den Device Update-Agent installiert haben, müssen Sie die Konfigurationsdatei für Device Update bearbeiten, indem Sie den folgenden Befehl ausführen.

sudo nano /etc/adu/du-config.json

Legen Sie in der Datei du-config.json alle Werte fest, die über den Platzhalter Place value here verfügen. Ändern Sie für Agents, die den IoT-Identitätsdienst für die Bereitstellung verwenden, connectionType in AIS, und legen Sie das Feld ConnectionData auf eine leere Zeichenfolge fest. Ein Beispiel finden Sie unter Beispielinhalt der Datei „du-config.json“.

Verwenden einer Verbindungszeichenfolge

Zum Testen oder für eingeschränkte Geräte können Sie den Device Update-Agent ohne Verwendung des IoT-Identitätsdiensts konfigurieren. Sie können eine Verbindungszeichenfolge verwenden, um den Device Update-Agent vom Modul oder Gerät bereitzustellen.

  1. Kopieren Sie im Azure-Portal die primäre Verbindungszeichenfolge. Wenn der Device Update-Agent als Modulkennung konfiguriert ist, kopieren Sie die primäre Verbindungszeichenfolge des Moduls. Kopieren Sie andernfalls die primäre Verbindungszeichenfolge des Geräts.

  2. In einem Terminalfenster auf dem Computer oder IoT-Gerät, auf dem Sie den Device Update-Agent installiert haben, müssen Sie die Konfigurationsdatei für Device Update bearbeiten, indem Sie den folgenden Befehl ausführen:

  3. Legen Sie in der Datei du-config.json alle Werte fest, die über den Platzhalter Place value here verfügen, und geben Sie die kopierte primäre Verbindungszeichenfolge als Feldwert connectionData ein. Ein Beispiel finden Sie unter Beispielinhalt der Datei „du-config.json“.

Starten des Device Update-Agents

Starten Sie den Device Update-Agent, und stellen Sie sicher, dass er erfolgreich auf Ihrem Gerät ausgeführt wird.

  1. In einem Terminalfenster auf dem Computer oder IoT-Gerät, auf dem Sie den Device Update-Agent installiert haben, müssen Sie den Agent neu starten, indem Sie den folgenden Befehl ausführen:

    sudo systemctl restart deviceupdate-agent

  2. Überprüfen Sie den Agent-Status, indem Sie den folgenden Befehl ausführen.

    sudo systemctl status deviceupdate-agent

    Als Status sollte OK angezeigt werden.

  3. Navigieren Sie auf der Seite des IoT Hub-Portals zu Geräte oder IoT Edge, um das von Ihnen konfigurierte Gerät zu finden, und zeigen Sie den als Modul ausgeführten Device Update-Agent an. Zum Beispiel:

    Diagramm des Device Update-Modulnamens mit dem Status „Verbunden“.

Erstellen und Ausführen eines Device Update-Agents

Sie können auch Ihren eigenen benutzerdefinierten Device Update-Agent erstellen und ändern. Befolgen Sie die Anweisungen unter Erstellen des Device Update-Agents, um den Device Update-Agent aus der Quelle zu erstellen.

Ist der Agent erfolgreich erstellt, befolgen Sie die Anweisungen unter Ausführen des Device Update for IoT Hub-Referenz-Agents, um den Agent auszuführen. Um Änderungen vorzunehmen, die erforderlich sind, um den Agent in Ihr Image zu integrieren, befolgen Sie die Anweisungen unter Ändern des Device Update-Agent-Codes.

Problembehandlung

Wenn Probleme auftreten, lesen Sie den Leitfaden zur Problembehandlung für Device Update for IoT Hub, um die Probleme zu beheben und die erforderlichen Informationen für Microsoft zu erfassen.

Zugehöriger Inhalt