Distribuire un aggiornamento usando Aggiornamento dispositivi di Azure per hub IoT

Questo articolo illustra come distribuire un aggiornamento ai dispositivi IoT usando Aggiornamento dispositivi di Azure per hub IoT nel portale di Azure o con l'interfaccia della riga di comando di Azure.

Prerequisiti

• Istanza Standard (S1) o superiore di hub IoT di Azure con Aggiornamento del dispositivo per hub IoT abilitata.
• Un dispositivo O un simulatore IoT di cui è stato effettuato il provisioning per l'aggiornamento del dispositivo all'interno dell'hub IoT. Il dispositivo di cui è stato effettuato il provisioning può essere membro di un gruppo di dispositivi creato dall'utente o del gruppo predefinito.
• Aggiornamento importato per il dispositivo di cui è stato effettuato il provisioning.

Distribuire l'aggiornamento

Questa sezione descrive come distribuire l'aggiornamento usando il portale di Azure o l'interfaccia della riga di comando di Azure.

Azure portal

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

2. Selezionare Aggiornamenti in Gestione dei dispositivi nel riquadro di spostamento sinistro.

   

3. Nella pagina Aggiornamenti selezionare la scheda Gruppi e distribuzioni e visualizzare il grafico di conformità degli aggiornamenti e l'elenco dei gruppi di dispositivi. Potrebbe essere necessario aggiornare la visualizzazione per visualizzare gli aggiornamenti importati di recente disponibili per il gruppo di dispositivi.

4. In Stato nell'elenco dei gruppi selezionare Distribuisci accanto a Uno o più nuovi aggiornamenti disponibili per questo gruppo.

   

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

6. Selezionare Distribuisci accanto a uno o più aggiornamenti disponibili .

7. Nell'elenco a destra selezionare l'aggiornamento desiderato da distribuire.

   

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

   Suggerimento

   Per impostazione predefinita, la data e l'ora di inizio sono 24 ore dall'ora corrente. Assicurarsi di selezionare una data e un'ora diverse se si vuole che la distribuzione inizi prima o successivamente.

   

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

10. Nella scheda Aggiornamenti correnti è possibile visualizzare lo stato della distribuzione.

    

11. Nella visualizzazione Informazioni di base sui gruppi, il grafico di conformità mostra che l'aggiornamento è in corso.

    Dopo l'aggiornamento del dispositivo, il grafico di conformità e i dettagli della distribuzione vengono aggiornati per riflettere tale stato.

Interfaccia della riga di comando di Azure

È possibile usare l'ambiente Bash in Azure Cloud Shell per eseguire i comandi seguenti. 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.

Verificare la disponibilità degli aggiornamenti

1. Usare il az iot du device group list comando per identificare il gruppo di dispositivi.

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

2. az iot du device group show Usare quindi per visualizzare 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, ovvero il valore del ADUGroup tag o $default per i dispositivi senza tag.
   • --resource-group: nome del gruppo di risorse dell'account di Aggiornamento dispositivi.
   • --best-updates: restituisce i migliori aggiornamenti disponibili per il gruppo di dispositivi, incluso un conteggio del numero di dispositivi necessari per ogni aggiornamento.
   • --update-compliance: restituisce le informazioni di conformità degli aggiornamenti del gruppo di dispositivi, ad esempio il numero di dispositivi nell'aggiornamento più recente, il numero di nuovi aggiornamenti necessari e il numero di nuovi aggiornamenti che attualmente ricevono un nuovo aggiornamento.

   Per verificare il miglior aggiornamento disponibile per il gruppo, eseguire il comando come indicato di seguito:

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

Creare la distribuzione

Usare az iot du device deployment create per creare una distribuzione per il gruppo di dispositivi. 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, ovvero il valore del ADUGroup tag o $default per i dispositivi senza tag.
• --deployment-id: ID per identificare questa distribuzione.
• --update-name, --update-providere --update-version: parametri che definiscono l'oggetto updateId , un identificatore univoco per l'aggiornamento in questa distribuzione.

Eseguire il comando come indicato di seguito:

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>

Usare argomenti facoltativi

Gli argomenti facoltativi consentono di configurare ulteriormente la distribuzione. Per l'elenco completo degli argomenti facoltativi, 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 attiva un rollback.
• --failed-percentage: percentuale di dispositivi non riusciti in una distribuzione che attiva un rollback.
• --rollback-update-name, --rollback-update-provider, : --rollback-update-versionparametri per l'aggiornamento da usare se viene avviato un rollback.

Eseguire il comando come indicato di seguito:

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>

Per impostare l'ora di inizio della distribuzione, usare il --start-time parametro per specificare la data e l'ora di destinazione per la distribuzione, come indicato di seguito:

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 lo stato della distribuzione

Azure portal

1. Nella scheda Gruppi e distribuzioni della pagina Aggiornamenti selezionare il gruppo in cui è stata distribuita.

2. Nella pagina Dettagli gruppo passare alla scheda Distribuzione corrente o Cronologia distribuzione per verificare che una distribuzione sia in corso.

   

3. Selezionare Dettagli accanto a una distribuzione per visualizzare i dettagli della distribuzione, aggiornare i dettagli e i dettagli della classe del dispositivo di destinazione. Facoltativamente, è possibile aggiungere un nome descrittivo per la classe del dispositivo.

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

   

Passare alla scheda Informazioni di base del gruppo della pagina Dettagli gruppo per cercare lo stato di un determinato dispositivo 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 tutte le distribuzioni 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, è 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>

Contenuto correlato

• Distribuzioni di Aggiornamento dispositivi
• Guida alla risoluzione dei problemi di Aggiornamento dei dispositivi