Importieren eines Updates in Azure Device Update for IoT Hub

Um ein Update auf Geräten mit Azure Device Update for IoT Hub bereitzustellen, importieren Sie zuerst die Updatedateien in Device Update, wo das importierte Update für die Bereitstellung auf Geräten gespeichert wird. In diesem Artikel erfahren Sie, wie Sie ein Update mithilfe des Azure-Portals, der Azure CLI oder der Device Update-APIs in Device Update importieren.

Voraussetzungen

• Ein Device Update-Konto und eine Instanz, die mit einem IoT-Hub konfiguriert sind.

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

• Aktualisieren Sie Dateien für Ihr Gerät und eine zugeordnete Importmanifestdatei, die mit den folgenden Anweisungen unter Vorbereiten eines Updates zum Importieren in Device Update erstellt wurde.

• Ein Azure Storage-Konto und ein Container, in dem die importierten Dateien gespeichert werden Alternativ können Sie ein neues Speicherkonto und einen neuen Container als Teil des Importvorgangs mit dem Azure-Portal erstellen.

  Wichtig

  Stellen Sie sicher, dass das verwendete oder erstellte Speicherkonto über keine aktivierten privaten Endpunkte verfügt. Um festzustellen, ob private Endpunkte aktiviert sind, können Sie unter Private Endpunkte in Private Link Center nach Ihrem Azure Storage-Kontonamen suchen.

Azure portal

• Unterstützte Browser Microsoft Edge oder Google Chrome

Azure-Befehlszeilenschnittstelle

• Eine Bash-Umgebung

  Sie können die Bash-Umgebung in Azure Cloud Shell verwenden, um die Befehle in diesem Artikel auszuführen. Wählen Sie Cloud Shell starten aus, um Cloud Shell zu öffnen, oder wählen Sie das Cloud Shell-Symbol auf der oberen Symbolleiste des Azure-Portals aus.

  

  Wenn Sie möchten, können Sie die Azure CLI-Befehle auch lokal ausführen:

  1. Azure-Befehlszeilenschnittstelle Führen Sie az version aus, um die installierte Azure CLI-Version und abhängige Bibliotheken anzuzeigen, und führen Sie az upgrade aus, um die aktuelle Version zu installieren.
  2. Melden Sie sich bei Azure an, indem Sie az login ausführen.
  3. Installieren Sie die Erweiterung azure-iot, wenn Sie bei der ersten Verwendung aufgefordert werden. Um sicherzustellen, dass Sie die aktuelle Version der Erweiterung verwenden, führen Sie az extension update --name azure-iot aus.

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 mithilfe der Device Update-APIs ein Update importieren.

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

Azure portal

1. Wählen Sie im Azure-Portal auf der Seite von IoT Hub für Ihre Device Update-Instanz im linken Navigationsbereich Geräteverwaltung>Updates aus.

   

2. Wählen Sie auf der Seite „Updates“ die Option „Neues Update importieren“aus.

   

3. Wählen Sie auf der Seite Update importieren Aus dem Speichercontainer auswählen aus.

4. Wählen Sie auf der Seite Speicherkonten ein vorhandenes Speicherkonto aus oder erstellen Sie ein neues Konto, indem Sie Speicherkonto auswählen. Sie verwenden das Speicherkonto für einen Container, um die Updatedateien zu stagen.

5. Wählen Sie auf der Seite Container einen vorhandenen Container aus oder erstellen Sie einen neuen Container, indem Sie Container auswählen. Sie verwenden den Container, um die Updatedateien für den Import zu stufen.

   

   Tipp

   Um versehentliches Importieren von Dateien aus früheren Updates zu vermeiden, verwenden Sie bei jedem Import eines Updates einen neuen Container. Wenn Sie keinen neuen Container verwenden, müssen Sie alle vorherigen Dateien aus dem vorhandenen Container löschen.

6. Wählen Sie auf der Container-Seite Hochladen aus.

   

7. Wählen Sie in der Ansicht Blob hochladen das Ordnersymbol neben Dateien aus. Verwenden Sie die Dateiauswahl, um zum Speicherort Ihrer Update- und Importmanifestdateien zu navigieren, und wählen Sie alle Dateien und dann Öffnen aus. Sie können die UMSCHALTTASTE verwenden, um mehrere Dateien auszuwählen.

   

8. Nachdem Sie alle Dateien ausgewählt haben, klicken Sie auf Hochladen.

   

9. Nach dem Hochladen werden die Dateien auf der Containerseite angezeigt. Überprüfen Sie auf der Containerseite die zu importierenden Dateien, und wählen Sie dann Auswählenaus.

   

10. Wählen Sie auf dem Bildschirm Update importieren die Option Update importieren aus.

    

Der Importvorgang beginnt, und der Bildschirm wechselt zur Seite Updates. Nach erfolgreichem Import wird es im Tab Updates angezeigt. Informationen zum Beheben möglicher Fehler finden Sie unter Problembehandlung bei Proxyupdates.

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 gestaget werden soll
• --storage-account: der Name des Speicherkontos, in dem das Update gestaget werden soll
• --storage-container: der Name des Containers innerhalb des ausgewählten Speicherkontos, in dem 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 zum Angeben, ob das Update nach dem Bereitstellen 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

Zum 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

Sie können mehrere Importmanifeste in einen Befehl einschließen. Zum 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 vorausgefüllten Argumenten auszuführen.

Verwenden Sie az iot du update list zum Überprüfen, ob Ihre 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

Importieren mithilfe der Device Update-APIs

Sie können ein Update auch programmgesteuert importieren, indem Sie eine der folgenden Methoden verwenden:

• Die Device Update-APIs in den Azure SDKs für .NET, Java, JavaScript oder Python
• Die Update importieren-REST-API von Device Update
• PowerShell-Beispielmodule (erfordert PowerShell 5 oder höher unter Linux, macOS oder Windows)

Hinweis

Informationen zur erforderlichen API-Berechtigung finden Sie unter Benutzerrollen und -zugriff in 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 beim Verwenden einer SAS ein Ablauffenster von mindestens drei Stunden an.

Tipp

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

• AzCopy
• Azure Storage-Explorer

Zugehöriger Inhalt

• Gerätegruppen
• Importmanifest für Device Update