Esercitazione: Aggiornamento dei dispositivi per l'hub IoT di Azure usando l'agente del pacchetto su Ubuntu Server 18.04 x64

L'aggiornamento del hub IoT di Azure supporta gli aggiornamenti basati su immagini, pacchetti e script.

Gli aggiornamenti basati su pacchetti sono aggiornamenti mirati che modificano solo un componente o un'applicazione specifici nel dispositivo. Comportano un consumo inferiore della larghezza di banda e consentono di ridurre il tempo necessario per scaricare e installare l'aggiornamento. Gli aggiornamenti basati su pacchetti consentono in genere un minor tempo di inattività dei dispositivi quando si applica un aggiornamento ed evitare il sovraccarico della creazione di immagini. Usano un manifesto APT, che fornisce all'agente Device Update le informazioni necessarie per scaricare e installare i pacchetti specificati nel file manifesto APT (e le relative dipendenze) da un repository designato.

Questa esercitazione illustra come aggiornare Azure IoT Edge in Ubuntu Server 18.04 x64 usando l'agente del pacchetto di Aggiornamento dispositivi. Anche se l'esercitazione illustra l'aggiornamento di IoT Edge, usando passaggi simili è possibile aggiornare altri pacchetti, ad esempio il motore del contenitore usato.

Gli strumenti e i concetti di questa esercitazione si applicano ancora anche se si prevede di usare una configurazione diversa della piattaforma del sistema operativo. Completare questa introduzione a un processo di aggiornamento completo. Scegliere quindi la forma preferita per aggiornare una piattaforma del sistema operativo per approfondire i dettagli.

In questa esercitazione si apprenderà come:

Scaricare e installare l'agente degli Aggiornamenti dei dispositivi e le relative dipendenze.
Aggiungere un tag al dispositivo.
Importare un aggiornamento.
Creare un gruppo di dispositivi.
Distribuire un aggiornamento del pacchetto.
Monitorare la distribuzione degli aggiornamenti.

Prerequisiti

Se non l'hai ancora fatto, crea un account e un'istanza di Device Update. Configurare un hub IoT.
È necessaria la stringa di connessione per un dispositivo IoT Edge.
Se hai usato l'esercitazione dell'agente simulatore per i test precedenti, esegui il comando seguente per richiamare il gestore APT e distribuire gli aggiornamenti del pacchetto over-the-air in questa esercitazione:
```
# sudo /usr/bin/AducIotAgent --register-content-handler /var/lib/adu/extensions/sources/libmicrosoft_apt_1.so --update-type 'microsoft/a pt:1'
```

Preparare un dispositivo

Preparare un dispositivo automaticamente o manualmente.

Usare il pulsante Distribuzione automatica in Azure

Per praticità, questa esercitazione usa un modello di Azure Resource Manager basato su cloud-init per configurare rapidamente una macchina virtuale Ubuntu 18.04 LTS. Installa sia il runtime di Azure IoT Edge che l'agente del pacchetto Device Update. Configura quindi automaticamente il dispositivo con le informazioni di provisioning usando la stringa di connessione del dispositivo per un dispositivo IoT Edge, che è un prerequisito, fornito. Il modello di Resource Manager evita inoltre la necessità di avviare una sessione SSH per completare la configurazione.

Per iniziare, selezionare il pulsante:

.
Compilare le caselle di testo disponibili:
- Sottoscrizione: sottoscrizione di Azure attiva in cui distribuire la macchina virtuale.
- Gruppo di risorse: gruppo di risorse esistente o appena creato per contenere la macchina virtuale e le risorse associate.
- Area: area geografica in cui distribuire la macchina virtuale. Questo valore viene impostato per impostazione predefinita sulla posizione del gruppo di risorse selezionato.
- Etichetta DNS Prefisso: un valore obbligatorio a tua scelta che viene utilizzato per anteporre al nome host della macchina virtuale.
- Nome utente amministratore: un nome utente al quale vengono assegnati privilegi di root durante la distribuzione.
- Stringa di connessione del dispositivo: una stringa di connessione del dispositivo per un dispositivo creato all'interno del tuo hub IoT previsto.
- Dimensioni macchina virtuale: dimensioni della macchina virtuale da distribuire.
- Versione del sistema operativo Ubuntu: versione del sistema operativo Ubuntu da installare nella macchina virtuale di base. Lasciare invariato il valore predefinito perché sarà già impostato su Ubuntu 18.04-LTS.
- Tipo di autenticazione: scegliere sshPublicKey o password in base alle preferenze.
- Password o chiave amministratore: valore della chiave pubblica SSH o del valore della password in base alla scelta del tipo di autenticazione.
Dopo aver compilato tutte le caselle, selezionare la casella di controllo nella parte inferiore della pagina per accettare le condizioni. Selezionare Acquista per avviare la distribuzione.
Verificare che la distribuzione sia stata completata correttamente. Attendere alcuni minuti dopo il completamento della distribuzione per completare l'installazione e la configurazione di IoT Edge e dell'agente di aggiornamento del pacchetto del dispositivo.

