Importare un aggiornamento in Aggiornamento dispositivi per hub IoT

Browser supportati:

• Microsoft Edge
• Google Chrome

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.

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 Aggiornamenti disponibili.

   

5. Selezionare + Seleziona dal contenitore di archiviazione. Viene visualizzata l'interfaccia utente degli account di archiviazione. Selezionare un account esistente o creare un account usando + Account di archiviazione. 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 di 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 Aggiornamenti disponibili. L'aggiornamento importato dovrebbe essere visualizzato nell'elenco.

    

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