Importare un aggiornamento in Aggiornamento dispositivi per hub IoT

Informazioni su come ottenere un nuovo aggiornamento e importarlo in Aggiornamento dispositivi per hub IoT. Se non è già stato fatto, assicurarsi di esaminare i concetti chiave relativi all'importazione e come preparare un aggiornamento da importare.

Prerequisiti

• Accesso a un hub IoT con Aggiornamento del dispositivo per hub IoT abilitato.
• Provisioning di un dispositivo IoT (o simulatore) per Aggiornamento dispositivi all'interno di hub IoT.
• Seguire la procedura descritta in Preparare un aggiornamento da importare in Aggiornamento dispositivi per hub IoT per creare il manifesto di importazione per i file di aggiornamento.

Azure portal

Browser supportati:

• Microsoft Edge
• Google Chrome

Interfaccia della riga di comando di Azure

Un ambiente dell'interfaccia della riga di comando di Azure:

• Usare l'ambiente Bash in Azure Cloud Shell.

  

• In alternativa, se si preferisce eseguire i comandi di riferimento dell'interfaccia della riga di comando in locale, installare l'interfaccia della riga di comando di Azure

  1. Accedere all'interfaccia della riga di comando di Azure usando il comando az login .
  2. Eseguire az version per trovare la versione e le librerie dipendenti installate. Per eseguire l'aggiornamento alla versione più recente, eseguire az upgrade.
  3. Quando richiesto, installare le estensioni dell'interfaccia della riga di comando di Azure al primo utilizzo. I comandi in questo articolo usano l'estensione azure-iot . Eseguire az extension update --name azure-iot per assicurarsi di usare la versione più recente dell'estensione.

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 una barra rovesciata "" 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 usare l'aggiornamento del dispositivo per le API hub IoT per importare un aggiornamento.

Per importare un aggiornamento, caricare prima di tutto i file di aggiornamento e importare il manifesto in un contenitore Archiviazione di Azure. Importare quindi l'aggiornamento da Archiviazione di Azure in Aggiornamento dispositivi per hub IoT, in cui verrà archiviato per la distribuzione nei dispositivi.

Azure portal

1. Nella portale di Azure passare al hub IoT con Aggiornamento del dispositivo.

2. Sul lato sinistro della pagina selezionare Aggiornamenti in Gestione dispositivi.

   

3. Selezionare la scheda Aggiornamenti dall'elenco delle schede nella parte superiore della schermata.

   

4. Selezionare + Importa un nuovo aggiornamento sotto l'intestazione Disponibile Aggiornamenti.

   

5. Selezionare + Seleziona dal contenitore di archiviazione. Viene visualizzata l'interfaccia utente degli account Archiviazione. Selezionare un account esistente oppure creare un account usando + Archiviazione account. Questo account viene usato per un contenitore per la gestione temporanea degli aggiornamenti per l'importazione. L'account non deve avere endpoint pubblici e privati abilitati contemporaneamente.

   

6. Dopo aver selezionato un account Archiviazione, viene visualizzata l'interfaccia utente contenitori. Selezionare un contenitore esistente o creare un contenitore usando + Contenitore. Questo contenitore viene usato per preparare i file di aggiornamento per l'importazione

   È consigliabile usare un nuovo contenitore ogni volta che si importa un aggiornamento. L'uso sempre di nuovi contenitori consente di evitare di importare accidentalmente file dagli aggiornamenti precedenti. Se non si usa un nuovo contenitore, assicurarsi di eliminare eventuali file dal contenitore esistente prima di completare questo passaggio.

   

7. Nel contenitore selezionare Carica. Viene visualizzata l'interfaccia utente di caricamento.

   

8. Selezionare l'icona della cartella sul lato destro della sezione File sotto l'intestazione Carica BLOB . Usare la selezione file per passare al percorso dei file di aggiornamento e importare il manifesto, selezionare tutti i file e quindi selezionare Apri. È possibile tenere premuto MAIUSC e fare clic su per selezionare più file.

   

9. Dopo aver selezionato tutti i file di aggiornamento, selezionare Carica.

   

10. Selezionare i file caricati per designarli da importare. Selezionare quindi il pulsante Seleziona per tornare alla pagina Importa aggiornamento .

    

11. Nella pagina Importa aggiornamento esaminare i file da importare. Selezionare quindi Importa aggiornamento per avviare il processo di importazione. Per risolvere eventuali errori, vedere Risoluzione dei problemi relativi all'aggiornamento del proxy.

    

12. Viene avviato il processo di importazione e la schermata passa alla sezione Cronologia importazione . Selezionare Aggiorna per visualizzare lo stato di avanzamento fino al completamento del processo di importazione (a seconda delle dimensioni dell'aggiornamento, il processo potrebbe essere completato in pochi minuti, ma potrebbe richiedere più tempo).

    

13. Quando la colonna Stato indica che l'importazione è riuscita, selezionare l'intestazione Disponibile Aggiornamenti. L'aggiornamento importato dovrebbe essere visualizzato nell'elenco.

    

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 la preparazione. 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 che deve essere gestito in staging.
• --storage-account: nome dell'account di archiviazione per preparare l'aggiornamento.
• --storage-container: nome del contenitore all'interno dell'account di archiviazione selezionato per 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 l'aggiornamento deve essere importato in Aggiornamento dispositivi dopo che è stato eseguito il staging.

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

Se sono presenti più manifesti di importazione, è possibile includerli tutti in un unico 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, inclusi gli argomenti prepopolato.

Usare az iot du update list per verificare che l'aggiornamento o 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

Se invece si esegue l'importazione con le API

È anche possibile importare un aggiornamento a livello di codice tramite:

• Uso di Azure SDK per .NET, Java, JavaScript o Python
• Uso dell'API REST di importazione dell'aggiornamento
• Uso di moduli di PowerShell di esempio
  • Richiede PowerShell 5 o versione successiva (include installazioni Linux, macOS e Windows)

Nota

Per l'autorizzazione API necessaria, fare riferimento a Ruoli utente di aggiornamento del dispositivo e accesso .

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 Archiviazione di Azure contenitore BLOB, è possibile usare una delle opzioni seguenti per ottenere prestazioni migliori:

• AzCopy
• Azure Storage Explorer

Passaggi successivi

• Creare gruppi
• Informazioni sui concetti di importazione