Bereitstellen eines Updates mithilfe von Azure Device Update for IoT Hub

In diesem Artikel erfahren Sie, wie Sie mithilfe von Azure Device Update for IoT Hub im Azure-Portal oder mit der Azure-Befehlszeilenschnittstelle (Command Line Interface, CLI) ein Update auf IoT-Geräten bereitstellen.

Voraussetzungen

• Eine Standardinstanz (S1) oder eine höhere Instanz von Azure IoT Hub, für die Device Update for IoT Hub aktiviert ist.
• Ein für Device Update bereitgestelltes IoT-Gerät oder ein entsprechender Simulator im IoT-Hub. Das bereitgestellte Gerät kann Mitglied einer vom Benutzer erstellten Gerätegruppe oder der Standardgruppe sein.
• Ein importiertes Update für das bereitgestellte Gerät.

Bereitstellen des Updates

In diesem Abschnitt wird beschrieben, wie Sie das Update im Azure-Portal oder mit der Azure CLI bereitstellen.

Azure portal

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

2. Wählen Sie im linken Navigationsbereich unter Geräteverwaltung die Option Updates aus.

   

3. Wählen Sie auf der Seite Updates die Registerkarte Gruppen und Bereitstellungen aus, und zeigen Sie das Diagramm zur Updatekonformität sowie die Liste der Gerätegruppen an. Möglicherweise müssen Sie die Ansicht aktualisieren, um kürzlich importierte Updates anzuzeigen, die für Ihre Gerätegruppe verfügbar sind.

4. Wählen Sie in der Gruppenliste unter Status neben Mindestens ein neues Update ist für diese Gruppe verfügbar die Option Bereitstellen aus.

   

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

6. Wählen Sie neben dem Status Mindestens ein neues Update ist für diese Gruppe verfügbar die Option Bereitstellen aus.

7. Wählen Sie in der Liste auf der rechten Seite das Update aus, das Sie bereitstellen möchten.

   

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

   Tipp

   Das Startdatum und die Uhrzeit sind standardmäßig auf Werte festgelegt, die vom aktuellen Zeitpunkt aus 24 Stunden in der Zukunft liegen. Wählen Sie unbedingt ein anderes Datum und eine andere Uhrzeit aus, wenn die Bereitstellung früher oder später beginnen soll.

   

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

10. Auf der Registerkarte Aktuelle Updates können Sie den Status Ihrer Bereitstellung anzeigen.

    

11. In der Ansicht Allgemeine Informationen zu Gruppen zeigt das Konformitätsdiagramm, dass das Update jetzt ausgeführt wird.

    Nachdem Ihr Gerät erfolgreich aktualisiert wurde, werden ihr Compliancediagramm und die Bereitstellungsdetails aktualisiert, um diesen Status widerzuspiegeln.

Azure-Befehlszeilenschnittstelle

Sie können die Bash-Umgebung in Azure Cloud Shell verwenden, um die folgenden Befehle 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.

Überprüfen der Verfügbarkeit von Updates

1. Verwenden Sie den Befehl az iot du device group list, um Ihre Gerätegruppe zu identifizieren.

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

2. Verwenden Sie dann az iot du device group show, um das beste verfügbare Update für Ihre Gruppe anzuzeigen. Der Befehl akzeptiert folgende Argumente:

   • --account: Der Device Update-Kontoname.
   • --instance: der Device Update-Instanzname
   • --group-id: Die Gerätegruppen-ID, die das Ziel dieser Bereitstellung ist (Wert des ADUGroup-Tags oder $default für Geräte ohne Tag).
   • --resource-group: Der Ressourcengruppenname des Device Update-Kontos.
   • --best-updates: Gibt die besten verfügbaren Updates für die Gerätegruppe zurück, einschließlich der Anzahl von Geräten, für die die einzelnen Updates erforderlich sind.
   • --update-compliance: Gibt Informationen zur Updatekonformität der Gerätegruppe zurück, z. B. wie viele Geräte über das neueste Update verfügen, wie viele Geräte neue Updates benötigen und wie viele Geräte derzeit ein neues Update erhalten.

   Um das beste verfügbare Update für Ihre Gruppe zu überprüfen, führen Sie den Befehl wie folgt aus:

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

Erstellen der Bereitstellung

Verwenden Sie az iot du device deployment create, um eine Bereitstellung für die Gerätegruppe zu erstellen. Der Befehl akzeptiert folgende Argumente:

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

Führen Sie den -Befehl folgendermaßen aus:

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>

Verwenden optionaler Argumente

Mit optionalen Argumenten können Sie die Bereitstellung zusätzlich konfigurieren. Eine vollständige Liste der optionalen Argumente finden Sie unter Optionale Parameter.

Um eine Richtlinie für automatisches Rollback zu erstellen, fügen Sie die folgenden Parameter hinzu:

• --failed-count: Die Anzahl fehlerhafter Geräte in einer Bereitstellung, bei der ein Rollback ausgelöst wird.
• --failed-percentage: Der Prozentsatz fehlerhafter Geräte in einer Bereitstellung, bei dem ein Rollback ausgelöst wird.
• --rollback-update-name, --rollback-update-provider, --rollback-update-version: Die Parameter, die das Update verwenden soll, wenn ein Rollback initiiert wird.

Führen Sie den -Befehl folgendermaßen aus:

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>

Um die Startzeit der Bereitstellung festzulegen, geben Sie das Zieldatum und die Zielzeit für die Bereitstellung wie folgt mit dem --start-time-Parameter an:

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 des Bereitstellungsstatus

Azure portal

1. Wählen Sie auf der Registerkarte Gruppen und Bereitstellungen der Seite Updates die Gruppe aus, für die Sie das Update bereitgestellt haben.

2. Wechseln Sie auf der Seite Gruppendetails zur Registerkarte Aktuelle Bereitstellung oder Bereitstellungsverlauf, um zu bestätigen, dass eine Bereitstellung ausgeführt wird.

   

3. Wählen Sie neben einer Bereitstellung die Option Details aus, um die Details zur Bereitstellung, zum Update und zur Zielgeräteklasse anzuzeigen. Optional können Sie einen Anzeigenamen für die Geräteklasse hinzufügen.

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

   

Wechseln Sie zur Registerkarte Allgemeine Informationen zu Gruppen der Seite Gruppendetails, um nach dem Status eines bestimmten Geräts zu suchen oder die Ansicht nach Geräten zu filtern, auf denen die Bereitstellung fehlgeschlagen ist.

Azure-Befehlszeilenschnittstelle

Verwenden Sie az iot du device deployment list, um alle Bereitstellungen 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

Falls Ihre Bereitstellung fehlschlägt, können Sie sie für Geräte, auf denen ein Fehler aufgetreten ist, 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>

Zugehöriger Inhalt

• Geräteupdatebereitstellungen
• Leitfaden zur Problembehandlung für Device Update