Esercitazione: Indirizzare i messaggi MQTT in Griglia di eventi di Azure a Funzioni di Azure usando argomenti personalizzati - portale di Azure
Questa esercitazione illustra come instradare i messaggi MQTT ricevuti da uno spazio dei nomi Griglia di eventi di Azure a una funzione di Azure tramite un argomento personalizzato di Griglia di eventi seguendo questa procedura:
Se non si ha una sottoscrizione di Azure, è possibile iscriversi per ottenere una versione di valutazione gratuita.
Seguire le istruzioni riportate in Creare una funzione di Azure con Visual Studio Code, ma usare il trigger Griglia di eventi di Azure invece di usare il trigger HTTP. Il codice dovrebbe essere simile all'esempio seguente:
using System;
using Azure.Messaging;
using Microsoft.Azure.Functions.Worker;
using Microsoft.Extensions.Logging;
namespace Company.Function
{
public class MyEventGridTriggerFunc
{
private readonly ILogger<MyEventGridTriggerFunc> _logger;
public MyEventGridTriggerFunc(ILogger<MyEventGridTriggerFunc> logger)
{
_logger = logger;
}
[Function(nameof(MyEventGridTriggerFunc))]
public void Run([EventGridTrigger] CloudEvent cloudEvent)
{
_logger.LogInformation("Event type: {type}, Event subject: {subject}", cloudEvent.Type, cloudEvent.Subject);
}
}
}
Questa funzione di Azure viene usata come gestore eventi per la sottoscrizione di un argomento più avanti in questa esercitazione.
Nota
- Creare tutte le risorse nella stessa area.
- Questa esercitazione è stata testata con una funzione di Azure che usa lo stack di runtime .NET 8.0 (isolato).
Creare un argomento di Griglia di eventi. Vedere Creare un argomento personalizzato usando il portale. Quando si crea l'argomento griglia di eventi, nella scheda Avanzate selezionare Schema eventi cloud v1.0 per Schema eventi cloud.
Nota
Usare lo schema di eventi cloud ovunque in questa esercitazione.
In questo passaggio si crea una sottoscrizione all'argomento griglia di eventi usando la funzione di Azure creata in precedenza.
Nella pagina dell'argomento di Griglia di eventi selezionare Sottoscrizioni sulla barra di spostamento a sinistra.
Nella pagina Crea sottoscrizione di eventi seguire questa procedura:
Nella pagina Selezione funzione di Azure seguire questa procedura:
Per Sottoscrizione selezionare la sottoscrizione di Azure.
Per Gruppo di risorse selezionare il gruppo di risorse con la funzione di Azure.
Per App per le funzioni selezionare l'app Funzioni con la funzione .
Per Slot selezionare Produzione.
Per Funzione selezionare la funzione di Azure.
Selezionare quindi Conferma selezione nella parte inferiore della pagina.
Nella pagina Crea sottoscrizione di eventi selezionare Crea.
Nella pagina Sottoscrizioni eventi dovrebbe essere visualizzata la sottoscrizione creata.
Seguire le istruzioni riportate in Avvio rapido: Pubblicare e sottoscrivere messaggi MQTT usando uno spazio dei nomi di Griglia di eventi con portale di Azure per:
- Creare uno spazio dei nomi di Griglia di eventi.
- Creare due client.
- Creare uno spazio degli argomenti.
- Creare associazioni di autorizzazioni per server di pubblicazione e sottoscrittore.
- Testare l'uso dell'app MQTTX per verificare che i client siano in grado di inviare e ricevere messaggi.
In questa sezione viene abilitata l'identità gestita assegnata dal sistema per lo spazio dei nomi di Griglia di eventi. Concedere quindi all'identità l'autorizzazione di invio all'argomento personalizzato di Griglia di eventi creato in precedenza in modo che possa instradare il messaggio all'argomento personalizzato. A tale scopo, aggiungere l'identità gestita al ruolo Mittente dati di Griglia di eventi nell'argomento personalizzato.
Nella pagina Spazio dei nomi di Griglia di eventi selezionare Identità nel menu di spostamento a sinistra.
Passare all'argomento griglia di eventi per l'argomento personalizzato di Griglia di eventi.
Selezionare Controllo di accesso sulla barra di spostamento a sinistra.
Nella pagina Controllo di accesso selezionare Aggiungi e quindi Aggiungi assegnazione di ruolo.
Nella pagina Ruolo della procedura guidata Aggiungi assegnazione di ruolo selezionare Ruolo Mittente dati griglia di eventi e selezionare Avanti nella parte inferiore della pagina.
Nella pagina Membri della procedura guidata Aggiungi assegnazione di ruolo selezionare Identità gestita e quindi selezionare Seleziona membri.
Nella pagina Selezione identità gestite seguire questa procedura:
Nella pagina Aggiungi assegnazione di ruolo selezionare Avanti nella parte inferiore della pagina.
Nella pagina Rivedi e assegna rivedere le impostazioni e quindi selezionare Rivedi e assegna nella parte inferiore della pagina.
In questo passaggio viene configurato il routing per lo spazio dei nomi di Griglia di eventi in modo che i messaggi ricevuti vengano indirizzati all'argomento personalizzato creato.
Nella pagina Spazio dei nomi di Griglia di eventi selezionare Routing sulla barra di spostamento a sinistra.
Nella pagina Routing selezionare Abilita routing.
In Tipo di argomento selezionare Argomento personalizzato.
Per Argomento selezionare l'argomento personalizzato creato per questa esercitazione.
Per Identità gestita per il recapito selezionare Assegnata dal sistema.
Selezionare Applica nella parte inferiore della pagina.
Inviare messaggi MQTT di test allo spazio dei nomi e verificare che la funzione li riceva.
Seguire le istruzioni dell'articolo Pubblicare, sottoscrivere messaggi usando l'app MQTTX per inviare alcuni messaggi di test allo spazio dei nomi di Griglia di eventi.
Ecco il flusso degli eventi o dei messaggi:
MQTTX invia messaggi allo spazio degli argomenti dello spazio dei nomi di Griglia di eventi.
I messaggi vengono indirizzati all'argomento personalizzato configurato.
I messaggi vengono inoltrati alla sottoscrizione di eventi, ovvero la funzione di Azure.
Usare la funzionalità di registrazione per verificare che la funzione abbia ricevuto l'evento.
Vedere gli esempi di codice in questo repository GitHub.