Esercitazione: Trasformare i dati con Azure Stack Edge Pro FPGA per il flusso di distribuzione avanzato

Articolo
06/01/2023

Questa esercitazione descrive come configurare un ruolo di calcolo per un flusso di distribuzione avanzato nel dispositivo FPGA di Azure Stack Edge Pro. Dopo aver configurato il ruolo di calcolo, Azure Stack Edge Pro FPGA può trasformare i dati prima di inviarli ad Azure.

Il calcolo può essere configurato per un flusso di distribuzione semplice o avanzata sul dispositivo.

Criteri	Distribuzione semplice	Distribuzione avanzata
Destinatari	Amministratori IT	Sviluppatori
Type	Usare il servizio Azure Stack Edge per distribuire moduli	Usare il servizio hub IoT per distribuire moduli
Moduli distribuiti	Single	Moduli concatenati o multipli

Il completamento di questa procedura può richiedere circa 20-30 minuti.

In questa esercitazione verranno illustrate le procedure per:

Configurare il calcolo
Aggiungere condivisioni
Aggiungere un trigger
Aggiungere un ruolo di calcolo
Verificare la trasformazione e il trasferimento dei dati

Prerequisiti

Prima di configurare un ruolo di calcolo nel dispositivo FPGA di Azure Stack Edge Pro, assicurarsi che:

È stato attivato il dispositivo FPGA di Azure Stack Edge Pro, come descritto in Connetti, configurare e attivare Azure Stack Edge Pro FPGA.

Configurare il calcolo

Per configurare il calcolo in Azure Stack Edge Pro FPGA, si creerà una risorsa hub IoT.

Nel portale di Azure della risorsa Azure Stack Edge passare a Panoramica. Nel riquadro destro selezionare il riquadro IoT Edge.
Nel riquadro Abilita servizio IoT Edge selezionare Aggiungi. Viene abilitato il servizio IoT Edge, che consente di distribuire i moduli IoT Edge in locale nel dispositivo.

In Crea servizio IoT Edge immettere quanto segue:

Campo	Valore
Subscription	Selezionare una sottoscrizione per la risorsa hub IoT. È possibile selezionare la stessa sottoscrizione usata dalla risorsa Azure Stack Edge.
Gruppo di risorse	Immettere un nome per il gruppo di risorse della risorsa hub IoT. È possibile selezionare lo stesso gruppo di risorse usato dalla risorsa Azure Stack Edge.
Hub IoT	Scegliere Nuovo o Esistente. Per impostazione predefinita, per creare una risorsa IoT viene usato un livello Standard (S1). Per usare una risorsa IoT di un livello gratuito, crearne uno e quindi selezionare la risorsa esistente.
Nome	Accettare il nome predefinito o immetterne un altro per la risorsa hub IoT.

Introduzione al calcolo 3

Selezionare Rivedi e crea. La creazione della risorsa hub IoT richiede qualche minuto. Una volta creata la risorsa hub IoT, la pagina Panoramica viene aggiornata per indicare che il servizio IoT Edge è in esecuzione.

Quando il servizio IoT Edge è configurato nel dispositivo Edge, crea due dispositivi: un dispositivo IoT e un dispositivo IoT Edge. Entrambi i dispositivi possono essere visualizzati nella risorsa dell'hub IoT. Nel dispositivo IoT Edge viene eseguito anche un runtime IoT Edge. Attualmente per il dispositivo IoT Edge è disponibile solo la piattaforma Linux.

Per verificare che sia stato configurato il ruolo di calcolo Edge, selezionare IoT Edge proprietà del servizio > e visualizzare il dispositivo IoT e il dispositivo IoT Edge.

Aggiungere condivisioni

Per la distribuzione avanzata di questa esercitazione, saranno necessarie due condivisioni: una condivisione Edge e un'altra condivisione locale Edge.

