Sviluppare moduli di IoT Edge personalizzati

Si applica a: IoT Edge 1.5 IoT Edge 1.4

I moduli di IoT Edge di Azure possono connettersi con altri servizi di Azure e contribuire alla pipeline di dati cloud più estesa. Questo articolo descrive come sviluppare i moduli per comunicare con il runtime di IoT Edge e l'hub IoT e di conseguenza il resto del cloud di Azure.

Ambiente di runtime di IoT Edge

Il runtime di IoT Edge offre l'infrastruttura per integrare le funzionalità di più moduli di IoT Edge e distribuirle nei dispositivi IoT Edge. Qualsiasi programma può essere inserito in un pacchetto come modulo IoT Edge. Per sfruttare appieno le funzionalità di comunicazione e gestione di IoT Edge, un programma in esecuzione in un modulo può usare Azure IoT Device SDK per connettersi all'hub IoT Edge locale.

Creazione del pacchetto del programma come modulo IoT Edge

Per distribuire il programma in un dispositivo IoT Edge, è necessario prima di tutto essere in contenitori ed eseguirlo con un motore compatibile con Docker. IoT Edge usa Moby, il progetto open source dietro Docker, come motore compatibile con Docker. Gli stessi parametri usati con Docker possono essere passati ai moduli IoT Edge. Per altre informazioni, vedere Come configurare le opzioni di creazione di contenitori per i moduli IoT Edge.

Tramite l'hub di IoT Edge

L'hub IoT Edge offre due funzionalità principali: un proxy per hub IoT e comunicazioni locali.

Connessione all'hub di IoT Edge da un modulo

La connessione all'hub IoT Edge locale da un modulo prevede gli stessi passaggi di connessione per tutti i client. Per altre informazioni, vedere Connessione all'hub IoT Edge.

Per usare il routing di IoT Edge su AMQP, è possibile usare ModuleClient da Azure IoT SDK. Creare un'istanza di ModuleClient per connettere il modulo all'hub IoT Edge in esecuzione nel dispositivo, nello stesso modo in cui le istanze di DeviceClient connettono i dispositivi IoT all'hub IoT. Per altre informazioni sulla classe ModuleClient e sui relativi metodi di comunicazione, vedere le informazioni di riferimento sulle API per il linguaggio SDK preferito: C#, C, Python, Java o Node.js.

Primitive di hub IoT

hub IoT vede un'istanza del modulo come simile a un dispositivo. Un'istanza del modulo può:

• Inviare messaggi da dispositivo a cloud
• Ricevere metodi diretti destinati specificamente alla propria identità
• Disporre di un modulo gemello distinto e isolato dal dispositivo gemello e dagli altri moduli gemelli del dispositivo

Attualmente, i moduli non possono ricevere messaggi da cloud a dispositivo o usare la funzionalità di caricamento file.

Quando si scrive un modulo, è possibile connettersi all'hub di IoT Edge e usare le primitive dell'hub IoT come si farebbe quando si usa l'hub IoT con un'applicazione del dispositivo. L'unica differenza tra i moduli IoT Edge e le applicazioni per dispositivi IoT è che con i moduli è necessario fare riferimento all'identità del modulo anziché all'identità del dispositivo.

Messaggi da dispositivo a cloud

Un modulo IoT Edge può inviare messaggi al cloud tramite l'hub di IoT Edge che funge da broker locale e propaga i messaggi al cloud. Per abilitare l'elaborazione complessa dei messaggi da dispositivo a cloud, un modulo IoT Edge può intercettare ed elaborare i messaggi inviati da altri moduli o dispositivi all'hub IoT Edge locale. Il modulo IoT Edge invierà quindi nuovi messaggi con dati elaborati. È quindi possibile creare catene di moduli IoT Edge per creare pipeline di elaborazione locali.

Per inviare messaggi di telemetria da dispositivo a cloud tramite route:

• Usare la classe Module Client di Azure IoT SDK. Ogni modulo ha endpoint di input e output .
• Usare un metodo send message dalla classe Module Client per inviare messaggi nell'endpoint di output del modulo.
• Configurare una route nel modulo edgeHub del dispositivo per inviare questo endpoint di output a hub IoT.

