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

Lär dig hur du distribuerar en uppdatering till en IoT-enhet med hjälp av Enhetsuppdatering för Azure IoT Hub.

Förutsättningar

• Åtkomst till en IoT Hub med Enhetsuppdatering för IoT Hub aktiverat. Vi rekommenderar att du använder en S1-nivå (Standard) eller högre för din IoT Hub.
• En importerad uppdatering för den etablerade enheten.
• En IoT-enhet (eller simulator) som etablerats för enhetsuppdatering i IoT Hub.
• Enheten ingår i minst en standardgrupp eller användarskapad uppdateringsgrupp.

Azure-portalen

Webbläsare som stöds:

• Microsoft Edge
• Google Chrome

Azure CLI

En Azure CLI-miljö:

• Använd Bash-miljön i Azure Cloud Shell.

  

• Eller om du föredrar att köra CLI-referenskommandon lokalt installerar du Azure CLI

  1. Logga in på Azure CLI med kommandot az login .
  2. Kör az version om du vill hitta versionen och de beroende bibliotek som är installerade. Om du vill uppgradera till den senaste versionen kör du az upgrade.
  3. När du uppmanas till det installerar du Azure CLI-tillägg vid första användningen. Kommandona i den här artikeln använder azure-iot-tillägget . Kör az extension update --name azure-iot för att se till att du använder den senaste versionen av tillägget.

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.

Distribuera uppdateringen

Azure-portalen

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

2. Välj Uppdateringar på navigeringsmenyn för att öppna sidan Enhetsuppdatering för din IoT Hub-instans.

   

3. Välj fliken Grupper och distributioner överst på sidan. Mer information finns i Enhetsgrupper.

   

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

5. Välj Distribuera bredvid en eller flera tillgängliga uppdateringar och bekräfta att den beskrivande etikett som du lade till när du importerade finns och ser korrekt ut.

6. Bekräfta att rätt grupp har valts som målgrupp och välj Distribuera.

7. Starta distributionen genom att gå till fliken Aktuell distribution . Välj länken Distribuera bredvid önskad uppdatering i avsnittet Tillgängliga uppdateringar . Den bästa tillgängliga uppdateringen för en viss grupp anges med en bästa markering.

   

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

   Dricks

   Som standard är startdatum och tid inställt på Omedelbart. Se till att välja ett annat datum och en annan tid om du vill att distributionen ska börja senare.

   

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

10. I distributionsinformationen övergår Status till Aktiv. Den distribuerade uppdateringen är markerad med (distribution).

    

11. Visa efterlevnadsdiagrammet för att se att uppdateringen pågår.

    

12. När enheten har uppdaterats ser du att efterlevnadsdiagrammet och distributionsinformationen har uppdaterats för att återspegla samma sak.

    

Azure CLI

För az iot du device group list att verifiera 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. Det här ID:t är värdet för taggen ADUGroup eller $default för enheter utan tagg.
• --best-updates: Den här flaggan anger att kommandot ska hämta de bästa tillgängliga uppdateringarna för enhetsgruppen, inklusive antalet enheter som behöver varje uppdatering.
• '--resource-group -g': Resursgruppsnamn för enhetsuppdateringskonto.
• "--update-compliance": Den här flaggan anger att kommandot ska hämta information om enhetsgruppens uppdateringsefterlevnad, till exempel hur många enheter som har den senaste uppdateringen, hur många som behöver nya uppdateringar och hur många som pågår för att ta emot en ny uppdatering.

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

Använd az iot du device deployment create för att skapa en distribution för en enhetsgrupp.

Kommandot device deployment create 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. Det här ID:t ä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: Dessa tre parametrar definierar updateId-objektet som är en unik identifierare för den uppdatering som du använder i den här distributionen.

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>

Med valfria argument kan du konfigurera distributionen. Den fullständiga listan 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: UpdateID för uppdateringen som enhetsgruppen använder om en återställning initieras.

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 att distributionen ska starta i framtiden använder du parametern --start-time för att ange måldatumtiden för distributionen.

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 en uppdateringsdistribution

Azure-portalen

1. Välj den grupp som du distribuerade till och gå till fliken Aktuella uppdateringar eller Distributionshistorik för att bekräfta att distributionen pågår

   

2. Välj Information bredvid den distribution som du skapade. Här kan du visa distributionsinformation, uppdateringsinformation och information om målenhetsklassen. Du kan också lägga till ett eget namn för enhetsklassen.

   

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

4. Du kan gå till grundvyn grupp för att söka efter status för en viss enhet eller filtrera för att visa enheter som har misslyckats med distributionen

Azure CLI

Använd az iot du device deployment list för att visa all distribution 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 av någon anledning kan du försöka distribuera igen 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>

Nästa steg

Felsök vanliga problem