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 raggiungerà il 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 aggiornerà il modello di distribuzione per i moduli IoT Edge. I partner (autori di moduli) inizieranno a ospitare i moduli IoT Edge nei registri contenitori di proprietà dell'autore. Le immagini dei moduli 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 dell'immagine fornito dall'autore.

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 da assegnare a più dispositivi in base ai relativi tag condivisi, vedere Distribuire e monitorare i moduli di IoT Edge su larga scala.

Prerequisiti

• Un hub IoT nella sottoscrizione di Azure.

• Un dispositivo IoT Edge.

  Se non si dispone di un dispositivo IoT Edge configurato, è possibile crearne uno in una macchina virtuale di Azure. Seguire la procedura descritta in uno di questi articoli della guida introduttiva per 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 funzionalità come l'ordine di avvio del modulo e la definizione delle priorità di 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 Container della pagina, specificare le credenziali per accedere ai registri contenitori che contengono le immagini dei moduli. 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 Registro artefatti Microsoft. Per i moduli partner, contattare l'autore del modulo IoT Edge per ottenere l'URI dell'immagine del contenitore.

Ad esempio, per aggiungere il modulo sensore temperatura simulato 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 dei moduli 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 all'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.

Controllare 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 dell'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 di IoT Edge su larga scala.