Importera en uppdatering till Enhetsuppdatering för IoT Hub

Lär dig hur du hämtar en ny uppdatering och importerar den till Enhetsuppdatering för IoT Hub. Om du inte redan har gjort det bör du granska viktiga importbegrepp och hur du förbereder en uppdatering som ska importeras.

Förutsättningar

• Åtkomst till en IoT Hub med Enhetsuppdatering för IoT Hub aktiverat.

• En Azure Storage-container utan privat slutpunkt aktiverad.

  • Om du inte är säker på om privat slutpunkt är aktiverat går du till Private Link Center, väljer "Privata slutpunkter" till vänster och letar sedan efter ditt Azure Storage-kontonamn i kolumnen Resurser.

• En IoT-enhet (eller simulator) som etablerats för enhetsuppdatering i IoT Hub.

• Följ stegen i Förbereda en uppdatering för import till Enhetsuppdatering för IoT Hub för att skapa importmanifestet för dina uppdateringsfiler.

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.

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å använda API:er för enhetsuppdatering för IoT Hub för att importera en uppdatering i stället.

Om du vill importera en uppdatering laddar du först upp uppdateringsfilerna och importerar manifestet till en Azure Storage-container. Sedan importerar du uppdateringen från Azure Storage till Enhetsuppdatering för IoT Hub, där den lagras så att du kan distribuera den till enheter.

Azure-portalen

1. I Azure Portal navigerar du till din IoT Hub med Enhetsuppdatering.

2. Till vänster på sidan väljer du Uppdateringar under Enhetshantering.

   

3. Välj fliken Uppdateringar i listan med flikar överst på skärmen.

   

4. Välj + Importera en ny uppdatering under rubriken Tillgängliga uppdateringar .

   

5. Välj + Välj från lagringscontainer. Användargränssnittet för lagringskonton visas. Välj ett befintligt konto eller skapa ett konto med + lagringskonto. Det här kontot används för en container för att mellanlagra dina uppdateringar för import. Kontot bör inte ha både offentliga och privata slutpunkter aktiverade samtidigt.

   

6. När du har valt ett lagringskonto visas användargränssnittet för containrar. Välj en befintlig container eller skapa en container med hjälp av + Container. Den här containern används för att mellanlagra dina uppdateringsfiler för import

   Vi rekommenderar att du använder en ny container varje gång du importerar en uppdatering. Om du alltid använder nya containrar kan du undvika att oavsiktligt importera filer från tidigare uppdateringar. Om du inte använder en ny container måste du ta bort filer från den befintliga containern innan du slutför det här steget.

   

7. I containern väljer du Ladda upp. Användargränssnittet för uppladdning visas.

   

8. Välj mappikonen till höger i avsnittet Filer under rubriken Ladda upp blob . Använd filväljaren för att navigera till platsen för dina uppdateringsfiler och importera manifestet, markera alla filer och välj sedan Öppna. Du kan hålla skiftnyckeln och klicka på för att välja flera filer.

   

9. När du har valt alla dina uppdateringsfiler väljer du Ladda upp.

   

10. Välj de uppladdade filerna för att ange vilka som ska importeras. Välj sedan knappen Välj för att återgå till sidan Importera uppdatering .

    

11. På sidan Importera uppdatering granskar du de filer som ska importeras. Välj sedan Importera uppdatering för att starta importprocessen. Information om hur du löser eventuella fel finns i Felsökning av proxyuppdatering.

    

12. Importen börjar och skärmen växlar till avsnittet Importhistorik . Välj Uppdatera för att visa förloppet tills importen har slutförts (beroende på uppdateringens storlek kan processen slutföras om några minuter men kan ta längre tid).

    

13. När kolumnen Status anger att importen har slutförts väljer du rubriken Tillgängliga uppdateringar. Du bör nu se den importerade uppdateringen i listan.

    

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 som ska mellanlagras.
• --storage-account: Namnet på lagringskontot för att mellanlagra uppdateringen.
• --storage-container: Namnet på containern i det valda lagringskontot för att mellanlagra uppdateringen.
• --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 när den har mellanlagrats.

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

Om du har flera importmanifest kan du inkludera dem alla 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, inklusive förifyllda argument.

Använd listan az iot du update för att kontrollera att uppdateringen eller 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

Om du importerar med API:er i stället

Du kan också importera en uppdatering programmatiskt genom att:

• Använda Azure SDK för .NET, Java, JavaScript eller Python
• Använda REST API för importuppdatering
• Använda PowerShell-exempelmoduler
  • Kräver PowerShell 5 eller senare (inkluderar Linux-, macOS- och Windows-installationer)

Kommentar

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

Uppdateringsfiler och importmanifest 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 Azure Storage Blob-containern kan du använda något av följande för bättre prestanda:

• AzCopy
• Azure Lagringsutforskaren

Nästa steg

• Skapa grupper
• Lär dig mer om importbegrepp