Importieren eines Updates in Device Update for IoT Hub

Hier erfahren Sie, wie Sie ein neues Update abrufen und in das Geräte-Update für den IoT-Hub importieren. Wenn Sie dies noch nicht wissen, sollten Sie sich unbedingt mit den wichtigsten Importkonzepten und der Vorbereitung eines Updates für den Import vertraut machen.

Voraussetzungen

• Zugriff auf einen IoT-Hub mit aktiviertem Device Update for IoT Hub

• Ein Azure Storage-Container ohne aktivierten privaten Endpunkt.

  • Wenn Sie nicht sicher sind, ob ein privater Endpunkt aktiviert ist, rufen Sie das Private Link Center auf, wählen Sie links „Private Endpunkte“ aus und suchen Sie dann in der Spalte „Ressourcen“ nach dem Namen Ihres Azure-Speicherkontos.

• Ein für Device Update bereitgestelltes IoT-Gerät (oder ein entsprechender Simulator) in IoT Hub.

• Führen Sie die Schritte unter Vorbereiten eines Updates für den Import in Device Update for IoT Hub aus, um das Importmanifest für Ihre Updatedateien zu erstellen.

Azure portal

Unterstützte Browser:

• Microsoft Edge
• Google Chrome

Azure-Befehlszeilenschnittstelle

Eine Azure CLI-Umgebung:

• Verwenden Sie die Bash-Umgebung in Azure Cloud Shell.

  

• Wenn Sie CLI-Referenzbefehle lieber lokal ausführen, installieren Sie die Azure CLI

  1. Melden Sie sich mit dem Befehl az login bei der Azure CLI an.
  2. Führen Sie az version aus, um die installierte Version und die abhängigen Bibliotheken zu ermitteln. Führen Sie az upgrade aus, um das Upgrade auf die aktuelle Version durchzuführen.
  3. Installieren Sie die Azure CLI-Erweiterungen bei der ersten Verwendung, wenn Sie dazu aufgefordert werden. Die Befehle in diesem Artikel verwenden die azure-iot-Erweiterung . Führen Sie az extension update --name azure-iot aus, um sicherzustellen, dass Sie die neueste Version der Erweiterung verwenden.

Tipp

