Lernprogramm: Geräteupdate für Azure IoT Hub mit dem Paket-Agent auf Ubuntu Server 18.04 x64

Device Update for Azure IoT Hub unterstützt image-, paket- und skriptbasierte Updates.

Paketbasierte Updates sind gezielte Updates, die nur eine bestimmte Komponente oder Anwendung auf dem Gerät ändern. Dies führt zu einem geringeren Verbrauch an Bandbreite und verkürzt die Zeit zum Herunterladen und Installieren des Updates. Paketbasierte Updates ermöglichen normalerweise auch eine geringere Ausfallzeit von Geräten, wenn Sie ein Update anwenden, und sie vermeiden den Mehraufwand beim Erstellen von Images. Sie verwenden ein APT-Manifest, das dem Device Update-Agent die Informationen liefert, die er benötigt, um die in der APT-Manifestdatei angegebenen Pakete (und deren Abhängigkeiten) aus einem bestimmten Repository herunterzuladen und zu installieren.

Dieses Lernprogramm führt Sie durch das Aktualisieren von Azure IoT Edge auf Ubuntu Server 18.04 x64 mithilfe des Device Update-Paket-Agents. Obwohl das Lernprogramm das Aktualisieren von IoT Edge veranschaulicht, können Sie mit ähnlichen Schritten andere Pakete aktualisieren, z. B. das verwendete Containermodul.

Die Tools und Konzepte in diesem Tutorial gelten weiterhin, auch wenn Sie beabsichtigen, eine andere Konfiguration der Betriebssystemplattform zu verwenden. Beenden Sie diese Einführung in den umfassenden Updateprozess. Wählen Sie dann Ihre bevorzugte Form der Aktualisierung einer Betriebssystemplattform aus, um die Details zu erfahren.

In diesem Tutorial lernen Sie, wie Sie:

Voraussetzungen

• Erstellen Sie ein Konto und eine Instanz für Device Update, wenn Sie diese Schritte noch nicht ausgeführt haben. Konfigurieren Sie einen IoT-Hub.

• Dazu benötigen Sie die Verbindungszeichenfolge für ein IoT Edge-Gerät.

• Wenn Sie das Tutorial zum Simulator-Agent für vorherige Tests genutzt haben, führen Sie den folgenden Befehl aus, um den APT-Handler aufzurufen und in diesem Tutorial Over-The-Air-Paketupdates bereitzustellen:

  # sudo /usr/bin/AducIotAgent --register-content-handler /var/lib/adu/extensions/sources/libmicrosoft_apt_1.so --update-type 'microsoft/a pt:1'
  

Vorbereiten eines Geräts

Bereiten Sie ein Gerät automatisch oder manuell vor.

Verwenden der Schaltfläche „Automatisierte Bereitstellung in Azure“

Aus Gründen der Einfachheit verwendet dieses Lernprogramm eine cloudinitbasierteAzure Resource Manager-Vorlage , um Ihnen beim schnellen Einrichten eines virtuellen Ubuntu 18.04 LTS-Computers zu helfen. Sie installiert sowohl die Azure IoT Edge-Runtime als auch den Device Update-Paket-Agent. Anschließend konfiguriert sie das Gerät automatisch mit Bereitstellungsinformationen, wobei sie die Geräteverbindungszeichenfolge für ein von Ihnen angegebenes IoT Edge-Gerät (Voraussetzung) verwendet. Bei Verwendung der Resource Manager-Vorlage muss außerdem keine SSH-Sitzung gestartet werden, um das Setup abzuschließen.

1. Wählen Sie zuerst die Schaltfläche aus:

   .

2. Füllen Sie die verfügbaren Textfelder aus:

   

   • Abonnement: Das aktive Azure-Abonnement, in dem der virtuelle Computer bereitgestellt werden soll.
   • Ressourcengruppe: Eine vorhandene oder neu erstellte Ressourcengruppe, die den virtuellen Computer und die ihm zugeordneten Ressourcen enthalten soll.
   • Region: Die geografische Region, in der der virtuelle Computer bereitgestellt werden soll. Dieser Wert ist standardmäßig der Speicherort der ausgewählten Ressourcengruppe.
   • Präfix der DNS-Bezeichnung: Ein erforderlicher Wert Ihrer Wahl, der dem Hostnamen des virtuellen Computers vorangestellt wird.
   • Administratorbenutzername: Ein Benutzername, der Rootberechtigungen für die Bereitstellung erhält.
   • Geräte-Verbindungszeichenfolge: Eine Geräte-Verbindungszeichenfolge für ein Gerät, das in Ihrem vorgesehenen IoT-Hub erstellt wurde.
   • 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. Lassen Sie den Standardwert unverändert, da er bereits auf Ubuntu 18.04-LTS festgelegt wird.
   • Authentifizierungstyp: Wählen Sie sshPublicKey oder ein Kennwort entsprechend Ihren Anforderungen aus.
   • Administratorkennwort oder Schlüssel: Der Wert des öffentlichen SSH-Schlüssels oder der Wert des Kennworts, basierend auf der Wahl des Authentifizierungstyps.

   Nachdem alle Felder ausgefüllt wurden, aktivieren Sie das Kontrollkästchen unten auf der Seite, um die Bedingungen zu akzeptieren. Wählen Sie Kaufen aus, um mit der Bereitstellung zu beginnen.

