Distribuire un aggiornamento usando Aggiornamento dispositivi per hub IoT di Azure

Informazioni su come distribuire un aggiornamento in un dispositivo IoT usando Aggiornamento dispositivi per hub IoT di Azure.

Prerequisiti

• Accesso a un hub IoT con Aggiornamento del dispositivo per hub IoT abilitato. È consigliabile usare un livello S1 (Standard) o superiore per il hub IoT.
• Aggiornamento importato per il dispositivo di cui è stato effettuato il provisioning.
• Provisioning di un dispositivo IoT (o simulatore) per Aggiornamento dispositivi all'interno di hub IoT.
• Il dispositivo fa parte di almeno un gruppo predefinito o di un gruppo di aggiornamento creato dall'utente.

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.

Distribuire l'aggiornamento

Azure portal

1. Nel portale di Azure passare all'hub IoT.

2. Selezionare Aggiornamenti dal menu di spostamento per aprire la pagina Aggiornamento dispositivi dell'istanza di hub IoT.

   

3. Selezionare la scheda Gruppi e distribuzioni nella parte superiore della pagina. Per altre informazioni, vedere Gruppi di dispositivi.

   

4. Visualizzare il grafico di conformità degli aggiornamenti e l'elenco di gruppi. Verrà visualizzato un nuovo aggiornamento disponibile per il gruppo basato su tag o predefinito. Potrebbe essere necessario eseguire l'aggiornamento una sola volta. Per altre informazioni, vedere Conformità degli aggiornamenti dei dispositivi.

5. Selezionare Distribuisci accanto a uno o più aggiornamenti disponibili e verificare che l'etichetta descrittiva aggiunta durante l'importazione sia presente e abbia un aspetto corretto.

6. Verificare che il gruppo corretto sia selezionato come gruppo di destinazione e selezionare Distribuisci.

7. Per avviare la distribuzione, passare alla scheda Distribuzione corrente. Selezionare il collegamento Distribuisci accanto all'aggiornamento desiderato nella sezione Aggiornamenti disponibili. L'aggiornamento migliore disponibile per un determinato gruppo è indicato con un'evidenziazione migliore .

   

8. Pianificare l'avvio immediato o futuro della distribuzione.

   Suggerimento

   Per impostazione predefinita, la data e l'ora di inizio sono impostate su Immediatamente. Assicurarsi di selezionare una data e un'ora diverse se si vuole che la distribuzione inizi in un secondo momento.

   

9. Creare un criterio di rollback automatico, se necessario. Selezionare Crea.

10. Nei dettagli della distribuzione lo stato diventa Attivo. L'aggiornamento distribuito è contrassegnato con (distribuzione).

    

11. Visualizzare il grafico di conformità per verificare che l'aggiornamento sia in corso.

    

12. Dopo che il dispositivo è stato aggiornato correttamente, si noterà che il grafico di conformità e i dettagli della distribuzione sono stati aggiornati per riflettere lo stesso.

    

Interfaccia della riga di comando di Azure

Oggetto az iot du device group list per verificare l'aggiornamento migliore disponibile per il gruppo. Il comando accetta gli argomenti seguenti:

• --account: nome dell'account di Aggiornamento dispositivi.
• --instance: nome dell'istanza di Aggiornamento dispositivi.
• --group-id: ID del gruppo di dispositivi di destinazione con questa distribuzione. Questo ID è il valore del tag ADUGroup o $default per i dispositivi senza tag.
• --best-updates: questo flag indica che il comando deve recuperare i migliori aggiornamenti disponibili per il gruppo di dispositivi, incluso un conteggio del numero di dispositivi necessari per ogni aggiornamento.
• '--resource-group -g': nome del gruppo di risorse dell'account di aggiornamento del dispositivo.
• '--update-compliance': questo flag indica che il comando deve recuperare le informazioni di conformità dell'aggiornamento del gruppo di dispositivi, ad esempio il numero di dispositivi nell'aggiornamento più recente, il numero di nuovi aggiornamenti necessari e il numero di aggiornamenti in corso durante la ricezione di un nuovo aggiornamento.

az iot du device group list \
    --account <Device Update account name> \
    --instance <Device Update instance name>\
    --gid <device group id>\
    --best-updates {false, true}

Usare az iot du device deployment create per creare una distribuzione per un gruppo di dispositivi.

Il device deployment create comando accetta gli argomenti seguenti:

• --account: nome dell'account di Aggiornamento dispositivi.
• --instance: nome dell'istanza di Aggiornamento dispositivi.
• --group-id: ID del gruppo di dispositivi di destinazione con questa distribuzione. Questo ID è il valore del tag ADUGroup o $default per i dispositivi senza tag.
• --deployment-id: ID per identificare questa distribuzione.
• --update-name, --update-providere --update-version: questi tre parametri definiscono l'oggetto updateId che è un identificatore univoco per l'aggiornamento in uso in questa distribuzione.

az iot du device deployment create \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --group-id <device group id> \
    --deployment-id <deployment id> \
    --update-name <update name> \
    --update-provider <update provider> \
    --update-version <update version>

Gli argomenti facoltativi consentono di configurare la distribuzione. Per l'elenco completo, vedere Parametri facoltativi

Per creare un criterio di rollback automatico, aggiungere i parametri seguenti:

• --failed-count: numero di dispositivi non riusciti in una distribuzione che attiverà un rollback.
• --failed-percentage: percentuale di dispositivi non riusciti in una distribuzione che attiverà un rollback.
• --rollback-update-name, --rollback-update-provider, : --rollback-update-versionupdateID per l'aggiornamento che verrà usato dal gruppo di dispositivi se viene avviato un rollback.

az iot du device deployment create \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --group-id <device group id> \
    --deployment-id <deployment id> \
    --update-name <update name> \
    --update-provider <update provider> \
    --update-version <update version> \
    --failed-count 10 \
    --failed-percentage 5 \
    --rollback-update-name <rollback update name> \
    --rollback-update-provider <rollback update provider> \
    --rollback-update-version <rollback update version>

Se si vuole che la distribuzione venga avviata in futuro, usare il --start-time parametro per specificare il valore datetime di destinazione per la distribuzione.

az iot du device deployment create \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --group-id <device group id> \
    --deployment-id <deployment id> \
    --update-name <update name> \
    --update-provider <update provider> \
    --update-version <update version> \
    --start-time "2022-12-20T01:00:00"

Monitorare una distribuzione degli aggiornamenti

Azure portal

1. Selezionare il gruppo distribuito in e passare alla scheda Aggiornamenti correnti o Cronologia distribuzione per verificare che la distribuzione sia in corso

   

2. Selezionare Dettagli accanto alla distribuzione creata. Qui è possibile visualizzare i dettagli della distribuzione, i dettagli dell'aggiornamento e i dettagli della classe del dispositivo di destinazione. Facoltativamente, è possibile aggiungere un nome descrittivo per la classe del dispositivo.

   

3. Selezionare Aggiorna per visualizzare i dettagli dello stato più recenti.

4. È possibile passare alla visualizzazione informazioni di base del gruppo per cercare uno stato specifico o filtrare per visualizzare i dispositivi che hanno avuto esito negativo nella distribuzione

Interfaccia della riga di comando di Azure

Usare az iot du device deployment list per visualizzare tutta la distribuzione per un gruppo di dispositivi.

az iot du device deployment list \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --group-id <device group id>

Usare az iot du device deployment show per visualizzare i dettagli di una distribuzione specifica.

az iot du device deployment show \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --group-id <device group ID> \
    --deployment-id <deployment ID>

Aggiungere il --status flag per restituire informazioni sul numero di dispositivi nella distribuzione in corso, completati o non riusciti.

az iot du device deployment show \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --group-id <device group ID> \
    --deployment-id <deployment ID> \
    --status

Riprovare a eseguire una distribuzione di aggiornamento

Se la distribuzione non riesce per qualche motivo, è possibile ritentare la distribuzione per i dispositivi non riusciti.

Azure portal

1. Passare alla scheda Distribuzione corrente nella schermata Dettagli gruppo.

   

2. Selezionare Riprovare i dispositivi non riusciti e confermare la notifica di conferma.

Interfaccia della riga di comando di Azure

Usare az iot du device deployment retry per ritentare una distribuzione per un sottogruppo di dispositivi di destinazione.

Questo comando accetta l'argomento --class-id , generato dall'ID modello e dalle proprietà di compatibilità segnalate dall'agente di aggiornamento del dispositivo.

az iot du device deployment retry \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --deployment-id <deployment ID> \
    --group-id <device group ID> \
    --class-id <device class ID>

Passaggi successivi

Risolvere i problemi comuni