Distribuera en uppdatering med hjälp av Azure Device Update för IoT Hub

I den här artikeln får du lära dig hur du distribuerar en uppdatering till IoT-enheter med hjälp av Azure Device Update för IoT Hub i Azure Portal eller med Azure CLI.

Förutsättningar

• En standardinstans (S1) eller en högre instans av Azure IoT Hub med Enhetsuppdatering för IoT Hub aktiverad.
• En IoT-enhet eller simulator som etablerats för Enhetsuppdatering i IoT-hubben. Den etablerade enheten kan vara medlem i en användarskapad enhetsgrupp eller standardgrupp.
• En importerad uppdatering för den etablerade enheten.

Distribuera uppdateringen

I det här avsnittet beskrivs hur du distribuerar uppdateringen med hjälp av Azure Portal eller Azure CLI.

Azure-portalen

1. I Azure Portal, navigerar du till din IoT-hubb.

2. Välj Uppdateringar under Enhetshantering i det vänstra navigeringsfältet.

   

3. På sidan Uppdateringar väljer du fliken Grupper och distributioner och visar listan över uppdateringskompatibilitetsdiagram och enhetsgrupper. Du kan behöva uppdatera vyn för att se nyligen importerade uppdateringar som är tillgängliga för din enhetsgrupp.

4. Under Status i grupplistan väljer du Distribuera bredvid En eller flera nya uppdateringar är tillgängliga för den här gruppen.

   

5. Visa uppdateringskompatibilitetsdiagrammet och grupplistan. Du bör se en ny uppdatering som är tillgänglig för din taggbaserade grupp eller standardgrupp. Du kan behöva uppdatera en gång. Mer information finns i Enhetsuppdateringsefterlevnad.

6. Välj Distribuera bredvid en eller flera tillgängliga uppdateringar.

7. I listan till höger väljer du önskad uppdatering som ska distribueras.

   

8. Schemalägg distributionen så att den startar omedelbart eller i framtiden.

   Dricks

   Som standard är startdatum och tid 24 timmar från den aktuella tiden. Se till att välja ett annat datum och en annan tid om du vill att distributionen ska börja förr eller senare.

   

9. Skapa en princip för automatisk återställning om det behövs. Välj sedan Skapa.

10. På fliken Aktuella uppdateringar kan du visa status för distributionen.

    

11. I vyn Grunderna för grupp visar kompatibilitetsdiagrammet att uppdateringen nu pågår.

    När enheten har uppdaterats uppdateras efterlevnadsdiagrammet och distributionsinformationen för att återspegla den statusen.

Azure CLI

Du kan använda Bash-miljön i Azure Cloud Shell för att köra följande kommandon. Välj Starta Cloud Shell för att öppna Cloud Shell eller välj Cloud Shell-ikonen i det översta verktygsfältet i Azure Portal.

Eller, om du vill, kan du köra Azure CLI-kommandon lokalt:

1. Installera Azure CLI. Kör az version för att se den installerade Azure CLI-versionen och beroende bibliotek och kör az upgrade för att installera den senaste versionen.
2. Logga in på Azure genom att köra az login.
3. azure-iot Installera tillägget när du uppmanas att använda det första. Kontrollera att du använder den senaste versionen av tillägget genom att köra az extension update --name azure-iot.

Dricks

Azure CLI-kommandona i den här artikeln använder omvänt snedstreck \ för radfortsättning så att kommandoargumenten blir lättare att läsa. Den här syntaxen fungerar i Bash-miljöer. Om du kör dessa kommandon i PowerShell ersätter du varje omvänt snedstreck med en backtick eller tar bort dem helt.

Verifiera uppdateringstillgänglighet

1. az iot du device group list Använd kommandot för att identifiera din enhetsgrupp.

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

