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

Meer informatie over het implementeren van een update naar een IoT-apparaat met behulp van Device Update voor Azure IoT Hub.

Vereisten

• Toegang tot een IoT Hub waarvoor Apparaatupdate voor IoT Hub is ingeschakeld. U wordt aangeraden een S1-laag (Standard) of hoger te gebruiken voor uw IoT Hub.
• Een geïmporteerde update voor het ingerichte apparaat.
• Een IoT-apparaat (of simulator) dat is ingericht voor Apparaatupdate in IoT Hub.
• Het apparaat maakt deel uit van ten minste één standaardgroep of door de gebruiker gemaakte updategroep.

Azure-portal

Ondersteunde browsers:

• Microsoft Edge
• Google Chrome

Azure-CLI

Een Azure CLI-omgeving:

• Gebruik de Bash-omgeving in Azure Cloud Shell.

  

• Als u liever CLI-referentieopdrachten lokaal uitvoert, installeert u de Azure CLI

  1. Meld u aan bij de Azure CLI met behulp van de opdracht az login .
  2. Voer az version uit om de geïnstalleerde versie en afhankelijke bibliotheken te vinden. Voer az upgrade uit om te upgraden naar de nieuwste versie.
  3. Installeer bij het eerste gebruik de Azure CLI-extensie wanneer hierom wordt gevraagd. De opdrachten in dit artikel gebruiken de azure-iot-extensie . Voer deze opdracht uit az extension update --name azure-iot om 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.

De update implementeren

Azure-portal

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

2. Selecteer Updates in het navigatiemenu om de pagina Apparaatupdate van uw IoT Hub-exemplaar te openen.

   

3. Selecteer het tabblad Groepen en implementaties boven aan de pagina. Zie Apparaatgroepen voor meer informatie.

   

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

5. Selecteer Implementeren naast een of meer beschikbare updates en controleer of het beschrijvende label dat u hebt toegevoegd bij het importeren aanwezig is en er correct uitziet.

6. Controleer of de juiste groep is geselecteerd als de doelgroep en selecteer Implementeren.

7. Als u de implementatie wilt starten, gaat u naar het tabblad Huidige implementatie . Selecteer de koppeling Implementeren naast de gewenste update in de sectie Beschikbare updates . De best beschikbare update voor een bepaalde groep wordt aangeduid met een beste markering.

   

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

   Tip

   Standaard is de begindatum en -tijd ingesteld op Onmiddellijk. Zorg ervoor dat u een andere datum en tijd selecteert als u wilt dat de implementatie later begint.

   

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

10. In de details van de implementatie wordt de status geactiveerd. De geïmplementeerde update is gemarkeerd met (implementeren).

    

11. Bekijk het nalevingsdiagram om te zien dat de update nu wordt uitgevoerd.

    

12. Nadat uw apparaat is bijgewerkt, ziet u dat uw nalevingsgrafiek en implementatiegegevens zijn bijgewerkt om hetzelfde weer te geven.

    

Azure-CLI

De az iot du device group list optie om de best beschikbare update voor uw groep te controleren. De opdracht heeft de volgende argumenten:

• --account: de accountnaam van het apparaat bijwerken.
• --instance: de naam van het apparaatupdate-exemplaar.
• --group-id: De apparaatgroep-id die u wilt gebruiken voor deze implementatie. Deze id is de waarde van de ADUGroup-tag of $default voor apparaten zonder tag.
• --best-updates: Deze vlag geeft aan dat de opdracht de beste beschikbare updates moet ophalen voor de apparaatgroep, inclusief het aantal apparaten dat elke update nodig heeft.
• '--resource-group -g': naam van resourcegroep voor apparaatupdateaccount.
• '--update-compliance': met deze vlag wordt aangegeven dat de opdracht nalevingsgegevens voor apparaatgroepen moet ophalen, zoals het aantal apparaten op de meest recente update, hoeveel nieuwe updates nodig zijn en hoeveel er worden uitgevoerd bij het ontvangen van een nieuwe update.

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

Gebruik az iot du device deployment create om een implementatie voor een apparaatgroep te maken.

De device deployment create opdracht heeft de volgende argumenten:

• --account: de accountnaam van het apparaat bijwerken.
• --instance: de naam van het apparaatupdate-exemplaar.
• --group-id: De apparaatgroep-id die u wilt gebruiken voor deze implementatie. Deze id 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: Deze drie parameters definiëren het updateId-object dat een unieke id is voor de update die u in deze implementatie gebruikt.

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>

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

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

• --failed-count: Het aantal mislukte apparaten in een implementatie dat een terugdraaiactie activeert.
• --failed-percentage: Het percentage mislukte apparaten in een implementatie dat een terugdraaiactie activeert.
• --rollback-update-name, , : --rollback-update-provider--rollback-update-versionDe updateID voor de update die door de apparaatgroep wordt gebruikt als er een terugdraaiactie wordt gestart.

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 wilt dat de implementatie in de toekomst begint, gebruikt u de --start-time parameter om de doeldatum/-tijd voor de implementatie 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"

Een update-implementatie bewaken

Azure-portal

1. Selecteer de groep waarnaar u hebt geïmplementeerd en ga naar het tabblad Huidige updates of implementatiegeschiedenis om te bevestigen dat de implementatie wordt uitgevoerd

   

2. Selecteer Details naast de implementatie die u hebt gemaakt. Hier kunt u de details van de implementatie bekijken, details bijwerken en details van de doelapparaatklasse bekijken. U kunt eventueel een beschrijvende naam toevoegen voor de apparaatklasse.

   

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

4. U kunt naar de basisweergave van de groep gaan om de status van een bepaald apparaat te doorzoeken of filteren 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 om een of andere reden mislukt, kunt u de implementatie opnieuw uitvoeren voor mislukte apparaten.

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>

Volgende stappen

Algemene problemen oplossen