Importera en uppdatering till Azure Device Update för IoT Hub

Om du vill distribuera en uppdatering till enheter med Azure Device Update för IoT Hub importerar du först uppdateringsfilerna till enhetsuppdateringstjänsten, som lagrar den importerade uppdateringen för distribution till enheter. I den här artikeln får du lära dig hur du importerar en uppdatering till enhetsuppdateringstjänsten med hjälp av API:erna Azure Portal, Azure CLI eller Device Update.

Förutsättningar

• Ett enhetsuppdateringskonto och en instans som konfigurerats med en IoT-hubb.

• En IoT-enhet eller simulator som etablerats för Enhetsuppdatering i IoT-hubben.

• Uppdatera filer för enheten och en associerad importmanifestfil som skapats genom att följa anvisningarna i Förbereda en uppdatering för import till Enhetsuppdatering.

• Ett Azure Storage-konto och en container för att lagra de importerade filerna. Eller så kan du skapa ett nytt lagringskonto och en ny container som en del av den Azure Portal baserade importprocessen.

  Viktigt!

  Kontrollera att lagringskontot som du använder eller skapar inte har privata slutpunkter aktiverade. Om du vill se om privata slutpunkter är aktiverade kan du söka efter ditt Azure Storage-kontonamn under Privata slutpunkter i Private Link Center.

Azure-portalen

• Webbläsare som stöds Microsoft Edge eller Google Chrome.

Azure CLI

• En Bash-miljö.

  Du kan använda Bash-miljön i Azure Cloud Shell för att köra kommandona i den här artikeln. 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.

Importera en uppdatering

Det här avsnittet visar hur du importerar en uppdatering med hjälp av antingen Azure Portal eller Azure CLI. Du kan också importera en uppdatering med hjälp av API:erna för enhetsuppdatering i stället.

Om du vill importera en uppdatering laddar du först upp uppdateringen och importerar manifestfilerna till en Azure Storage-container. Sedan importerar du uppdateringen från Azure Storage till Enhetsuppdatering för IoT Hub, som lagrar den för distribution till enheter.

Azure-portalen

1. I Azure Portal går du till IoT Hub-sidan för enhetsuppdateringsinstansen och väljer Enhetshanteringsuppdateringar> i det vänstra navigeringsfältet.

   

2. På sidan Uppdateringar väljer du Importera en ny uppdatering.

   

3. På sidan Importera uppdatering väljer du Välj från lagringscontainer.

4. På sidan Lagringskonton väljer du ett befintligt lagringskonto eller skapar ett nytt konto genom att välja Lagringskonto. Du använder lagringskontot för en container för att mellanlagra uppdateringsfilerna.

5. På sidan Containrar väljer du en befintlig container eller skapar en ny container genom att välja Container. Du använder containern för att mellanlagra uppdateringsfilerna för import.

   

   Dricks

   Om du använder en ny container varje gång du importerar en uppdatering kan du förhindra att filer importeras av misstag från tidigare uppdateringar. Om du inte använder en ny container måste du ta bort alla tidigare filer från den befintliga containern.

6. På containersidan väljer du Ladda upp.

   

7. På skärmen Ladda upp blob väljer du mappikonen bredvid Filer. Använd filväljaren för att navigera till platsen för dina uppdaterings- och importmanifestfiler, välj filerna och välj sedan Öppna. Du kan använda Skift-nyckeln för att välja flera filer.

   

8. När du har valt alla filer väljer du Ladda upp.

   

9. När de har laddats upp visas filerna på containersidan. På containersidan granskar och väljer du de filer som ska importeras och väljer sedan Välj.

   

10. På skärmen Importera uppdatering väljer du Importera uppdatering.

    

Importen börjar och skärmen växlar till skärmen Uppdateringar . När importen har slutförts visas den på fliken Uppdateringar . Information om hur du löser eventuella fel finns i Felsökning av proxyuppdatering.

Azure CLI

Kommandot az iot du update stage hanterar de nödvändiga stegen för att importera en uppdatering, inklusive att ladda upp uppdateringsfilerna till en mållagringscontainer. Med en valfri flagga kan även det här kommandot automatiskt importera filerna när de har förberetts. Annars slutför kommandot az iot du update import processen.

Kommandot stage tar följande argument:

• --account: Namnet på enhetsuppdateringskontot.
• --instance: Namnet på enhetsuppdateringsinstansen.
• --manifest-path: Filsökvägen till importmanifestet till fas.
• --storage-account: Namnet på lagringskontot som uppdateringen ska mellanlagras till.
• --storage-container: Namnet på containern i det valda lagringskontot som uppdateringen ska mellanlagras till.
• --overwrite: Valfri flagga som anger om du vill skriva över befintliga blobar i lagringscontainern om det finns en konflikt.
• --then-import: Valfri flagga som anger om uppdateringen ska importeras till Enhetsuppdatering efter mellanlagring.

az iot du update stage \
    --account <Replace with your Device Update account name> \
    --instance <Replace with your Device Update instance name> \
    --manifest-path <Replace with the full path to your import manifest> \
    --storage-account <Replace with your Storage account name> \
    --storage-container <Replace with your container name> \
    --overwrite --then-import

Till exempel:

az iot du update stage \
    --account deviceUpdate001 \
    --instance myInstance \
    --manifest-path /my/apt/manifest/file.importmanifest.json \
    --storage-account deviceUpdateStorage \
    --storage-container deviceUpdateDemo \
    --overwrite --then-import

Du kan inkludera flera importmanifest i ett enda kommando. Till exempel:

az iot du update stage \
    --account deviceUpdate001 \
    --instance myInstance \
    --manifest-path /my/apt/manifest/parent.importmanifest.json \
    --manifest-path /my/apt/manifest/child1.importmanifest.json \
    --manifest-path /my/apt/manifest/child2.importmanifest.json \
    --storage-account deviceUpdateStorage \
    --storage-container deviceUpdateDemo \
    --overwrite --then-import

Om du inte använder --then-import flaggan innehåller kommandots stage utdata en uppmaning om att köra az iot du update import med förifyllda argument.

Använd listan az iot du update för att kontrollera att uppdateringarna har importerats.

az iot du update list \
    --account <Replace with your Device Update account name> \
    --instance <Replace with your Device Update instance name> \
    -o table

Importera med api:er för enhetsuppdatering

Du kan också importera en uppdatering programmatiskt med någon av följande metoder:

• API:er för enhetsuppdatering i Azure SDK:er för .NET, Java, JavaScript eller Python
• Rest-API:et för importuppdatering för enhetsuppdatering
• PowerShell-exempelmoduler (kräver PowerShell 5 eller senare för Linux, macOS eller Windows)

Kommentar

Se Användarroller och åtkomst för enhetsuppdatering för nödvändig API-behörighet.

Uppdateringsfilerna och importmanifestet måste laddas upp till en Azure Storage Blob-container för mellanlagring. Om du vill importera mellanlagrade filer anger du blob-URL:en eller signaturen för delad åtkomst (SAS) för privata blobar till API:et för enhetsuppdatering. Om du använder en SAS måste du ange ett förfallofönster på tre timmar eller mer.

Dricks

Om du vill ladda upp stora uppdateringsfiler till en Azure Storage Blob-container kan du använda någon av följande metoder för bättre prestanda:

• AzCopy
• Azure Lagringsutforskaren

Relaterat innehåll

• Enhetsgrupper
• Importmanifest för enhetsuppdatering