Una risorsa macchina virtuale deve essere stata distribuita nel gruppo di risorse selezionato. Prendere nota del nome del computer, che è nel formato vm-0000000000000. Si noti anche il nome DNS associato, che è nel formato <dnsLabelPrefix>.<location>. cloudapp.azure.com.

È possibile ottenere il nome DNS dalla sezione Panoramica della macchina virtuale appena distribuita nel portale Azure.

Suggerimento

Per eseguire SSH in questa macchina virtuale dopo l'installazione, usare il nome DNS associato
Aprire i dettagli di configurazione .Vedere come configurare il file di configurazione qui con il comando seguente. Imposta "connectionType" su "AIS" e "connectionData" come stringa vuota.

/etc/adu/du-config.json

Riavviare l'agente di Aggiornamento dispositivi eseguendo il comando seguente:

 sudo systemctl restart adu-agent

L'aggiornamento dei dispositivi per i pacchetti software hub IoT di Azure è soggetto alle condizioni di licenza seguenti:

Leggere le condizioni di licenza prima di usare un pacchetto. L'installazione e l'uso di un pacchetto implicano l'accettazione di tali condizioni. Se non si accettano le condizioni di licenza, non usare il pacchetto.

Preparare manualmente un dispositivo

Analogamente ai passaggi automatizzati dallo script cloud-init, vengono usati i passaggi manuali seguenti per installare e configurare un dispositivo. Usare questi passaggi per preparare un dispositivo fisico.

Seguire le istruzioni per installare il runtime di Azure IoT Edge seguendo il passaggio.

Nota

L'agente di aggiornamento dei dispositivi non dipende da IoT Edge. Ma si basa sul daemon del servizio di gestione delle identità IoT installato con IoT Edge (1.2.0 e versioni successive) per ottenere un'identità e connettersi all'hub IoT.

Anche se non trattato in questa esercitazione, il daemon del servizio di gestione delle identità IoT può essere installato in modalità autonoma nei dispositivi IoT basati su Linux. La sequenza di installazione è importante. L'agente del pacchetto di Aggiornamento Dispositivi deve essere installato dopo il servizio di gestione delle identità IoT. In caso contrario, l'agente del pacchetto non verrà registrato come componente autorizzato per stabilire una connessione all'hub IoT.

Installare i pacchetti .deb dell'agente di aggiornamento dei dispositivi.

sudo apt-get install deviceupdate-agent deliveryoptimization-plugin-apt

Immettere la stringa di connessione primaria del modulo o del dispositivo del dispositivo IoT (a seconda di come è stato effettuato il provisioning del dispositivo con Device Update) nel file di configurazione eseguendo il comando seguente:
```
/etc/adu/du-config.json
```
Riavviare l'agente di Aggiornamento dispositivi eseguendo il comando seguente:
```
 sudo systemctl restart adu-agent
```

L'aggiornamento dei dispositivi per i pacchetti software hub IoT di Azure è soggetto alle condizioni di licenza seguenti:

Aggiungere un tag al dispositivo

Accedere al portale di Azure e passare all'hub IoT.
Nel riquadro sinistro, in Dispositivi, trovare il dispositivo IoT Edge e passare al dispositivo gemello o al modulo gemello.
Nel modulo gemello dell'agente di aggiornamento dei dispositivi, eliminare tutti i valori dei tag di aggiornamento dispositivo già esistenti impostandoli su nulla. Se si usa l'identità del dispositivo con l'agente di Aggiornamento dei dispositivi, apportare queste modifiche sul dispositivo gemello.

Aggiungere un nuovo valore del tag Device Update, come illustrato di seguito:

    "tags": {
            "ADUGroup": "<CustomTagValue>"
            },

Importare l'aggiornamento

Passare a Versioni di Aggiornamento del dispositivo in GitHub e selezionare l'elenco a discesa Assets. Scaricare Tutorial_IoTEdge_PackageUpdate.zip selezionandolo. Estrarre il contenuto della cartella per individuare un manifesto APT di esempio (sample-1.0.2-aziot-edge-apt-manifest.json) e il manifesto di importazione corrispondente (sample-1.0.2-aziot-edge-importManifest.json).
Accedere al portale di Azure e andare al tuo hub IoT con Aggiornamento dei dispositivi. Nel riquadro sinistro, in Gestione dispositivi automatico, selezionare Aggiornamenti.
Selezionare la scheda Aggiornamenti.
Selezionare + Importa nuovo aggiornamento.
Seleziona + Seleziona dal contenitore di archiviazione. Seleziona un account esistente oppure crea un nuovo account utilizzando + Account di archiviazione. Selezionare quindi un contenitore esistente o creare un nuovo contenitore usando + Contenitore. Questo contenitore viene usato per preparare i file di aggiornamento per l'importazione.

Nota