3. Überprüfen Sie, ob die Bereitstellung erfolgreich abgeschlossen wurde. Warten Sie nach Abschluss der Bereitstellung einige Minuten, damit die Nachinstallation und Konfiguration von IoT Edge und dem Update-Paket-Agent für Geräte abgeschlossen werden können.

   Eine Ressource des virtuellen Computers sollte in der ausgewählten Ressourcengruppe bereitgestellt worden sein. 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.

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

   

   Tipp

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

4. Öffnen Sie die Konfigurationsdetails (Weitere Informationen zum Einrichten der Konfigurationsdatei finden Sie hier mit dem folgenden Befehl. Legen Sie Ihren connectionType als "AIS" und "connectionData" als leere Zeichenfolge fest.

/etc/adu/du-config.json

5. Starten Sie den Geräteupdate-Agent neu, indem Sie den folgenden Befehl ausführen:

 sudo systemctl restart adu-agent

Softwarepakete von Device Update for Azure IoT Hub unterliegen den folgenden Lizenzbedingungen:

• Geräte-Update für IoT Hub Lizenz
• Lizenz für den Übermittlungsoptimierungs-Client

Lesen Sie die Lizenzbedingungen, bevor Sie ein Paket verwenden. Durch Ihre Installation und Verwendung eines Pakets erklären Sie Ihre Zustimmung zu diesen Bedingungen. Wenn Sie den Lizenzbedingungen nicht zustimmen, verwenden Sie das Paket nicht.

Manuelles Vorbereiten eines Geräts

Ähnlich wie bei den Schritten, die durch das Cloud init-Skript automatisiert werden, werden die folgenden manuellen Schritte zum Installieren und Konfigurieren eines Geräts verwendet. Führen Sie die folgenden Schritte aus, um ein physisches Gerät vorzubereiten.

1. Befolgen Sie die Anweisungen zum Installieren der Azure IoT Edge-Laufzeit.

   Hinweis

   Der Geräteupdate-Agent hängt nicht von IoT Edge ab. Es basiert jedoch auf dem IoT Identity Service-Daemon, der mit IoT Edge (1.2.0 und höher) installiert ist, um eine Identität zu erhalten und eine Verbindung mit IoT Hub herzustellen.

   Obwohl dies in diesem Lernprogramm nicht behandelt wird, kann der IoT Identity Service-Daemon auf Linux-basierten IoT-Geräten selbstständig installiert werden. Die Abfolge der Installation ist wichtig. Der Device Update-Paket-Agent muss nach dem IoT Identity Service installiert werden. Andernfalls wird der Paket-Agent nicht als autorisierte Komponente registriert, um eine Verbindung mit IoT Hub herzustellen.

2. Installieren Sie die Geräteaktualisierungs-Agent-Paketdateien im .deb-Format.

   sudo apt-get install deviceupdate-agent deliveryoptimization-plugin-apt 
   

3. Geben Sie die primäre Verbindungszeichenfolge des Moduls (oder des Geräts, je nachdem, wie Sie das Gerät mit Device Update bereitgestellt haben) in der Konfigurationsdatei ein, indem Sie den folgenden Befehl ausführen:

   /etc/adu/du-config.json
   

4. Starten Sie den Geräteupdate-Agent neu, indem Sie den folgenden Befehl ausführen:

    sudo systemctl restart adu-agent
   

Softwarepakete von Device Update for Azure IoT Hub unterliegen den folgenden Lizenzbedingungen:

• Geräte-Update für IoT Hub Lizenz
• Lizenz für den Übermittlungsoptimierungs-Client

Lesen Sie die Lizenzbedingungen, bevor Sie ein Paket verwenden. Durch Ihre Installation und Verwendung eines Pakets erklären Sie Ihre Zustimmung zu diesen Bedingungen. Wenn Sie den Lizenzbedingungen nicht zustimmen, verwenden Sie das Paket nicht.

Hinzufügen eines Tags zu Ihrem Gerät

1. Melden Sie sich beim Azure-Portal an, und navigieren Sie zum IoT-Hub.

2. Suchen Sie im linken Bereich unter Geräte nach Ihrem IoT Edge-Gerät, und öffnen Sie den Geräte- oder Modulzwilling.

3. Löschen Sie im Modulzwilling des Device Update-Agent-Moduls alle vorhandenen Device Update-Tagwerte, indem Sie sie auf „NULL“ festlegen. Wenn Sie die Geräte-Identität mit dem Geräteaktualisierungs-Agenten verwenden, nehmen Sie diese Änderungen im Gerätezwilling vor.

4. Fügen Sie wie hier gezeigt einen neuen Device Update-Tagwert hinzu:

       "tags": {
               "ADUGroup": "<CustomTagValue>"
               },
   

Importieren des Updates

1. Wechseln Sie in GitHub zu Device Update-Releases, und wählen Sie die Dropdownliste Ressourcen aus. Laden Sie die Datei Tutorial_IoTEdge_PackageUpdate.zip herunter, indem Sie sie auswählen. Extrahieren Sie den Inhalt des Ordners, um ein APT-Beispielmanifest zu ermitteln (sample-1.0.2-aziot-edge-apt-manifest.json) und dessen entsprechendes Importmanifest (sample-1.0.2-aziot-edge-importManifest.json).

2. Melden Sie sich beim Azure-Portal an, und navigieren Sie zu Ihrem IoT-Hub mit Device Update. Wählen Sie im linken Bereich unter Automatische Geräteverwaltung die Option Updates aus.

3. Wählen Sie die Registerkarte Updates aus.

4. Wählen Sie + Neues Update importieren aus.

5. Klicken Sie auf + Aus Speichercontainer auswählen. Wählen Sie ein vorhandenes Konto aus, oder erstellen Sie über die Option + Speicherkonto ein neues. Wählen Sie dann einen vorhandenen Container aus, oder erstellen Sie mithilfe von + Container einen neuen. Dieser Container wird zum Stagen Ihrer Updatedateien für den Import verwendet.

   Hinweis

   Es wird empfohlen, bei jedem Import eines Updates einen neuen Container zu verwenden, um zu vermeiden, dass versehentlich Dateien aus früheren Updates importiert werden. Wenn Sie keinen neuen Container verwenden, müssen Sie vor diesem Schritt alle Dateien aus dem vorhandenen Container löschen.

   

6. Wählen Sie in Ihrem Container Hochladen aus, und wechseln Sie zu den in Schritt 1 heruntergeladenen Dateien. Nachdem Sie alle Updatedateien ausgewählt haben, wählen Sie Hochladen aus. Klicken Sie dann auf die Schaltfläche Auswählen, um zur Seite Update importieren zurückzukehren.

   

   Dieser Screenshot veranschaulicht den Importschritt. Dateinamen stimmen möglicherweise nicht mit denen überein, die im Beispiel verwendet werden.

7. Überprüfen Sie auf der Seite Update importieren die zu importierenden Dateien. Klicken Sie dann auf Update importieren, um den Importvorgang zu starten.

   

8. Der Importvorgang beginnt, und auf dem Bildschirm wird der Abschnitt Importverlauf angezeigt. Wenn in der Spalte Status angezeigt wird, dass der Import erfolgreich war, wählen Sie den Header Verfügbare Updates aus. Ihr importiertes Update sollte nun in der Liste angezeigt werden.

   

Erfahren Sie mehr über das Importieren von Updates.

Erstellen einer Updategruppe

1. Navigieren Sie oben auf der Seite zur Registerkarte Gruppen und Bereitstellungen.

   

2. Wählen Sie die Schaltfläche " Gruppe hinzufügen " aus, um eine neue Gruppe zu erstellen.

   

3. Wählen Sie in der Liste ein IoT Hub-Tag und eine Geräteklasse aus. Wählen Sie anschließend Gruppe erstellen aus.

   

4. Nachdem die Gruppe erstellt wurde, sehen Sie, dass das Updatekonformitätsdiagramm und die Gruppenliste aktualisiert werden. Das Updatekonformitätsdiagramm zeigt die Anzahl von Geräten in verschiedenen Konformitätszuständen: Mit neuestem Update, Neue Updates verfügbar und Updates werden ausgeführt. Informieren Sie sich weiter über die Updatekonformität.

   

5. Ihre neu erstellte Gruppe und alle verfügbaren Updates für die Geräte in der neuen Gruppe sollten angezeigt werden. Wenn Geräte vorhanden sind, die die Geräteklassenanforderungen der Gruppe nicht erfüllen, werden sie in einer entsprechenden ungültigen Gruppe angezeigt. Um das beste verfügbare Update aus dieser Ansicht für die neue benutzerdefinierte Gruppe bereitzustellen, klicken Sie neben der Gruppe auf Bereitstellen.

Erfahren Sie mehr darüber, wie Sie Tags hinzufügen und Updategruppen erstellen.

Bereitstellen des Updates

1. Nachdem die Gruppe erstellt wurde, sollte unter Bestes Update ein neues Update für Ihre Gerätegruppe mit dem entsprechenden Link angezeigt werden. Möglicherweise müssen Sie den Browser einmal aktualisieren. Informieren Sie sich weiter über die Updatekonformität.

2. Wählen Sie die Zielgruppe aus, indem Sie den Gruppennamen auswählen. Sie werden zu den Gruppendetails unter Allgemeine Informationen zu Gruppen weitergeleitet.

   

3. Um die Bereitstellung einzuleiten, wechseln Sie zur Registerkarte Aktuelle Bereitstellung. Wählen Sie im Abschnitt Verfügbare Updates neben dem gewünschten Update den Link Bereitstellen aus. Das beste verfügbare Update für eine bestimmte Gruppe wird mit Beste hervorgehoben.

   

4. Planen Sie den Start Ihrer Bereitstellung sofort oder zu einem späteren Zeitpunkt. Wählen Sie dann Erstellen aus.

   Tipp

   Das Startdatum und die Uhrzeit sind standardmäßig 24 Stunden ab Ihrer aktuellen Zeit festgelegt. Wählen Sie unbedingt ein anderes Datum und eine andere Uhrzeit aus, wenn die Bereitstellung früher beginnen soll.

   

5. Unter Bereitstellungsdetails wird der Status in Aktiv geändert. Das Bereitstellungsupdate ist mit (Wird bereitgestellt) gekennzeichnet.

   

6. Zeigen Sie das Kompatibilitätsdiagramm an, um herauszufinden, ob das Update jetzt in Bearbeitung ist.

7. Nachdem das Gerät erfolgreich aktualisiert wurde, erkennen Sie, dass Ihr Konformitätsdiagramm und die Bereitstellungsdetails so aktualisiert wurden, dass sie übereinstimmen.

   

Überwachung der Updatebereitstellung

1. Klicken Sie oben auf der Seite auf die Registerkarte Bereitstellungsverlauf.

   

2. Wählen Sie neben der von Ihnen erstellten Bereitstellung den Link Details aus.

   

3. Wählen Sie Aktualisieren aus, um die neuesten Statusdetails anzuzeigen.

Sie haben nun ein erfolgreiches End-to-End-Paketupdate mithilfe des Geräteupdates für IoT Hub auf einem Ubuntu Server 18.04 x64-Gerät abgeschlossen.

Bereinigen von Ressourcen

Bereinigen Sie Ihr Konto, die Instanz und den IoT-Hub für Device Update, wenn Sie diese Komponenten nicht mehr benötigten. Bereinigen Sie außerdem das IoT Edge-Gerät, wenn Sie die VM über die Schaltfläche In Azure bereitstellen erstellt haben. Wechseln Sie zum Bereinigen von Ressourcen zu jeder einzelnen Ressource, und wählen Sie Löschen aus. Bereinigen Sie eine Device Update-Instanz, bevor Sie das Device Update-Konto bereinigen.

Nächste Schritte

Verwenden Sie die folgenden Lernprogramme für eine einfache Demonstration des Geräteupdates für IoT Hub:

• Image Update: Erste Schritte mit dem Raspberry Pi 3 B+ Referenz-Yocto-Image, erweiterbar über Open Source, um bei Bedarf eigene Images für andere Architekturen zu erstellen.
• Proxyupdate: Erste Schritte mit device Update binary agent for downstream devices.
• Erste Schritte mit Ubuntu (18.04 x64) Simulatorreferenz-Agent.
• Device Update for Azure IoT Hub tutorial for Azure real-time operating system.