Die Azure CLI-Befehle in diesem Artikel verwenden den umgekehrten Schrägstrich (\) für die Zeilenfortsetzung, damit die Befehlsargumente einfacher lesbar sind. Diese Syntax funktioniert in Bash-Umgebungen. Wenn Sie diese Befehle in PowerShell ausführen, ersetzen Sie jeden umgekehrten Schrägstrich durch ein Graviszeichen („`“), oder entfernen Sie die umgekehrten Schrägstriche vollständig.

Importieren eines Updates

In diesem Abschnitt wird gezeigt, wie Sie ein Update entweder über das Azure-Portal oder mit der Azure-Befehlszeilenschnittstelle importieren. Sie können stattdessen auch das Geräteupdate für IoT Hub-APIs verwenden, um ein Update zu importieren.

Zum Importieren eines Updates laden Sie zunächst die Updatedateien und das Importmanifest in einen Azure Storage-Container hoch. Anschließend importieren Sie das Update aus Azure Storage in Device Update for IoT Hub. Dort wird es für Sie zum Bereitstellen auf Geräten gespeichert.

Azure portal

1. Navigieren Sie im Azure-Portal zu Ihrem IoT-Hub mit Device Update.

2. Wählen Sie links auf der Seite unter Geräteverwaltung die Option Updates aus.

   

3. Wählen Sie die Registerkarte Updates in der Liste der Registerkarten am oberen Bildschirmrand aus.

   

4. Wählen Sie unter dem Header Verfügbare Updates die Option + Neues Update importieren aus.

   

5. Klicken Sie auf + Aus Speichercontainer auswählen. Die Benutzeroberfläche für Speicherkonten wird angezeigt. Wählen Sie ein vorhandenes Speicherkonto aus, oder erstellen Sie mit + Speicherkonto ein neues. Dieses Konto wird für einen Container verwendet, um Ihre Updates für den Import zu stagen. Für das Konto sollten nicht gleichzeitig öffentliche und private Endpunkte aktiviert sein.

   

6. Nachdem Sie ein Speicherkonto haben, wird die Benutzeroberfläche für Container angezeigt. Wählen Sie einen vorhandenen Container aus, oder erstellen Sie mit + Container einen neuen. Dieser Container wird zum Stagen Ihrer Updatedateien für den Import verwendet.

   Es wird empfohlen, bei jedem Import eines Updates einen neuen Container zu verwenden. Indem Sie immer neue Container verwenden, können Sie das versehentliche Importieren von Dateien aus früheren Updates vermeiden. Wenn Sie keinen neuen Container verwenden, müssen Sie unbedingt alle Dateien aus dem vorhandenen Container löschen, bevor Sie diesen Schritt abschließen.

   

7. Wählen Sie in Ihrem Container Hochladen aus. Die Benutzeroberfläche für Uploads wird angezeigt.

   

8. Wählen Sie das Ordnersymbol auf der rechten Seite des Abschnitts Dateien unter dem Header Blob hochladen aus. Verwenden Sie die Dateiauswahl, um zum Speicherort Ihrer Updatedateien und Ihres Importmanifests zu navigieren, und wählen Sie alle Dateien und dann Öffnen aus. Sie können die UMSCHALTTASTE gedrückt halten, um mehrere Dateien auszuwählen.

   

9. Nachdem Sie alle Updatedateien ausgewählt haben, wählen Sie Hochladen aus.

   

10. Wählen Sie die hochgeladenen Dateien aus, um sie für den Import festzulegen. Klicken Sie dann auf die Schaltfläche Auswählen, um zur Seite Update importieren zurückzukehren.

    

11. Überprüfen Sie auf der Seite „Update importieren“ die zu importierenden Dateien. Klicken Sie dann auf Update importieren, um den Importvorgang zu starten. Informationen zum Beheben möglicher Fehler finden Sie unter Problembehandlung bei Proxyupdates.

    

12. Der Importvorgang beginnt, und auf dem Bildschirm wird der Abschnitt Importverlauf angezeigt. Wählen Sie Aktualisieren aus, um den Status anzuzeigen, bis der Importvorgang abgeschlossen ist (je nach Größe des Updates kann dieser Vorgang innerhalb weniger Minuten abgeschlossen werden oder auch länger dauern).

    

13. 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.

    

Azure-Befehlszeilenschnittstelle

Der Befehl az iot du update stage verarbeitet die erforderlichen Schritte zum Importieren eines Updates, einschließlich des Hochladens der Updatedateien in einen Zielspeichercontainer. Ein optionales Flag ermöglicht auch, die Dateien mit diesem Befehl automatisch zu importieren, nachdem sie vorbereitet wurden. Andernfalls schließt der Befehl az iot du update import den Vorgang ab.

Der Befehl stage akzeptiert folgende Argumente:

• --account: Der Device Update-Kontoname.
• --instance: der Device Update-Instanzname
• --manifest-path: der Dateipfad zum Importmanifest, das bereitgestellt werden soll
• --storage-account: der Name des Speicherkontos, das für das Update gestaget werden soll
• --storage-container: der Name des Containers innerhalb des ausgewählten Speicherkontos, der für das Update gestaget werden soll
• --overwrite: optionales Flag, das angibt, ob vorhandene Blobs im Speichercontainer überschrieben werden sollen, wenn ein Konflikt vorliegt
• --then-import: optionales Flag, das angibt, ob das Update nach dem Stagen in Device Update importiert werden soll

az iot du update stage \
    --account <Replace with your Device Update account name> \
    --instance <Replace with your Device Update instance name> \
    --manifest-path <Replace with the full path to your import manifest> \
    --storage-account <Replace with your Storage account name> \
    --storage-container <Replace with your container name> \
    --overwrite --then-import

Beispiel:

az iot du update stage \
    --account deviceUpdate001 \
    --instance myInstance \
    --manifest-path /my/apt/manifest/file.importmanifest.json \
    --storage-account deviceUpdateStorage \
    --storage-container deviceUpdateDemo \
    --overwrite --then-import

Wenn Sie über mehrere Importmanifeste verfügen, können Sie alle in einen Befehl einschließen. Beispiel:

az iot du update stage \
    --account deviceUpdate001 \
    --instance myInstance \
    --manifest-path /my/apt/manifest/parent.importmanifest.json \
    --manifest-path /my/apt/manifest/child1.importmanifest.json \
    --manifest-path /my/apt/manifest/child2.importmanifest.json \
    --storage-account deviceUpdateStorage \
    --storage-container deviceUpdateDemo \
    --overwrite --then-import

Wenn Sie das Flag --then-import nicht verwenden, enthält die Ausgabe des Befehls stage die Aufforderung, az iot du update import mit den vorab ausgefüllten Argumenten auszuführen.

Mit az iot du update list können Sie überprüfen, ob Updates erfolgreich importiert wurden.

az iot du update list \
    --account <Replace with your Device Update account name> \
    --instance <Replace with your Device Update instance name> \
    -o table

Wenn Sie stattdessen über APIs importieren

Sie können ein Update wie folgt auch programmgesteuert importieren:

• Mit Azure SDK für .NET, Java, JavaScript oder Python
• Mit der REST-API für das Importieren von Updates
• Mit PowerShell-Beispielmodulen
  • Erfordert PowerShell 5 oder höher (ermöglicht Linux-, macOS- und Windows-Installationen)

Hinweis

Informationen zur erforderlichen API-Berechtigung finden Sie unter Benutzerrollen und -zugriff für Device Update.

Die Updatedateien und das Importmanifest müssen für das Staging in einen Azure Blob Storage-Container hochgeladen werden. Um die gestageten Dateien zu importieren, geben Sie die Blob-URL (oder die Shared Access Signature (SAS) bei privaten Blobs) in der Device Update-API an. Geben Sie bei Verwendung einer SAS ein Ablauffenster von mindestens drei Stunden an.

Tipp

Um große Updatedateien in Azure Blob Storage-Container hochzuladen, können Sie eine der folgenden Vorgehensweisen nutzen, um die Leistung zu verbessern:

• AzCopy
• Azure Storage-Explorer

Nächste Schritte

• Erstellen Sie Gruppen.
• Informieren Sie sich über Konzepte zum Importieren.