Per elaborare i messaggi usando route:

• Configurare una route per inviare messaggi provenienti da un altro endpoint (modulo o dispositivo) all'endpoint di input del modulo.
• Ascoltare i messaggi nell'endpoint di input del modulo. Ogni volta che viene restituito un nuovo messaggio, viene attivata una funzione di callback da Azure IoT SDK.
• Elaborare il messaggio con questa funzione di callback e(facoltativamente) inviare nuovi messaggi nella coda dell'endpoint del modulo.

Elementi gemelli

I gemelli sono una delle primitive fornite dall'hub IoT. Sono disponibili documenti JSON che archiviano informazioni sullo stato, tra cui metadati, configurazioni e condizioni. Ogni modulo o dispositivo ha il proprio gemello.

• Per ottenere un modulo gemello con Azure IoT SDK, chiamare il ModuleClient.getTwin metodo .

• Per ricevere una patch del modulo gemello con Azure IoT SDK, implementare una funzione di callback e registrarla con il ModuleClient.moduleTwinCallback metodo da Azure IoT SDK in modo che la funzione di callback venga attivata ogni volta che viene fornita una patch gemella.

Ricevere metodi diretti

Per ricevere un metodo diretto con Azure IoT SDK, implementare una funzione di callback e registrarla con il ModuleClient.methodCallback metodo da Azure IoT SDK in modo che la funzione di callback venga attivata ogni volta che viene fornito un metodo diretto.

Supporto del linguaggio e dell'architettura

IoT Edge supporta più sistemi operativi, architetture di dispositivi e linguaggi di sviluppo, in modo da poter creare lo scenario che soddisfa le proprie esigenze. Usare questa sezione per comprendere le opzioni per lo sviluppo di moduli IoT Edge personalizzati. Per altre informazioni sul supporto e sui requisiti degli strumenti per ogni linguaggio, vedere Preparare l'ambiente di sviluppo e test per IoT Edge.

Linux

Per tutti i linguaggi nella tabella seguente, IoT Edge supporta lo sviluppo per i contenitori AMD64 e LA maggior parte dei contenitori LINUX ARM64. È disponibile anche il supporto per i contenitori DEBIAN 11 ARM32.

Windows

I contenitori di Windows non sono più supportati. IoT Edge per Linux in Windows è il modo consigliato per eseguire IoT Edge nei dispositivi Windows.

Sicurezza dei moduli

È consigliabile sviluppare i moduli tenendo presente la sicurezza. Per altre informazioni sulla protezione dei moduli, vedere Sicurezza di Docker.

Per migliorare la sicurezza dei moduli, IoT Edge disabilita alcune funzionalità del contenitore per impostazione predefinita. È possibile eseguire l'override delle impostazioni predefinite per fornire funzionalità con privilegi ai moduli, se necessario.

Consenti autorizzazioni Docker elevate

Nel file di configurazione in un dispositivo IoT Edge è presente un parametro denominato allow_elevated_docker_permissions. Se impostato su true, questo flag consente il --privileged flag e le eventuali funzionalità aggiuntive definite nel CapAdd campo di Docker HostConfig nel contenitore di opzioni di creazione.

Abilitare CAP_CHOWN e CAP_SETUID

Le funzionalità di Docker CAP_CHOWN e CAP_SETUID sono disabilitate per impostazione predefinita. Queste funzionalità possono essere usate per scrivere per proteggere i file nel dispositivo host e potenzialmente ottenere l'accesso radice.

Se sono necessarie queste funzionalità, è possibile riabilitarle manualmente usando CapADD nelle opzioni di creazione del contenitore.

Passaggi successivi

Preparare l'ambiente di sviluppo e test per IoT Edge

Sviluppare moduli di Azure IoT Edge con Visual Studio Code

Eseguire il debug dei moduli di Azure IoT Edge con Visual Studio Code

Comprendere e usare gli SDK per l'hub IoT di Azure