Bereitstellen eines Updates mithilfe von Device Update for IoT Hub

Hier erfahren Sie, wie Sie mithilfe von Device Update for IoT Hub ein Update für ein IoT-Gerät bereitstellen.

Voraussetzungen

• Greifen Sie auf einen IoT-Hub mit aktiviertem Device Update for IoT Hub zu. Es wird empfohlen, für Ihre IoT Hub-Instanz den S1-Tarif (Standard) oder höher zu verwenden.
• Ein importiertes Update für das bereitgestellte Gerät.
• Ein IoT-Gerät (oder Simulator), das/der für Device Update in IoT Hub bereitgestellt wird.
• Das Gerät ist Teil mindestens einer Standardgruppe oder einer benutzerseitig erstellten Updategruppe.

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.

Bereitstellen des Updates

Azure portal

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

2. Wählen Sie im Navigationsmenü Updates aus, um die Seite Geräteupdate Ihrer IoT Hub-Instanz zu öffnen.

   

3. Wählen Sie oben auf der Seite die Registerkarte Gruppen und Bereitstellungen aus. Weitere Informationen finden Sie unter Gerätegruppen.

   

4. Zeigen Sie das Updatekompatibilitätsdiagramm und die Gruppenliste an. Es sollte ein neues Update für Ihre tagbasierte oder Standardgruppe verfügbar sein. Möglicherweise müssen Sie den Browser einmal aktualisieren. Weitere Informationen finden Sie unter Device Update-Compliance.

5. Wählen Sie neben mindestens ein Update verfügbar die Option „Bereitstellen“ aus, und vergewissern Sie sich, dass die beschreibende Bezeichnung, die Sie beim Importieren hinzugefügt haben, vorhanden ist und richtig aussieht.

6. Vergewissern Sie sich, dass die richtige Gruppe als Zielgruppe ausgewählt ist, und wählen Sie Bereitstellen aus.

7. Um die Bereitstellung zu starten, navigieren 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.

   

8. Planen Sie den Start Ihrer Bereitstellung unverzüglich oder in der Zukunft.

   Tipp

   Standardmäßig sind das Startdatum und die Startzeit auf „Sofort“ festgelegt. Wenn die Bereitstellung später beginnen soll, wählen Sie unbedingt ein anderes Datum und eine andere Uhrzeit aus.

   

9. Erstellen Sie bei Bedarf eine Richtlinie für automatisches Rollback. Klicken Sie anschließend auf Erstellen.

10. In den Bereitstellungsdetails wird der Status in Aktiv geändert. Das Bereitstellungsupdate ist mit (Wird bereitgestellt) gekennzeichnet.

    

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

    

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

    

Azure-Befehlszeilenschnittstelle

Der az iot du device group list, um zu prüfen, welches verfügbare Update das beste für Ihre Gruppe ist. Der Befehl nimmt folgende Argumente entgegen:

• --account: Der Device Update-Kontoname.
• --instance: Der Device Update-Instanzname.
• --group-id: Die Gerätegruppen-ID, die Sie mit dieser Bereitstellung als Ziel verwenden. Diese ID ist der Wert des ADUGroup-Tags oder $default für Geräte ohne Tag.
• --best-updates: Dieses Flag gibt an, dass der Befehl die besten verfügbaren Updates für die Gerätegruppe abrufen soll, einschließlich der Anzahl der Geräte, die das jeweilige Update benötigen.
• ‚--resource-group -g‘: Name der Ressourcengruppe des Geräteupdatekontos.
• ‚--update-compliance‘: Dieses Flag gibt an, dass der Befehl Informationen zur Updatekonformität der Gerätegruppe abrufen soll, z. B. wie viele Geräte über das neueste Update verfügen, wie viele neue Updates benötigen und wie viele beim Empfang eines neuen Updates ausgeführt werden.

az iot du device group list \
    --account <Device Update account name> \
    --instance <Device Update instance name>\
    --gid <device group id>\
    --best-updates {false, true}

Verwenden Sie az iot du device deployment create, um eine Bereitstellung für eine Gerätegruppe zu erstellen.

Der Befehl device deployment create akzeptiert folgende Argumente:

• --account: Der Device Update-Kontoname.
• --instance: Der Device Update-Instanzname.
• --group-id: Die Gerätegruppen-ID, die Sie mit dieser Bereitstellung als Ziel verwenden. Diese ID ist der Wert des ADUGroup-Tags oder $default für Geräte ohne Tag.
• --deployment-id: Eine ID zum Identifizieren dieser Bereitstellung.
• --update-name, --update-providerund --update-version: Diese drei Parameter definieren das updateId-Objekt, das ein eindeutiger Bezeichner für das Update ist, das Sie in dieser Bereitstellung verwenden.

