Importare un aggiornamento in Aggiornamento dispositivi di Azure per hub IoT

Per distribuire un aggiornamento ai dispositivi usando Aggiornamento dispositivi di Azure per hub IoT, importare prima i file di aggiornamento nel servizio Aggiornamento dispositivi, che archivia l'aggiornamento importato per la distribuzione nei dispositivi. Questo articolo illustra come importare un aggiornamento nel servizio Aggiornamento dispositivi usando le API portale di Azure, interfaccia della riga di comando di Azure o Aggiornamento dispositivi.

Prerequisiti

• Un account e un'istanza di Aggiornamento dispositivi configurati con un hub IoT.

• Un dispositivo O un simulatore IoT di cui è stato effettuato il provisioning per l'aggiornamento del dispositivo all'interno dell'hub IoT.

• Aggiornare i file per il dispositivo e un file manifesto di importazione associato creato seguendo le istruzioni riportate in Preparare un aggiornamento da importare in Aggiornamento dispositivi.

• Un account e un contenitore Archiviazione di Azure per contenere i file importati. In alternativa, è possibile creare un nuovo account di archiviazione e un nuovo contenitore come parte del processo di importazione basato su portale di Azure.

  Importante

  Assicurarsi che l'account di archiviazione usato o creato non abbia endpoint privati abilitati. Per verificare se gli endpoint privati sono abilitati, è possibile verificare la presenza del nome dell'account Archiviazione di Azure in Endpoint privati nel Centro collegamento privato.

Azure portal

• Browser supportati Microsoft Edge o Google Chrome.

Interfaccia della riga di comando di Azure

• Ambiente Bash.

  È possibile usare l'ambiente Bash in Azure Cloud Shell per eseguire i comandi in questo articolo. Selezionare Avvia Cloud Shell per aprire Cloud Shell oppure selezionare l'icona Cloud Shell nella barra degli strumenti superiore del portale di Azure.

  

  In alternativa, se si preferisce, è possibile eseguire i comandi dell'interfaccia della riga di comando di Azure in locale:

  1. Installare l'interfaccia da riga di comando di Azure. Eseguire az version per visualizzare la versione dell'interfaccia della riga di comando di Azure installata e le librerie dipendenti ed eseguire az upgrade per installare la versione più recente.
  2. Accedere ad Azure eseguendo az login.
  3. Installare l'estensione azure-iot quando richiesto al primo utilizzo. Per assicurarsi di usare la versione più recente dell'estensione, eseguire az extension update --name azure-iot.

Suggerimento

I comandi dell'interfaccia della riga di comando di Azure in questo articolo usano il carattere barra rovesciata \ per la continuazione della riga in modo che gli argomenti del comando siano più facili da leggere. Questa sintassi funziona negli ambienti Bash. Se si eseguono questi comandi in PowerShell, sostituire ogni barra rovesciata con un backtick 'o rimuoverli completamente.

Importare un aggiornamento

Questa sezione illustra come importare un aggiornamento usando il portale di Azure o l'interfaccia della riga di comando di Azure. È anche possibile importare un aggiornamento usando le API aggiornamento dispositivi.

Per importare un aggiornamento, caricare prima di tutto i file manifesto di aggiornamento e importazione in un contenitore Archiviazione di Azure. Importare quindi l'aggiornamento da Archiviazione di Azure in Aggiornamento dispositivi per hub IoT, che lo archivia per la distribuzione nei dispositivi.

Azure portal

1. Nella pagina dell'hub IoT dell'istanza di Aggiornamento dispositivi della portale di Azure selezionare Aggiornamenti di gestione>dei dispositivi nel riquadro di spostamento a sinistra.

   

2. Nella pagina Aggiornamenti selezionare Importa un nuovo aggiornamento.

   

3. Nella pagina Importa aggiornamento selezionare Seleziona dal contenitore di archiviazione.

4. Nella pagina Account di archiviazione selezionare un account di archiviazione esistente o crearne uno nuovo selezionando Account di archiviazione. Usare l'account di archiviazione per un contenitore per preparare i file di aggiornamento.

