Een update importeren in Azure Device Update voor IoT Hub

• Ondersteunde browsers Microsoft Edge of Google Chrome.

• Een Bash-omgeving.

  U kunt de Bash-omgeving in Azure Cloud Shell gebruiken om de opdrachten in dit artikel uit te voeren. Selecteer Cloud Shell starten om Cloud Shell te openen of selecteer het Cloud Shell-pictogram op de bovenste werkbalk van Azure Portal.

  

  Als u wilt, kunt u de Azure CLI-opdrachten ook lokaal uitvoeren:

  1. Installeer Azure CLI. Voer az version uit om de geïnstalleerde Azure CLI-versie en afhankelijke bibliotheken te bekijken en voer az upgrade uit om de nieuwste versie te installeren.
  2. Meld u aan bij Azure door az login uit te voeren.
  3. Installeer de azure-iot extensie wanneer u hierom wordt gevraagd voor het eerste gebruik. Voer uit az extension update --name azure-iotom ervoor te zorgen dat u de nieuwste versie van de extensie gebruikt.

1. Selecteer in de Azure-portal op de IoT-hubpagina voor uw Device Update-exemplaar in de linkernavigatie >Updates.

   

2. Selecteer Een nieuwe update importeren op de pagina Updates.

   

3. Selecteer op de pagina Importupdate de optie Selecteren vanuit opslagcontainer.

4. Selecteer op de pagina Opslagaccounts een bestaand opslagaccount of maak een nieuw account door Opslagaccount te selecteren. U gebruikt het opslagaccount voor een container om de updatebestanden tijdelijk op te slaan.

5. Selecteer op de pagina Containers een bestaande container of maak een nieuwe container door Container te selecteren. U gebruikt de container om de updatebestanden gereed te zetten voor import.

   

   Tip

   Telkens wanneer u een update importeert, kunt u voorkomen dat bestanden uit eerdere updates per ongeluk worden geïmporteerd met behulp van een nieuwe container. Als u geen nieuwe container gebruikt, moet u eventuele eerdere bestanden uit de bestaande container verwijderen.

6. Selecteer Uploaden op de containerpagina.

   

7. Selecteer in het scherm Blob uploaden het mappictogram naast Bestanden. Gebruik de bestandskiezer om naar de locatie van uw update- en importmanifestbestanden te navigeren, de bestanden te selecteren en vervolgens Openen te selecteren. U kunt shift gebruiken om bestanden met meerdere selecties te selecteren.

   

8. Nadat u alle bestanden hebt geselecteerd, selecteert u Uploaden.

   

9. Nadat ze zijn geüpload, worden de bestanden weergegeven op de containerpagina. Controleer en selecteer de bestanden die u wilt importeren op de containerpagina en selecteer vervolgens Selecteren.

   

10. Selecteer Update importeren in het scherm Update importeren.

    

Het importproces wordt gestart en het scherm schakelt over naar het scherm Updates . Nadat het importeren is voltooid, wordt deze weergegeven op het tabblad Updates . Zie Problemen met proxy-updates oplossen om eventuele fouten op te lossen.

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 voor Device Update.
• --instance: de naam van het apparaatupdate-exemplaar.
• --manifest-path: Het bestandspad van het importmanifest dat moet worden klaargezet.
• --storage-account: de naam van het opslagaccount om de update in te faseereren.
• --storage-container: De naam van de container in het geselecteerde opslagaccount om de update in 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 naar Device Update moet worden geïmporteerd 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

U kunt meerdere importmanifesten 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 met vooraf ingevulde argumenten.

Gebruik az iot du update list om te controleren of uw 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