Lernprogramm: Abschließen eines Proxyupdates mithilfe von Device Update für Azure IoT Hub

Wenn Sie dies noch nicht getan haben, lesen Sie die Verwendung von Proxyupdates mit Device Update für Azure IoT Hub.

Einrichten eines Testgeräts oder eines virtuellen Computers

Dieses Lernprogramm verwendet einen virtuellen Ubuntu Server 18.04 LTS-Computer (VM) als Beispiel.

Installieren des Geräteupdate-Agents und der Abhängigkeiten

1. Registrieren Sie packages.microsoft.com in einem APT-Paket-Repository:

   sudo apt-get update
   
   sudo apt install curl
   
   curl https://packages.microsoft.com/config/ubuntu/18.04/multiarch/prod.list > ~/microsoft-prod.list
   
   sudo cp ~/microsoft-prod.list /etc/apt/sources.list.d/
   
   curl https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > ~/microsoft.gpg
   
   sudo cp ~/microsoft.gpg /etc/apt/trusted.gpg.d/
   
   sudo apt-get update
   

2. Installieren Sie den DeviceUpdate-Agent auf dem IoT-Gerät . Laden Sie die neueste Debian-Datei des Geräteupdates aus packages.microsoft.com herunter:

   sudo apt-get install deviceupdate-agent
   

   Alternativ können Sie die heruntergeladene Debian-Datei auf den virtuellen Testcomputer kopieren. Wenn Sie PowerShell auf Ihrem Computer verwenden, führen Sie den folgenden Shellbefehl aus:

     scp <path to the .deb file> tester@<your vm's ip address>:~
   

   Remoten Sie dann auf Ihren virtuellen Computer, und führen Sie den folgenden Shellbefehl im Startordner aus:

         #go to home folder 
         cd ~
         #install latest Device Update agent
         sudo apt-get install ./<debian file name from the previous step>
   

3. Wechseln Sie zu Azure IoT Hub, und kopieren Sie die primäre Verbindungszeichenfolge für das Device Update-Modul Ihres IoT-Geräts. Ersetzen Sie einen beliebigen Standardwert für das connectionData Feld durch die primäre Verbindungszeichenfolge in der dateidu-config.json :

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

   Hinweis

   Sie können stattdessen die primäre Verbindungszeichenfolge für das Gerät kopieren, es wird jedoch empfohlen, die Zeichenfolge für das Device Update-Modul zu verwenden. Informationen zum Einrichten des Moduls finden Sie unter Device Update Agent provisioning.

4. Stellen Sie sicher, dass /etc/adu/du-diagnostics-config.json die richtigen Einstellungen für die Protokollsammlung enthält. Beispiel:

   {
     "logComponents":[
       {
         "componentName":"adu",
          "logPath":"/var/log/adu/"
       },
       {
         "componentName":"do",
         "logPath":"/var/log/deliveryoptimization-agent/"
       }
     ],
     "maxKilobytesToUploadPerLogPath":50
   }
   

5. Starten Sie den Geräteaktualisierungs-Agent neu:

   sudo systemctl restart adu-agent
   

Einrichten von Simulierten Komponenten

Zu Test- und Demonstrationszwecken erstellen wir die folgenden simulierten Komponenten auf dem Gerät:

• Drei Motoren
• Zwei Kameras
• hostfs
• "rootfs"

1. Kopieren Sie den Demoordner in Ihr Startverzeichnis auf der Test-VM. Führen Sie dann den folgenden Befehl aus, um erforderliche Dateien an die richtigen Speicherorte zu kopieren:

   `~/demo/tools/reset-demo-components.sh` 
   

   Der reset-demo-components.sh Befehl führt die folgenden Schritte in Ihrem Auftrag aus:

   1. Sie kopiert components-inventory.json und fügt sie dem Ordner "/usr/local/contoso-devices " hinzu.

   2. Sie kopiert die Enumerationserweiterung der Contoso-Komponente (libcontoso-component-enumerator.so) aus dem Ordner "Assets " und fügt sie dem Ordner "/var/lib/adu/extensions/sources " hinzu.

   3. Sie registriert die Erweiterung:

      sudo /usr/bin/AducIotAgent -E /var/lib/adu/extensions/sources/libcontoso-component-enumerator.so
      

2. Anzeigen und Aufzeichnen der Softwareversion der aktuellen Komponenten mithilfe des folgenden Befehls zum Einrichten der VM zur Unterstützung von Proxyupdates:

   ~/demo/show-demo-components.sh
   

Importieren eines Beispielupdates

Falls noch nicht geschehen, erstellen Sie ein Geräteaktualisierungskonto und eine Instanz, einschließlich der Konfiguration eines IoT-Hubs. Starten Sie dann das folgende Verfahren.

1. Laden Sie aus der neuesten Geräteupdate-Version unter "Assets" die Importmanifeste und -bilder für Proxyupdates herunter.

2. Melden Sie sich beim Azure-Portal an, und navigieren Sie zu Ihrem IoT-Hub mit Device Update. Wählen Sie im linken Bereich "Geräteverwaltungsupdates>" aus.

3. Wählen Sie die Registerkarte Updates aus.

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

5. Wählen Sie + Aus Speichercontainer auswählen, und wählen Sie dann Ihr Speicherkonto und Ihren Container aus.

   

6. Wählen Sie "Hochladen" aus, um die Dateien hinzuzufügen, die Sie in Schritt 1 heruntergeladen haben.