5. Nella pagina Contenitori selezionare un contenitore esistente o creare un nuovo contenitore selezionando Contenitore. Usare il contenitore per preparare i file di aggiornamento per l'importazione.

   

   Suggerimento

   L'uso di un nuovo contenitore ogni volta che si importa un aggiornamento consente di evitare l'importazione accidentale di file da aggiornamenti precedenti. Se non si usa un nuovo contenitore, assicurarsi di eliminare eventuali file precedenti dal contenitore esistente.

6. Nella pagina del contenitore selezionare Carica.

   

7. Nella schermata Carica BLOB selezionare l'icona della cartella accanto a File. Usare la selezione file per passare al percorso dei file manifesto di aggiornamento e importazione, selezionare i file e quindi selezionare Apri. È possibile usare il tasto MAIUSC per selezionare più file.

   

8. Dopo aver selezionato tutti i file, selezionare Carica.

   

9. Dopo il caricamento, i file vengono visualizzati nella pagina del contenitore. Nella pagina contenitore esaminare e selezionare i file da importare e quindi selezionare Seleziona.

   

10. Nella schermata Importa aggiornamento selezionare Importa aggiornamento.

    

Il processo di importazione inizia e la schermata passa alla schermata Aggiornamenti . Dopo che l'importazione ha esito positivo, viene visualizzata nella scheda Aggiornamenti . Per risolvere eventuali errori, vedere Risoluzione dei problemi relativi all'aggiornamento del proxy.

Interfaccia della riga di comando di Azure

Il comando az iot du update stage gestisce i passaggi prerequisiti per l'importazione di un aggiornamento, incluso il caricamento dei file di aggiornamento in un contenitore di archiviazione di destinazione. Un flag facoltativo consente anche a questo comando di importare automaticamente i file dopo preparare i file. In caso contrario, il comando az iot du update import completa il processo.

Il stage comando accetta gli argomenti seguenti:

• --account: nome dell'account di Aggiornamento dispositivi.
• --instance: nome dell'istanza di Aggiornamento dispositivi.
• --manifest-path: percorso del file del manifesto di importazione nella fase.
• --storage-account: nome dell'account di archiviazione in cui preparare l'aggiornamento.
• --storage-container: nome del contenitore all'interno dell'account di archiviazione selezionato in cui preparare l'aggiornamento.
• --overwrite: flag facoltativo che indica se sovrascrivere i BLOB esistenti nel contenitore di archiviazione in caso di conflitto.
• --then-import: flag facoltativo che indica se importare l'aggiornamento in Aggiornamento dispositivi dopo la gestione temporanea.

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

Ad esempio:

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

È possibile includere più manifesti di importazione in un singolo comando. Ad esempio:

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

Se non si usa il --then-import flag, l'output del stage comando include un prompt per eseguire az iot du update import con argomenti prepopolati.

Usare az iot du update list per verificare che gli aggiornamenti siano stati importati correttamente.

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

Importare usando le API di Aggiornamento dispositivi

È anche possibile importare un aggiornamento a livello di codice usando uno dei metodi seguenti:

• API di aggiornamento dei dispositivi negli SDK di Azure per .NET, Java, JavaScript o Python
• L'API REST per l'importazione dell'aggiornamento del dispositivo
• Moduli di PowerShell di esempio (richiede PowerShell 5 o versione successiva per Linux, macOS o Windows)

Nota

Per l'autorizzazione API necessaria, vedere Ruoli utente e accesso di Aggiornamento dispositivi.

I file di aggiornamento e il manifesto di importazione devono essere caricati in un contenitore BLOB Archiviazione di Azure per la gestione temporanea. Per importare i file di gestione temporanea, specificare l'URL del BLOB o la firma di accesso condiviso per i BLOB privati nell'API aggiornamento dispositivi. Se si usa una firma di accesso condiviso, assicurarsi di specificare una finestra di scadenza di tre ore o più.

Suggerimento

Per caricare file di aggiornamento di grandi dimensioni in un contenitore BLOB di Archiviazione di Azure, è possibile usare uno dei metodi seguenti per ottenere prestazioni migliori:

• AzCopy
• Azure Storage Explorer

Contenuto correlato

• Gruppi di dispositivi
• Manifesto di importazione di Aggiornamento dispositivi