Distribuire i moduli di Azure IoT Edge dal portale di Azure

Si applica a: IoT Edge 1.5 IoT Edge 1.4

Importante

IoT Edge 1.5 LTS e IoT Edge 1.4 LTS sono versioni supportate. IoT Edge 1.4 LTS è di fine vita il 12 novembre 2024. Se si usa una versione precedente, vedere Aggiornare IoT Edge.

Importante

A partire dal 28 agosto 2024, Azure Marketplace sta aggiornando il modello di distribuzione per i moduli IoT Edge. I partner (editori di moduli) inizieranno a ospitare i moduli IoT Edge nei registri contenitori di proprietà dell'editore. Le immagini del modulo IoT Edge non saranno disponibili per il download dal registro contenitori di Azure Marketplace.

Contattare l'autore del modulo IoT Edge per ottenere l'URI dell'immagine del contenitore aggiornato e aggiornare le configurazioni dei dispositivi IoT Edge con il nuovo URI immagine fornito dall'editore.

I dispositivi IoT Edge che non usano i moduli partner acquisiti da Azure Marketplace non sono interessati e non è necessaria alcuna azione.

Dopo aver creato i moduli di IoT Edge in base alla propria logica di business, si distribuiscono i moduli nei dispositivi per consentirne l'uso a livello perimetrale. Se si hanno più moduli che interagiscono per raccogliere ed elaborare dati, è possibile distribuirli contemporaneamente e dichiarare le regole di routing che li connettono.

Questo articolo illustra come il portale di Azure consente di creare un manifesto della distribuzione ed eseguire il push della distribuzione a un dispositivo IoT Edge. Per informazioni sulla creazione di una distribuzione destinata a più dispositivi in base ai tag condivisi, vedere Distribuire e monitorare i moduli IoT Edge su larga scala.

Prerequisiti

• Un hub IoT nella sottoscrizione di Azure.

• Un dispositivo IoT Edge.

  Se non è configurato un dispositivo IoT Edge, è possibile crearne uno in una macchina virtuale di Azure. Seguire la procedura descritta in uno degli articoli di avvio rapido su Creare un dispositivo Linux virtuale o Creare un dispositivo Windows virtuale.

Configurare un manifesto della distribuzione

Un manifesto della distribuzione è un documento JSON contenente la descrizione dei moduli da distribuire, dei flussi di dati esistenti tra i moduli e delle proprietà desiderate dei moduli gemelli. Per altre informazioni sul funzionamento e sulla modalità di creazione dei manifesti della distribuzione, vedere Informazioni su come usare, configurare e riusare i moduli IoT Edge.

Nel portale di Azure è disponibile una procedura guidata che consente di creare il manifesto dell'applicazione anziché creare il documento JSON manualmente. Sono previsti tre passaggi: Add modules (Aggiungere moduli), Specify routes (Specificare route) e Review deployment (Verificare la distribuzione).

Nota

I passaggi descritti in questo articolo riflettono la versione più recente dello schema dell'agente e dell'hub IoT Edge. La versione dello schema 1.1 è stata rilasciata insieme a IoT Edge versione 1.0.10 e abilita l'ordine di avvio del modulo e le funzionalità di definizione delle priorità delle route.

Se si esegue la distribuzione in un dispositivo che esegue la versione 1.0.9 o precedente, modificare le impostazioni di runtime nel passaggio Moduli della procedura guidata per usare la versione dello schema 1.0.

Selezionare il dispositivo e aggiungere moduli

1. Accedere al portale di Azure e passare all'hub IoT.

2. Nel riquadro sinistro selezionare Dispositivi nel menu Gestione dispositivi.

3. Selezionare il dispositivo IoT Edge di destinazione dall'elenco.

4. Sulla barra superiore selezionare Imposta moduli.

5. Nella sezione Credenziali del Registro Contenitori della pagina specificare le credenziali per accedere ai registri contenitori che contengono immagini del modulo. Ad esempio, i moduli si trovano nel registro contenitori privato o si usa un registro contenitori partner che richiede l'autenticazione.

6. Nella sezione Moduli IoT Edge della pagina selezionare Aggiungi.

   