2. Använd az iot du device group show sedan för att visa den bästa tillgängliga uppdateringen för din grupp. Kommandot tar följande argument:

   • --account: Namnet på enhetsuppdateringskontot.
   • --instance: Namnet på enhetsuppdateringsinstansen.
   • --group-id: Det enhetsgrupps-ID som du riktar in dig på med den här distributionen, som antingen är värdet för taggen ADUGroup eller $default för enheter utan tagg.
   • --resource-group: Resursgruppnamnet för enhetsuppdateringskontot.
   • --best-updates: Returnerar de bästa tillgängliga uppdateringarna för enhetsgruppen, inklusive antalet enheter som behöver varje uppdatering.
   • --update-compliance: Returnerar efterlevnadsinformation för enhetsgrupper, till exempel hur många enheter som har den senaste uppdateringen, hur många som behöver nya uppdateringar och hur många som för närvarande får en ny uppdatering.

   Kontrollera den bästa tillgängliga uppdateringen för din grupp genom att köra kommandot på följande sätt:

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

Skapa distributionen

Använd az iot du device deployment create för att skapa en distribution för enhetsgruppen. Kommandot tar följande argument:

• --account: Namnet på enhetsuppdateringskontot.
• --instance: Namnet på enhetsuppdateringsinstansen.
• --group-id: Det enhetsgrupps-ID som du riktar in dig på med den här distributionen, som antingen är värdet för taggen ADUGroup eller $default för enheter utan tagg.
• --deployment-id: Ett ID för att identifiera den här distributionen.
• --update-name, --update-provider, och --update-version: Parametrarna som definierar updateId objektet, en unik identifierare för uppdateringen i den här distributionen.

Kör kommandot på följande sätt:

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>

Använda valfria argument

Med valfria argument kan du konfigurera distributionen ytterligare. En fullständig lista över valfria argument finns i Valfria parametrar.

Om du vill skapa en princip för automatisk återställning lägger du till följande parametrar:

• --failed-count: Antalet misslyckade enheter i en distribution som utlöser en återställning.
• --failed-percentage: Procentandelen misslyckade enheter i en distribution som utlöser en återställning.
• --rollback-update-name, --rollback-update-provider, --rollback-update-version: Parametrarna för uppdateringen som ska användas om en återställning initieras.

Kör kommandot på följande sätt:

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>

Om du vill ange distributionens starttid använder du parametern --start-time för att ange måldatum och tid för distributionen enligt följande:

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"

Övervaka distributionsstatus

Azure-portalen

1. På fliken Grupper och distributioner på sidan Uppdateringar väljer du den grupp som du distribuerade till.

2. På sidan Gruppinformation går du till fliken Aktuell distributions - eller distributionshistorik för att bekräfta att en distribution pågår.

   

3. Välj Information bredvid en distribution för att visa distributionsinformation, uppdateringsinformation och information om enhetsklassens mål. Du kan också lägga till ett eget namn för enhetsklassen.

4. Välj Uppdatera för att visa den senaste statusinformationen.

   

Gå till fliken Grundläggande grupp på sidan Gruppinformation för att söka efter status för en viss enhet eller filtrera för att visa enheter som misslyckades med distributionen.

Azure CLI

Använd az iot du device deployment list för att visa alla distributioner för en enhetsgrupp.

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

Använd az iot du device deployment show för att visa information om en viss distribution.

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 Lägg till flaggan för att returnera information om hur många enheter i distributionen som pågår, slutförs eller misslyckas.

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

Försök igen med en uppdateringsdistribution

Om distributionen misslyckas kan du försöka distribuera om för misslyckade enheter.

Azure-portalen

1. Gå till fliken Aktuell distribution på skärmen Gruppinformation .

2. Välj Försök igen misslyckade enheter och bekräfta bekräftelsemeddelandet.

Azure CLI

Använd az iot du device deployment retry to retry a deployment for a target subgroup of devices (Använd az iot du device deployment retry to retry a deployment for a target subgroup of devices).

Det här kommandot tar --class-id argumentet, som genereras från modell-ID:t och kompatibilitetsegenskaperna som rapporteras av enhetsuppdateringsagenten.

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>

Relaterat innehåll

• Distributioner av enhetsuppdatering
• Felsökningsguide för enhetsuppdatering