7. Laden Sie das Eltern-Importmanifest, das Kind-Importmanifest und die Nutzlastdateien in Ihren Container hoch.

   Das folgende Beispiel zeigt Beispieldateien, die hochgeladen wurden, um Kameras zu aktualisieren, die mit einem intelligenten Staubsaugergerät verbunden sind. Es enthält auch ein Skript vor der Installation, um die Kameras vor dem Over-the-Air-Update zu deaktivieren.

   Im Beispiel ist das übergeordnete Importmanifest contoso.Virtual-Vacuum-virtual-camera.1.4.importmanifest.json. Das Importmanifest für das Kind, das Details zur Aktualisierung der Kamera enthält, ist Contoso.Virtual-Vacuum.3.3.importmanifest.json. Beachten Sie, dass beide Manifestdateinamen dem erforderlichen Format folgen und mit .importmanifest.jsonenden.

   

8. Klicken Sie auf Auswählen.

9. Auf der Benutzeroberfläche wird nun die Liste der Dateien angezeigt, die in "Geräteaktualisierung" importiert werden. Wählen Sie "Update importieren" aus.

   

10. Der Importvorgang beginnt, und der Bildschirm ändert sich im Abschnitt " Importverlauf ". Wählen Sie "Aktualisieren" aus, um den Fortschritt anzuzeigen, bis der Importvorgang abgeschlossen ist. Je nach Größe des Updates kann der Import einige Minuten dauern oder länger dauern.

11. Wenn die Spalte "Status " angibt, dass der Import erfolgreich war, wählen Sie die Registerkarte "Verfügbare Updates " aus. Das importierte Update sollte jetzt in der Liste angezeigt werden.

    

Erfahren Sie mehr zum Importieren von Updates.

Updategruppe erstellen

1. Wechseln 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, und wählen Sie dann "Gruppe erstellen" aus.

4. Nachdem die Gruppe erstellt wurde, sehen Sie, dass das Update-Konformitätsdiagramm und die Gruppenliste aktualisiert werden. Das Diagramm "Update-Compliance" zeigt die Anzahl der Geräte in verschiedenen Compliance-Zuständen an: Mit dem neuesten Update, Neue Updates verfügbar und Updates in Bearbeitung. #B0 Erfahren Sie mehr über die Update-Compliance. #A1 #A2 #A3 #A4 #A5 Screenshot der Ansicht "Update-Compliance". #A6 #A7 #A8 #C9

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. Sie können das beste verfügbare Update für die neue benutzerdefinierte Gruppe aus dieser Ansicht bereitstellen, indem Sie auf die Schaltfläche "Bereitstellen" neben der Gruppe klicken.

Erfahren Sie mehr über das Hinzufügen von Tags und Erstellen von Updategruppen

Update bereitstellen

1. Nachdem die Gruppe erstellt wurde, sollte ein neues Update für Ihre Gerätegruppe mit einem Link zum Update unter "Bestes Update" angezeigt werden (möglicherweise müssen Sie einmal aktualisieren). Weitere Informationen zur Updatecompliance.

2. Wählen Sie die Zielgruppe aus, indem Sie auf den Gruppennamen klicken. Sie werden unter "Gruppengrundlagen" zu den Gruppendetails weitergeleitet.

3. Um die Bereitstellung zu initiieren, wechseln Sie zur Registerkarte "Aktuelle Bereitstellung". Klicken Sie im Abschnitt "Verfügbare Updates" auf den Link "Bereitstellen" neben dem gewünschten Update. Das beste, verfügbare Update für eine bestimmte Gruppe wird mit einem "Besten" Highlight gekennzeichnet.

4. Planen Sie die Bereitstellung so, dass sie sofort oder in Zukunft gestartet wird, und wählen Sie dann "Erstellen" aus.

5. Der Status unter den Bereitstellungsdetails sollte sich zu "Aktiv" ändern, und das bereitgestellte Update sollte mit "(wird bereitgestellt)" gekennzeichnet werden.

6. Zeigen Sie das Compliance-Diagramm an. Sie sollten sehen, dass das Update jetzt ausgeführt wird.

7. Nachdem Ihr Gerät erfolgreich aktualisiert wurde, sollten das Compliance-Diagramm und die Bereitstellungsdetails aktualisiert werden und diesen Zustand widerspiegeln.

   

Überwachen einer Updatebereitstellung

1. Wählen Sie oben auf der Seite die Registerkarte "Bereitstellungsverlauf" aus.

   

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

   

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

Sie haben nun ein erfolgreiches End-to-End-Proxyupdate mithilfe von Device Update für IoT Hub abgeschlossen.

Bereinigen von Ressourcen

Wenn Sie sie nicht mehr benötigen, bereinigen Sie Ihr Geräteaktualisierungskonto, ihre Instanz, Den IoT-Hub und das IoT-Gerät.

Nächste Schritte

Sie können die folgenden Lernprogramme für eine einfache Demonstration des Geräteupdates für IoT Hub verwenden:

• Geräte-Update für Azure IoT Hub Tutorial unter Verwendung des Raspberry Pi 3 B+ Referenzbildes (erweiterbar durch Open-Source, um bei Bedarf eigene Bilder für andere Architekturen zu erstellen)

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

• Gerät Aktualisierung für das Azure IoT Hub Tutorial unter Verwendung des Ubuntu (18.04 x64) Simulator-Referenzagenten

• Lernprogramm zum Geräteupdate für Azure IoT Hub mithilfe des Azure-Betriebssystems in Echtzeit