Aggiungere una condivisione Edge nel dispositivo seguendo questa procedura:
1. Nella risorsa Azure Stack Edge passare a IoT Edge > Condivisioni.
2. Sulla barra dei comandi della pagina Condivisioni selezionare + Aggiungi condivisione.
3. Nel pannello Aggiungi condivisione specificare il nome della condivisione e selezionarne il tipo.
4. Per montare la condivisione Edge, selezionare la casella di controllo Usa la condivisione con il calcolo Edge.
5. Selezionare Account di archiviazione, Servizio di archiviazione, un utente esistente e quindi Crea.
Dopo la creazione della condivisione Edge, si riceverà una notifica di creazione riuscita. L'elenco condivisione viene aggiornato per riflettere la nuova condivisione.
Aggiungere una condivisione locale Edge nel dispositivo Edge ripetendo tutti i passaggi della procedura precedente e selezionando la casella di controllo Configura come condivisione locale Edge. I dati nella condivisione locale rimangono nel dispositivo.
Nel pannello Condivisioni viene visualizzato l'elenco aggiornato delle condivisioni.
Per visualizzare le proprietà della nuova condivisione locale creata, selezionarla dall'elenco. Nella casella Punto di montaggio locale per i moduli di calcolo Edge copiare il valore corrispondente a questa condivisione.

Questo punto di montaggio locale verrà usato durante la distribuzione del modulo.
Per visualizzare le proprietà della condivisione Edge creata, selezionarla dall'elenco. Nella casella Punto di montaggio locale per i moduli di calcolo Edge copiare il valore corrispondente a questa condivisione.

Questo punto di montaggio locale verrà usato durante la distribuzione del modulo.

Aggiungere un trigger

Passare alla risorsa Azure Stack Edge e quindi passare a trigger IoT Edge>. Selezionare + Aggiungi trigger.

Nel pannello Aggiungi trigger immettere i valori seguenti.

Campo	valore
Nome trigger	Nome univoco per il trigger.
Tipo di trigger	Selezionare il trigger di File. Un trigger di file viene attivato ogni volta che si verifica un evento file, ad esempio la scrittura di un file nella condivisione di input. Un trigger pianificato invece, viene attivato in base a una pianificazione definita dall'utente. Per questo esempio è necessario un trigger di file.
Condivisione di input	Selezionare una condivisione di input. In questo caso, la condivisione di input è la condivisione locale Edge. Il modulo usato in questo esempio sposta i file dalla condivisione locale Edge a una condivisione Edge in cui vengono caricati nel cloud.

Aggiunta di trigger 2

L'utente riceverà una notifica al termine della creazione del trigger. L'elenco dei trigger viene aggiornato per visualizzare il trigger appena creato. Selezionare il trigger appena creato.
Copiare e salvare la route di esempio. Si modificherà e si userà questa route di esempio in un secondo momento nell'hub IoT.

"sampleroute": "FROM /* WHERE topic = 'mydbesmbedgelocalshare1' INTO BrokeredEndpoint(\"/modules/modulename/inputs/input1\")"

Aggiungere un modulo

In questo dispositivo Edge non sono presenti moduli personalizzati. È possibile aggiungere un modulo personalizzato o predefinito. Per informazioni su come creare un modulo personalizzato, vedere Sviluppare un modulo C# per il dispositivo Azure Stack Edge Pro FPGA.

In questa sezione viene aggiunto un modulo personalizzato al dispositivo IoT Edge creato in Sviluppare un modulo C# per azure Stack Edge Pro FPGA. Questo modulo personalizzato sposta i file da una condivisione locale Edge nel dispositivo Edge a una condivisione cloud Edge nel dispositivo. La condivisione cloud esegue quindi il push dei file all'account di archiviazione di Azure associato.

Passare alla risorsa Azure Stack Edge e quindi a IoT Edge > Panoramica. Nel riquadro Moduli selezionare Passa all'hub IoT di Azure.

Nella risorsa hub IoT passare a Dispositivo IoT Edge e selezionare il dispositivo IoT Edge.
In Dettagli dispositivo, selezionare Imposta i moduli.

