Een update importeren in Azure Device Update voor IoT Hub

Als u een update wilt implementeren op apparaten met behulp van Azure Device Update voor IoT Hub, importeert u eerst de updatebestanden in de Device Update-service, waarin de geïmporteerde update voor implementatie op apparaten wordt opgeslagen. In dit artikel leert u hoe u een update importeert in de Device Update-service met behulp van Azure Portal, Azure CLI of Device Update-API's.

Vereisten

• Een Apparaatupdate-account en -exemplaar dat is geconfigureerd met een IoT-hub.

• Een IoT-apparaat of -simulator die is ingericht voor Device Update binnen de IoT-hub.

• Werk bestanden voor uw apparaat bij en een gekoppeld importmanifestbestand dat is gemaakt door de instructies in Een update voorbereiden om te importeren in Device Update.

• Een Azure Storage-account en -container voor het opslaan van de geïmporteerde bestanden. U kunt ook een nieuw opslagaccount en een nieuwe container maken als onderdeel van het importproces op basis van Azure Portal.

  Belangrijk

  Zorg ervoor dat het opslagaccount dat u gebruikt of maakt, geen privé-eindpunten heeft ingeschakeld. Als u wilt zien of privé-eindpunten zijn ingeschakeld, kunt u controleren op de naam van uw Azure Storage-account onder Privé-eindpunten in het Private Link Center.

Azure-portal

• Ondersteunde browsers Microsoft Edge of Google Chrome.

Azure-CLI

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

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 een update importeren met behulp van de Device Update-API's .

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

Azure-portal

1. Selecteer in Azure Portal op de ioT-hubpagina voor uw device update-exemplaar apparaatbeheerupdates> in het linkernavigatievenster.

   

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

   

3. Selecteer Selecteren in opslagcontainer op de pagina Update importeren.

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 te fasen.

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 voor importeren te fasen.

   

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

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 gefaseerde.
• --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

Importeren met behulp van de Device Update-API's

U kunt een update ook programmatisch importeren met behulp van een van de volgende methoden:

• De API's voor apparaatupdates in de Azure SDK's voor .NET, Java, JavaScript of Python
• De REST API voor update importeren van apparaatupdates
• PowerShell-voorbeeldmodules (hiervoor is PowerShell 5 of hoger vereist voor Linux, macOS of Windows)

Notitie

Zie Gebruikersrollen en toegang van Device Update voor de vereiste API-machtiging.

De updatebestanden en het 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 methoden gebruiken voor betere prestaties:

• AzCopy
• Azure-opslagverkenner

Gerelateerde inhoud

• Apparaatgroepen
• Importmanifest voor apparaatupdates