È consigliabile usare un nuovo contenitore ogni volta che si importa un aggiornamento per evitare l'importazione accidentale di file da aggiornamenti precedenti. Se non si usa un nuovo contenitore, assicurarsi di eliminare eventuali file dal contenitore esistente prima di completare questo passaggio.
Nel contenitore selezionare Carica e passare ai file scaricati nel passaggio 1. Dopo aver selezionato tutti i file di aggiornamento, selezionare Carica. Selezionare quindi il pulsante Seleziona per tornare alla pagina Importa aggiornamento .

Questo screenshot mostra il passaggio di importazione. I nomi di file potrebbero non corrispondere a quelli usati nell'esempio.
Esaminare i file da importare nella pagina Importa aggiornamento. Selezionare quindi Importa aggiornamento per avviare il processo di importazione.
Viene avviato il processo di importazione e la schermata passa alla sezione Cronologia importazione . Quando la colonna Stato indica che l'importazione è riuscita, selezionare l'intestazione Aggiornamenti disponibili . L'aggiornamento importato dovrebbe essere visualizzato nell'elenco.

Scopri di più su come importare gli aggiornamenti.

Creare un gruppo di aggiornamento

Passare alla scheda Gruppi e distribuzioni nella parte superiore della pagina.
Selezionare il pulsante aggiungi gruppo per creare un nuovo gruppo.
Selezionare un tag dell'hub IoT e una classe dispositivo dall'elenco. Selezionare quindi Crea gruppo.
Dopo aver creato il gruppo, si noterà che l'elenco dei gruppi e del grafico di conformità degli aggiornamenti viene aggiornato. Il grafico conformità degli aggiornamenti mostra il numero di dispositivi in vari stati di conformità: aggiornamento più recente, Nuovi aggiornamenti disponibili e Aggiornamenti in corso. Informati sulla conformità agli aggiornamenti
Verrà visualizzato il gruppo appena creato e gli eventuali aggiornamenti disponibili per i dispositivi nel nuovo gruppo. Se sono presenti dispositivi che non soddisfano i requisiti di classe del dispositivo del gruppo, vengono visualizzati in un gruppo non valido corrispondente. Per distribuire il miglior aggiornamento disponibile al nuovo gruppo definito dall'utente da questa visualizzazione, selezionare Distribuisci accanto al gruppo.

Scopri di più su come aggiungere tag e creare gruppi di aggiornamento.

Distribuire l'aggiornamento

Dopo aver creato il gruppo, verrà visualizzato un nuovo aggiornamento disponibile per il gruppo di dispositivi con un collegamento all'aggiornamento in Aggiornamento migliore. Potrebbe essere necessario eseguire l'aggiornamento una sola volta. Scopri di più sulla conformità degli aggiornamenti.
Selezionare il gruppo di destinazione selezionando il nome del gruppo. Si viene indirizzati ai dettagli del gruppo in Nozioni di base sui gruppi.
Per avviare la distribuzione, vai alla scheda Distribuzione corrente. Seleziona il collegamento distribuisci accanto all'aggiornamento desiderato nella sezione Aggiornamenti disponibili. L'aggiornamento migliore disponibile per un determinato gruppo è indicato con un'evidenziazione migliore .
Pianifica la distribuzione per iniziare immediatamente o in futuro. Poi selezionare Crea.

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 in precedenza.
Nei Dettagli di distribuzione, lo stato diventa Attivo. L'aggiornamento distribuito è contrassegnato con (distribuzione).
Visualizzare il grafico di conformità per verificare che l'aggiornamento sia in corso.
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.

Monitorare la distribuzione degli aggiornamenti

Selezionare la scheda Cronologia distribuzione nella parte alta della pagina.
Selezionare il link dettagli accanto alla distribuzione creata.
Selezionare Aggiorna per visualizzare i dettagli dello stato più recenti.

Hai ora completato con successo un aggiornamento end-to-end del pacchetto utilizzando Aggiornamento del dispositivo per IoT Hub su un dispositivo Ubuntu Server 18.04 x64.

Pulire le risorse

Quando non sono più necessari, elimina l'account di aggiornamento del dispositivo, l'istanza e l'hub IoT. Ripulire anche il dispositivo IoT Edge se hai creato la macchina virtuale tramite il pulsante Distribuisci in Azure. Per pulire le risorse, passare a ogni singola risorsa e selezionare Elimina. Eseguire la pulizia di un'istanza di aggiornamento del dispositivo prima di pulire l'account di aggiornamento del dispositivo.

Passaggi successivi

Usare le esercitazioni seguenti per una semplice dimostrazione di Aggiornamento dei dispositivi per l'hub IoT:

Aggiornamento immagini: introduzione all'immagine Yocto di riferimento Raspberry Pi 3 B+ estendibile tramite open source per creare immagini personalizzate per altre architetture in base alle esigenze.
Aggiornamento proxy : Introduzione all'uso dell'agente binario di Aggiornamento Dispositivi per i dispositivi downstream.
Introduzione all'uso dell'agente di riferimento del simulatore Ubuntu (18.04 x64).
esercitazione sull'aggiornamento dei dispositivi per l'hub IoT di Azure per il sistema operativo in tempo reale di Azure.

Last updated on 2022-01-26

Condividi tramite