In Aggiungi moduli eseguire queste operazioni:

Immettere il nome, l'indirizzo, il nome utente e la password per le impostazioni del registro contenitori per il modulo personalizzato. Il nome, l'indirizzo e le credenziali elencate vengono usati per recuperare i moduli con un URL corrispondente. Per distribuire questo modulo, in Moduli di distribuzione, selezionare Modulo IoT Edge. Questo modulo IoT Edge è un contenitore Docker che è possibile distribuire nel dispositivo IoT Edge associato al dispositivo Azure Stack Edge Pro FPGA.

Specificare le impostazioni per il modulo personalizzato IoT Edge. Immettere i valori seguenti.

Campo	Valore
Nome	Nome univoco per il modulo. Questo modulo è un contenitore Docker che è possibile distribuire nel dispositivo IoT Edge associato all'FPGA di Azure Stack Edge Pro.
URI immagine	URI dell'immagine del contenitore corrispondente per il modulo.
Sono richieste credenziali	Se questa opzione è selezionata, per recuperare i moduli con un URL corrispondente vengono usati un nome utente e una password.

Nella casella Opzioni di creazione del contenitore immettere i punti di montaggio locali per i moduli Edge copiati nei passaggi precedenti per la condivisione Edge e per la condivisione locale Edge.

Importante

I percorsi usati qui sono montati nel contenitore, quindi devono corrispondere a ciò che la funzionalità nel contenitore si aspetta. Se si sta seguendo Create a custom module (Creare un modulo personalizzato), il codice specificato in tale modulo si aspetta i percorsi copiati. Non modificare questi percorsi.

Nella casella Opzioni di creazione del contenitore è possibile incollare l'esempio seguente:

{
  "HostConfig": 
  {
   "Binds": 
    [
     "/home/hcsshares/mydbesmbedgelocalshare1:/home/input",
     "/home/hcsshares/mydbesmbedgeshare1:/home/output"
    ]
   }
}

Specificare eventuali variabili di ambiente usate per il modulo. Le variabili di ambiente offrono informazioni utili per definire l'ambiente in cui il modulo viene eseguito.

Casella Opzioni di creazione del contenitore

Se necessario, configurare le impostazioni avanzate del runtime di Edge e quindi fare clic su Avanti.

In Specifica route impostare le route tra i moduli.

È possibile sostituire route con questa stringa di route copiata in precedenza. In questo esempio immettere il nome della condivisione locale che eseguirà il push dei dati nella condivisione cloud. Sostituire modulename con il nome del modulo. Selezionare Avanti.
```
"route": "FROM /* WHERE topic = 'mydbesmbedgelocalshare1' INTO BrokeredEndpoint(\"/modules/filemove/inputs/input1\")"
```
In Rivedi distribuzione controllare tutte le impostazioni e quindi selezionare Invia per inviare il modulo per la distribuzione.

Questa azione avvia la distribuzione del modulo. Al termine della distribuzione, lo Stato di runtime del modulo risulta in esecuzione.

Verificare la trasformazione, il trasferimento dei dati

Il passaggio finale consiste nell'assicurarsi che il modulo sia connesso e in esecuzione come previsto. Lo stato di runtime del modulo deve essere In esecuzione per il dispositivo IoT Edge nella risorsa dell'hub IoT.

Eseguire i passaggi seguenti per verificare la trasformazione e il trasferimento dei dati ad Azure.

In Esplora file connettersi alla condivisione locale Edge e alla condivisione Edge create in precedenza.
Aggiungere i dati alla condivisione locale.

I dati vengono spostati nella condivisione cloud.

Viene quindi eseguito il push dei dati dalla condivisione cloud all'account di archiviazione. Per visualizzare i dati, passare all'account di archiviazione e quindi selezionare Azure Storage Explorer. È possibile visualizzare i dati caricati nell'account di archiviazione.