az iot du device deployment create \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --group-id <device group id> \
    --deployment-id <deployment id> \
    --update-name <update name> \
    --update-provider <update provider> \
    --update-version <update version>

Mit optionalen Argumenten können Sie die Bereitstellung konfigurieren. Die vollständige Liste finden Sie unter Optionale Parameter.

Wenn Sie eine Richtlinie für automatisches Rollback erstellen möchten, fügen Sie die folgenden Parameter hinzu:

• --failed-count: Die Anzahl der fehlerhaften Geräte in einer Bereitstellung, die ein Rollback auslösen.
• --failed-percentage: Der Prozentsatz der fehlerhaften Geräte in einer Bereitstellung, die ein Rollback auslösen.
• --rollback-update-name, --rollback-update-provider, --rollback-update-version: Die updateID für das Update, das die Gerätegruppe verwendet, wenn ein Rollback initiiert wird.

az iot du device deployment create \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --group-id <device group id> \
    --deployment-id <deployment id> \
    --update-name <update name> \
    --update-provider <update provider> \
    --update-version <update version> \
    --failed-count 10 \
    --failed-percentage 5 \
    --rollback-update-name <rollback update name> \
    --rollback-update-provider <rollback update provider> \
    --rollback-update-version <rollback update version>

Wenn die Bereitstellung in Zukunft beginnen soll, verwenden Sie den --start-time-Parameter, um das datetime-Ziel für die Bereitstellung anzugeben.

az iot du device deployment create \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --group-id <device group id> \
    --deployment-id <deployment id> \
    --update-name <update name> \
    --update-provider <update provider> \
    --update-version <update version> \
    --start-time "2022-12-20T01:00:00"

Überwachen einer Updatebereitstellung

Azure portal

1. Wählen Sie die Gruppe aus, in der Sie die Bereitstellung ausgeführt haben, und navigieren Sie zur Registerkarte Aktuelle Updates oder Bereitstellungsverlauf, um zu bestätigen, dass die Bereitstellung aktuell ausgeführt wird.

   

2. Klicken Sie neben der erstellten Bereitstellung auf Details. Hier können Sie die Bereitstellungsdetails, Updatedetails und Zielgeräteklassendetails anzeigen. Optional können Sie einen Anzeigenamen für die Geräteklasse hinzufügen.

   

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

4. Sie können zur Ansicht „Gruppengrundlagen“ wechseln, um nach dem Status für ein bestimmtes Gerät zu suchen, oder filtern, um Geräte anzuzeigen, bei denen die Bereitstellung fehlgeschlagen ist.

Azure-Befehlszeilenschnittstelle

Verwenden Sie az iot du device deployment list, um die gesamte Bereitstellung für eine Gerätegruppe anzuzeigen.

az iot du device deployment list \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --group-id <device group id>

Verwenden Sie az iot du device deployment show, um die Details einer bestimmten Bereitstellung anzuzeigen.

az iot du device deployment show \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --group-id <device group ID> \
    --deployment-id <deployment ID>

Fügen Sie das --status-Flag hinzu, um Informationen darüber zurückzugeben, wie viele Geräte in der Bereitstellung aktuell ausgeführt, abgeschlossen oder fehlgeschlagen sind.

az iot du device deployment show \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --group-id <device group ID> \
    --deployment-id <deployment ID> \
    --status

Wiederholen einer Updatebereitstellung

Wenn die Bereitstellung aus irgendeinem Grund fehlschlägt, können Sie die Bereitstellung für fehlgeschlagene Geräte wiederholen.

Azure portal

1. Wechseln Sie auf dem Bildschirm Gruppendetails zur Registerkarte Aktuelle Bereitstellung.

   

2. Klicken Sie auf Für fehlgeschlagene Geräte wiederholen, und bestätigen Sie die Bestätigungsbenachrichtigung.

Azure-Befehlszeilenschnittstelle

Verwenden Sie az iot du device deployment retry, um eine Bereitstellung für eine Zieluntergruppe von Geräten zu wiederholen.

Dieser Befehl nimmt das --class-id-Argument an, das aus der Modell-ID und den Kompatibilitätseigenschaften generiert wird, die vom Device Update-Agent gemeldet werden.

az iot du device deployment retry \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --deployment-id <deployment ID> \
    --group-id <device group ID> \
    --class-id <device class ID>

Nächste Schritte

Häufig auftretende Probleme und Problembehandlung