Een update implementeren met behulp van Azure Device Update voor IoT Hub

In dit artikel leert u hoe u een update implementeert op IoT-apparaten met behulp van Azure Device Update voor IoT Hub in Azure Portal of met Azure CLI.

Vereisten

• Een standaardexemplaren (S1) of een hoger exemplaar van Azure IoT Hub waarvoor Device Update voor IoT Hub is ingeschakeld.
• Een IoT-apparaat of -simulator die is ingericht voor Device Update binnen de IoT-hub. Het ingerichte apparaat kan lid zijn van een door de gebruiker gemaakte apparaatgroep of de standaardgroep.
• Een geïmporteerde update voor het ingerichte apparaat.

De update implementeren

In deze sectie wordt beschreven hoe u de update implementeert met behulp van Azure Portal of Azure CLI.

Azure-portal

1. Navigeer in Azure Portal naar uw IoT-hub.

2. Selecteer Updates onder Apparaatbeheer in de linkernavigatiebalk.

   

3. Selecteer op de pagina Updates het tabblad Groepen en implementaties en bekijk het updatenalevingsdiagram en de lijst met apparaatgroepen. Mogelijk moet u de weergave vernieuwen om onlangs geïmporteerde updates te zien die beschikbaar zijn voor uw apparaatgroep.

4. Selecteer Onder Status in de groepslijst de optie Implementeren naast een of meer nieuwe updates zijn beschikbaar voor deze groep.

   

5. Bekijk het updatenalevingsdiagram en de groepslijst. U ziet nu een nieuwe update die beschikbaar is voor uw tag of standaardgroep. Mogelijk moet u één keer vernieuwen. Zie Apparaatupdate-naleving voor meer informatie.

6. Selecteer Implementeren naast de beschikbare status van een of meer updates.

7. Selecteer in de lijst aan de rechterkant de gewenste update die u wilt implementeren.

   

8. Plan de implementatie om onmiddellijk of in de toekomst te beginnen.

   Tip

   De begindatum en -tijd zijn standaard 24 uur vanaf uw huidige tijd. Zorg ervoor dat u een andere datum en tijd selecteert als u wilt dat de implementatie vroeg of later begint.

   

9. Maak indien nodig een beleid voor automatisch terugdraaien. Selecteer vervolgens Maken.

10. Op het tabblad Huidige updates kunt u de status van uw implementatie bekijken.

    

11. In de basisweergave Groep ziet u in het nalevingsdiagram dat de update nu wordt uitgevoerd.

    Nadat uw apparaat is bijgewerkt, worden uw nalevingsgrafiek en implementatiegegevens bijgewerkt om die status weer te geven.

Azure-CLI

U kunt de Bash-omgeving in Azure Cloud Shell gebruiken om de volgende opdrachten uit te voeren. Selecteer Cloud Shell starten om Cloud Shell te openen of selecteer het Cloud Shell-pictogram op de bovenste werkbalk van Azure Portal.

Als u wilt, kunt u de Azure CLI-opdrachten ook lokaal uitvoeren:

1. Installeer Azure CLI. Voer az version uit om de geïnstalleerde Azure CLI-versie en afhankelijke bibliotheken te bekijken en voer az upgrade uit om de nieuwste versie te installeren.
2. Meld u aan bij Azure door az login uit te voeren.
3. Installeer de azure-iot extensie wanneer u hierom wordt gevraagd voor het eerste gebruik. Voer uit az extension update --name azure-iotom ervoor te zorgen dat u de nieuwste versie van de extensie gebruikt.

Tip

De Azure CLI-opdrachten in dit artikel gebruiken het backslash \-teken voor regelvervolging, zodat de opdrachtargumenten gemakkelijker te lezen zijn. Deze syntaxis werkt in Bash-omgevingen. Als u deze opdrachten uitvoert in PowerShell, vervangt u elke backslash door een backtick of verwijdert u deze volledig.

Beschikbaarheid van updates controleren

1. Gebruik de az iot du device group list opdracht om uw apparaatgroep te identificeren.

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

