Een update importeren in Device Update voor IoT Hub

Meer informatie over het verkrijgen van een nieuwe update en het importeren in Device Update voor IoT Hub. Als u dat nog niet hebt gedaan, controleert u de belangrijkste importconcepten en hoe u een update voorbereidt die moet worden geïmporteerd.

Vereisten

• Toegang tot een IoT Hub waarvoor Apparaatupdate voor IoT Hub is ingeschakeld.

• Een Azure Storage-container zonder privé-eindpunt ingeschakeld.

  • Als u niet zeker weet of Privé-eindpunt is ingeschakeld, gaat u naar Private Link Center, selecteert u 'Privé-eindpunten' aan de linkerkant en zoekt u de naam van uw Azure Storage-account in de kolom Resources.

• Een IoT-apparaat (of simulator) dat is ingericht voor Apparaatupdate in IoT Hub.

• Volg de stappen in Een update voorbereiden om te importeren in Device Update for IoT Hub om het importmanifest voor uw updatebestanden te maken.

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.

Een update importeren

In deze sectie ziet u hoe u een update importeert met behulp van Azure Portal of de Azure CLI. U kunt ook de Device Update voor IoT Hub-API's gebruiken om in plaats daarvan een update te importeren.

Als u een update wilt importeren, uploadt u eerst de updatebestanden en importeert u het manifest in een Azure Storage-container. Vervolgens importeert u de update uit Azure Storage in Device Update voor IoT Hub, waar deze wordt opgeslagen voor implementatie op apparaten.

Azure-portal

1. Navigeer in Azure Portal naar uw IoT Hub met Device Update.

2. Selecteer Aan de linkerkant van de pagina Updates onder Apparaatbeheer.

   

3. Selecteer het tabblad Updates in de lijst met tabbladen boven aan het scherm.

   

4. Selecteer + Importeer een nieuwe update onder de header Beschikbare updates .

   

5. Selecteer + Selecteren in opslagcontainer. De gebruikersinterface van opslagaccounts wordt weergegeven. Selecteer een bestaand account of maak een account met + Storage-account. Dit account wordt gebruikt voor een container om uw updates voor importeren te fasen. Voor het account mogen niet tegelijkertijd openbare en privé-eindpunten zijn ingeschakeld.

   

6. Zodra u een opslagaccount hebt geselecteerd, wordt de gebruikersinterface van containers weergegeven. Selecteer een bestaande container of maak een container met behulp van + Container. Deze container wordt gebruikt voor het faseren van uw updatebestanden voor het importeren

   U wordt aangeraden telkens wanneer u een update importeert een nieuwe container te gebruiken. Als u altijd nieuwe containers gebruikt, kunt u voorkomen dat u per ongeluk bestanden uit eerdere updates importeert. Als u geen nieuwe container gebruikt, moet u alle bestanden uit de bestaande container verwijderen voordat u deze stap voltooit.

   

7. Selecteer Uploaden in uw container. De gebruikersinterface voor uploaden wordt weergegeven.

   

8. Selecteer het mappictogram aan de rechterkant van de sectie Bestanden onder de kop Blob uploaden. Gebruik de bestandskiezer om naar de locatie van uw updatebestanden te navigeren en het manifest te importeren, alle bestanden te selecteren en vervolgens Openen te selecteren. U kunt Shift ingedrukt houden en klikken om bestanden met meerdere selecties te selecteren.

   

9. Wanneer u al uw updatebestanden hebt geselecteerd, selecteert u Uploaden.

   

10. Selecteer de geüploade bestanden om ze aan te wijzen die moeten worden geïmporteerd. Selecteer vervolgens de knop Selecteren om terug te keren naar de pagina Update importeren .

    

11. Controleer op de pagina Update importeren de bestanden die moeten worden geïmporteerd. Selecteer vervolgens Update importeren om het importproces te starten. Zie Problemen met proxy-updates oplossen om eventuele fouten op te lossen.

    

12. Het importproces wordt gestart en het scherm schakelt over naar de sectie Geschiedenis importeren. Selecteer Vernieuwen om de voortgang weer te geven totdat het importproces is voltooid (afhankelijk van de grootte van de update, kan het proces binnen een paar minuten worden voltooid, maar kan het langer duren).

    

13. Wanneer de kolom Status aangeeft dat het importeren is voltooid, selecteert u de kop Beschikbare updates . U ziet nu de geïmporteerde update in de lijst.

    

Azure-CLI

De opdracht az iot du update stage verwerkt de vereiste stappen voor het importeren van een update, inclusief het uploaden van de updatebestanden naar een doelopslagcontainer. Met een optionele vlag kunnen met deze opdracht ook automatisch de bestanden worden geïmporteerd nadat ze zijn voorbereid. Anders wordt het proces voltooid met de opdracht az iot du update import .

De stage opdracht heeft de volgende argumenten:

• --account: de accountnaam van het apparaat bijwerken.
• --instance: de naam van het apparaatupdate-exemplaar.
• --manifest-path: het bestandspad naar het importmanifest dat moet worden gefaseerd.
• --storage-account: de naam van het opslagaccount om de update te faseereren.
• --storage-container: De naam van de container in het geselecteerde opslagaccount om de update te faseereren.
• --overwrite: Optionele vlag die aangeeft of bestaande blobs in de opslagcontainer moeten worden overschreven als er een conflict is.
• --then-import: Optionele vlag die aangeeft of de update moet worden geïmporteerd in Device Update nadat deze is gefaseerd.

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

Voorbeeld:

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

Als u meerdere importmanifesten hebt, kunt u ze allemaal opnemen in één opdracht. Voorbeeld:

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

Als u de --then-import vlag niet gebruikt, bevat de uitvoer van de stage opdracht een prompt om az iot du update import uit te voeren, inclusief vooraf ingevulde argumenten.

Gebruik az iot du update list om te controleren of uw update of updates zijn geïmporteerd.

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

Als u in plaats daarvan importeert met behulp van API's

U kunt een update ook programmatisch importeren door:

• Gebruiken Azure SDK voor .NET, Java, JavaScript of Python
• Rest API voor importeren gebruiken
• PowerShell-voorbeeldmodules gebruiken
  • Hiervoor is PowerShell 5 of hoger vereist (inclusief Linux-, macOS- en Windows-installaties)

Notitie

Raadpleeg gebruikersrollen en -toegang voor apparaatupdates voor de vereiste API-machtiging.

Updatebestanden en importmanifest moeten worden geüpload naar een Azure Storage Blob-container voor fasering. Als u de gefaseerde bestanden wilt importeren, geeft u de blob-URL of SAS (Shared Access Signature) voor privé-blobs op in de Api voor apparaatupdates. Als u een SAS gebruikt, moet u een verloopvenster van drie uur of meer opgeven

Tip

Als u grote updatebestanden wilt uploaden naar een Azure Storage Blob-container, kunt u een van de volgende opties gebruiken voor betere prestaties:

• AzCopy
• Azure-opslagverkenner

Volgende stappen

• Groepen maken
• Meer informatie over importconcepten