Distribuire i moduli di Azure IoT Edge dal portale di Azure

Si applica a: IoT Edge 1.4

Importante

IoT Edge 1.4 è la versione supportata. Se si usa una versione precedente, vedere Aggiornare IoT Edge.

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 il runtime Impostazioni 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 a tutti i registri contenitori privati che contengono le immagini del modulo.

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

7. Scegliere uno dei tre tipi di moduli dal menu a discesa:

   • Modulo IoT Edge: specificare il nome del modulo e l'URI dell'immagine del contenitore. Ad esempio, l'URI dell'immagine per il modulo SimulatedTemperatureSensor di esempio è mcr.microsoft.com/azureiotedge-simulated-temperature-sensor:1.0. Se l'immagine del modulo viene archiviata in un registro contenitori privato, aggiungere le credenziali in questa pagina per accedere all'immagine.
   • Modulo Marketplace: moduli ospitati in Azure Marketplace. Alcuni moduli del Marketplace richiedono una configurazione aggiuntiva, quindi esaminare i dettagli del modulo nell'elenco Moduli IoT Edge di Azure Marketplace.
   • Modulo di Analisi di flusso di Azure: moduli generati da un carico di lavoro di Analisi di flusso di Azure.

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

9. Ripetere i passaggi da 6 a 8 per aggiungere altri moduli alla distribuzione.

10. Selezionare Avanti: Route per continuare con la sezione route.

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.

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.

Distribuire i moduli da Azure Marketplace

Azure Marketplace è un marketplace di applicazioni e servizi online in cui è possibile esplorare un'ampia gamma di applicazioni e soluzioni aziendali certificate e ottimizzate per l'esecuzione in Azure, inclusi i moduli IoT Edge.

È possibile distribuire un modulo IoT Edge da Azure Marketplace e dal hub IoT.

Distribuire da Azure Marketplace

Per usare i moduli IoT Edge nel marketplace e quando si trova quello che si vuole distribuire, selezionare Crea o Scarica adesso. Procedere con i passaggi della distribuzione guidata che possono variare a seconda del modulo IoT Edge selezionato:

1. Accettare le condizioni per l'utilizzo e l'informativa sulla privacy del provider selezionando Continua. Potrebbe prima essere necessario fornire le informazioni di contatto.
2. Scegliere la sottoscrizione e l'hub IoT a cui è collegato il dispositivo di destinazione.
3. Scegliere Distribuisci in un dispositivo.
4. Immettere il nome del dispositivo o selezionare Trova dispositivo per cercare tra i dispositivi registrati nell'hub.
5. Selezionare Crea per continuare il processo standard di configurazione di un manifesto della distribuzione, inclusa l'aggiunta di altri moduli, se lo si desidera. I dettagli per il nuovo modulo, ad esempio URI dell'immagine, opzioni di creazione e proprietà desiderate, sono predefiniti, ma possono essere modificati.

Verificare che il modulo sia distribuito nel hub IoT nel portale di Azure. Selezionare il dispositivo, selezionare Imposta moduli e il modulo deve essere elencato nella sezione Moduli IoT Edge.

Eseguire la distribuzione da hub IoT di Azure

È possibile distribuire rapidamente un modulo da Azure Marketplace nel dispositivo nel hub IoT nel portale di Azure.

1. Nel portale di Azure passare all'hub IoT.
2. Nel riquadro sinistro selezionare Dispositivi nel menu Gestione dispositivi.
3. Selezionare il dispositivo IoT Edge che riceverà la distribuzione.
4. Sulla barra superiore selezionare Imposta moduli.
5. Nella sezione Moduli di IoT Edge fare clic su Aggiungi e selezionare Modulo marketplace dal menu a discesa.

Scegliere un modulo dalla pagina Marketplace del modulo IoT Edge. Il modulo selezionato viene configurato automaticamente per la sottoscrizione, il gruppo di risorse e il dispositivo. Viene quindi visualizzato nell'elenco dei moduli IoT Edge. Alcuni moduli possono richiedere una configurazione aggiuntiva.

Suggerimento

Le informazioni sui moduli IoT Edge del hub IoT di Azure sono limitate. Per altre informazioni sui moduli IoT Edge in Azure Marketplace, vedere prima di tutto.

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