7. Scegliere il tipo di moduli da aggiungere dal menu a discesa. È possibile aggiungere moduli IoT Edge o moduli di Analisi di flusso di Azure.

Modulo IoT Edge

Usare questa opzione per aggiungere moduli Microsoft, moduli partner o moduli personalizzati. Specificare il nome del modulo e l'URI dell'immagine del contenitore. L'URI dell'immagine del contenitore è il percorso dell'immagine del modulo in un registro contenitori. Per un elenco delle immagini del modulo Microsoft IoT Edge, vedere la Registro artefatti Microsoft. Per i moduli partner, contattare l'editore del modulo IoT Edge per ottenere l'URI dell'immagine del contenitore.

Ad esempio, per aggiungere il modulo sensore di temperatura simulato Da Microsoft:

1. Immetti le impostazioni seguenti:

   Impostazione	Valore
   URI immagine	mcr.microsoft.com/azureiotedge-simulated-temperature-sensor
   Criteri di riavvio	sempre
   Stato desiderato	in esecuzione

   

2. Selezionare Aggiungi.

3. Dopo aver aggiunto un modulo, selezionare il nome del modulo dall'elenco per aprire le impostazioni del modulo. Specificare i campi facoltativi, se necessario.

   

Per altre informazioni sulle impostazioni del modulo disponibili, vedere Configurazione e gestione dei moduli.

Per altre informazioni sul modulo gemello, vedere Definire o aggiornare le proprietà desiderate.

Modulo Analisi di flusso di Azure

Usare questa opzione per i moduli generati da un carico di lavoro di Analisi di flusso di Azure.

1. Selezionare la sottoscrizione e il processo Edge di Analisi di flusso di Azure creato.
2. Seleziona Salva.

Per altre informazioni sulla distribuzione di Analisi di flusso di Azure in un modulo IoT Edge, vedere Esercitazione: Distribuire Analisi di flusso di Azure come modulo IoT Edge.

Specificare le route

Nella scheda Route è possibile definire come vengono passati i messaggi tra i moduli e l'hub IoT. I messaggi vengono costruiti mediante coppie nome/valore. Per impostazione predefinita, la prima distribuzione per un nuovo dispositivo include una route denominata route e definita come FROM /messages/* INTO $upstream, il che significa che tutti i messaggi restituiti da qualsiasi modulo vengono inviati al hub IoT.

I parametri Priority e Time to Live sono parametri facoltativi che è possibile includere in una definizione di route. Il parametro priority consente di scegliere quali route devono essere elaborate per prime o quali route devono essere elaborate per ultime. La priorità viene determinata impostando un numero da 0 a 9, dove 0 è la priorità superiore. Il parametro time-to-live consente di dichiarare per quanto tempo devono essere mantenuti i messaggi in tale route fino a quando non vengono elaborati o rimossi dalla coda.

Per altre informazioni su come creare route, vedere Dichiarare le route.

Dopo aver impostato le route, selezionare Avanti: Rivedi e crea per continuare con il passaggio successivo della procedura guidata.

Rivedere la distribuzione

La sezione relativa alla verifica mostra il manifesto della distribuzione JSON che è stato creato in base alle selezioni nelle due sezioni precedenti. Si noti che sono presenti due moduli dichiarati che non sono stati aggiunti: $edgeAgent e $edgeHub. Questi due moduli costituiscono il runtime di IoT Edge e sono impostazioni predefinite obbligatorie in ogni distribuzione.

Esaminare le informazioni sulla distribuzione e quindi selezionare Crea.

Visualizzare i moduli nel dispositivo

Dopo aver distribuito i moduli nel dispositivo, è possibile visualizzarli tutti nella pagina dei dettagli del dispositivo del hub IoT. Questa pagina visualizza il nome di ogni modulo distribuito e informazioni utili come lo stato della distribuzione e il codice di uscita.

Selezionare Avanti: Route e continuare con la distribuzione come descritto in Specificare le route e rivedere la distribuzione in precedenza in questo articolo.

Passaggi successivi

Informazioni su come distribuire e monitorare i moduli IoT Edge su larga scala.