2. Gebruik vervolgens az iot du device group show om de best beschikbare update voor uw groep weer te geven. De opdracht heeft de volgende argumenten:

   • --account: de accountnaam van het apparaat bijwerken.
   • --instance: de naam van het apparaatupdate-exemplaar.
   • --group-id: De id van de apparaatgroep die u wilt gebruiken voor deze implementatie. Dit is de waarde van de ADUGroup tag of $default voor apparaten zonder tag.
   • --resource-group: de resourcegroepnaam van het apparaatupdate-account.
   • --best-updates: retourneert de best beschikbare updates voor de apparaatgroep, inclusief het aantal apparaten dat elke update nodig heeft.
   • --update-compliance: retourneert nalevingsgegevens voor apparaatgroepen, zoals het aantal apparaten op de meest recente update, hoeveel nieuwe updates nodig zijn en hoeveel er momenteel een nieuwe update ontvangen.

   Voer de opdracht als volgt uit om de best beschikbare update voor uw groep te controleren:

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

De implementatie maken

Hiermee az iot du device deployment create maakt u een implementatie voor de apparaatgroep. De opdracht heeft de volgende argumenten:

• --account: de accountnaam van het apparaat bijwerken.
• --instance: de naam van het apparaatupdate-exemplaar.
• --group-id: De id van de apparaatgroep die u wilt gebruiken voor deze implementatie. Dit is de waarde van de ADUGroup tag of $default voor apparaten zonder tag.
• --deployment-id: een id om deze implementatie te identificeren.
• --update-name, --update-provideren --update-version: de parameters die het updateId object definiëren, een unieke id voor de update in deze implementatie.

Voer de opdracht als volgt uit:

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>

Optionele argumenten gebruiken

Met optionele argumenten kunt u de implementatie verder configureren. Zie Optionele parameters voor de volledige lijst met optionele argumenten.

Als u een beleid voor automatisch terugdraaien wilt maken, voegt u de volgende parameters toe:

• --failed-count: Het aantal mislukte apparaten in een implementatie waarmee een terugdraaiactie wordt geactiveerd.
• --failed-percentage: Het percentage mislukte apparaten in een implementatie waarmee een terugdraaiactie wordt geactiveerd.
• --rollback-update-name, , --rollback-update-version: --rollback-update-providerde parameters voor de update die moet worden gebruikt als er een terugdraaiactie wordt gestart.

Voer de opdracht als volgt uit:

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>

Als u de begintijd van de implementatie wilt instellen, gebruikt u de --start-time parameter om de doeldatum en -tijd voor de implementatie als volgt op te geven:

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"

Implementatiestatus bewaken

Azure-portal

1. Selecteer op het tabblad Groepen en implementaties van de pagina Updates de groep waarnaar u hebt geïmplementeerd.

2. Ga op de pagina Groepsdetails naar het tabblad Huidige implementatie of implementatiegeschiedenis om te bevestigen dat er een implementatie wordt uitgevoerd.

   

3. Selecteer Details naast een implementatie om de details van de implementatie te bekijken, details bij te werken en details van de doelapparaatklasse weer te geven. U kunt eventueel een beschrijvende naam toevoegen voor de apparaatklasse.

4. Selecteer Vernieuwen om de meest recente statusdetails weer te geven.

   

Ga naar het tabblad Basisbeginselen van de groep op de pagina Groepsdetails om te zoeken naar de status van een bepaald apparaat of filter om apparaten weer te geven waarvoor de implementatie is mislukt.

Azure-CLI

Gebruik az iot du device deployment list om alle implementaties voor een apparaatgroep weer te geven.

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

Gebruik az iot du device deployment show om de details van een bepaalde implementatie weer te geven.

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>

Voeg de --status vlag toe om informatie te retourneren over het aantal apparaten in de implementatie dat wordt uitgevoerd, voltooid of mislukt.

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

Een update-implementatie opnieuw proberen

Als uw implementatie mislukt, kunt u de implementatie voor mislukte apparaten opnieuw proberen.

Azure-portal

1. Ga naar het tabblad Huidige implementatie op het scherm Groepsdetails .

2. Selecteer Mislukte apparaten opnieuw proberen en bevestig de bevestigingsmelding.

Azure-CLI

Gebruik az iot du device deployment retry to retry a deployment for a target subgroup of devices.

Met deze opdracht wordt het --class-id argument gebruikt, dat wordt gegenereerd op basis van de model-id en compatibiliteitseigenschappen die door de agent voor apparaatupdates worden gerapporteerd.

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>

Gerelateerde inhoud

• Implementaties voor apparaatupdates
• Handleiding voor het oplossen van problemen met apparaatupdates