Oktatóanyag: MQTT-üzenetek átirányítása az Azure Event Gridben az Azure Functionsbe egyéni témakörök használatával – Azure Portal

Ebben az oktatóanyagban az Azure Event Grid névtérben fogadott MQTT-üzeneteket egy egyéni Event Grid-téma használatával irányíthatja egy Azure-függvényhez.

Ha nem rendelkezik Azure előfizetéssel, ingyenes próbaidőszakra regisztrálhat .

Azure-függvény létrehozása Event Grid-eseményindítóval

Kövesse az Azure-függvény létrehozása a Visual Studio Code használatával című témakör utasításait, de a HTTP-eseményindító helyett használja az Azure Event Grid-eseményindítót.

Fontos

Hozzon létre minden erőforrást ugyanabban a régióban.

A következő példához hasonló kódnak kell megjelennie:

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);
        }
    }
}

Ezt az Azure-függvényt az oktatóanyag későbbi részében eseménykezelőként használhatja egy témakör előfizetéséhez.

Megjegyzés:

Ezt az oktatóanyagot egy .NET 8.0 (izolált) futtatókörnyezetet használó Azure-függvénnyel teszteltük.

Event Grid-témakör létrehozása (egyéni témakör)

Event Grid-témakör létrehozása. Lásd : Egyéni témakör létrehozása az Azure Portal használatával. Az Event Grid-témakör létrehozásakor az EseménysémaSpeciális lapján válassza a Cloud Event Schema v1.0 lehetőséget.

Megjegyzés:

Ebben az oktatóanyagban mindenhol használhatja a Cloud Event Schema 1.0-s verziót .

Előfizetés hozzáadása a témakörhöz a függvény használatával

Ebben a lépésben hozzon létre egy előfizetést az Event Grid-témakörhöz a korábban létrehozott Azure-függvény használatával.

1. Az Event Grid-témakör lapján válassza az Előfizetések lehetőséget.

   

2. Az Esemény-előfizetés létrehozása lapon hajtsa végre az alábbi lépéseket:

   1. Adja meg az esemény-előfizetés nevét .

   2. Eseményséma esetén válassza a Cloud Event Schema 1.0 lehetőséget.

   3. Végponttípus esetén válassza az Azure Function.

   4. Ezután válassza a Végpont konfigurálása lehetőséget.

      

3. Az Azure-függvény kiválasztása lapon hajtsa végre az alábbi lépéseket:

   1. Előfizetés esetén válassza ki az Azure-előfizetését.

   2. Erőforráscsoport esetén válassza ki az Azure-függvényt tartalmazó erőforráscsoportot.

   3. Függvényalkalmazás esetén válassza ki a függvényt tartalmazó Functions-alkalmazást.

   4. Foglalat esetén válassza a Gyártás lehetőséget.

   5. A Function esetében válassza ki az Azure Functiont.

   6. Ezután válassza a Kijelölés megerősítése lehetőséget.

      

4. Az Esemény-előfizetés létrehozása lapon kattintson a Létrehozásra.

5. Az Esemény-előfizetések lapon meg kell jelennie a létrehozott előfizetésnek.

Névtér, ügyfelek, témakörterek és engedélykötések létrehozása

Kövesse a rövid útmutató: MQTT-üzenetek közzététele és előfizetése az Event Grid névtér használatával az Azure Portal segítségével utasításait:

1. Hozzon létre egy Event Grid-névteret.
2. Hozzon létre két ügyfelet.
3. Hozzon létre egy témakörterületet.
4. Közzétevői és előfizetői engedélykötések létrehozása.
5. Tesztelje az MQTTX-alkalmazással annak ellenőrzésére, hogy az ügyfelek képesek-e üzeneteket küldeni és fogadni.

Felügyelt identitás engedélyezése a névtérhez

Ebben a szakaszban engedélyezi a rendszer által hozzárendelt felügyelt identitást az Event Grid-névtérhez. Ezután adja meg az identitásnak a küldési engedélyt az Event Grid egyéni témájához. Ezután átirányíthatja az üzenetet az egyéni témakörhöz. Ezt úgy engedélyezheti, hogy hozzáadja a felügyelt identitást az egyéni témakör Event Grid-adatküldő szerepköréhez.

1. Az Event Grid Névtér lapján válassza az Identitás lehetőséget. Válassza a Be , majd a Mentés lehetőséget.

   

2. Lépjen az Event Grid egyéni témakörére.

3. A bal oldali navigációs sávon válassza a Hozzáférés-vezérlés lehetőséget.

4. A Hozzáférés-vezérlés lapon válassza a Hozzáadás, majd a Szerepkör-hozzárendelés hozzáadása lehetőséget.

   

5. A Szerepkör-hozzárendelés hozzáadása varázsló Szerepkör lapján válassza az Event Grid-adatküldő szerepkört, és válassza a Tovább lehetőséget.

   

6. A Szerepkör-hozzárendelés hozzáadása lapon a Tagok lapon válassza a Felügyelt identitás lehetőséget, majd válassza a Tagok kijelölése lehetőséget.

   

7. A Felügyelt identitások kiválasztása lapon hajtsa végre az alábbi lépéseket:

   1. Válassza ki az Azure-előfizetését.

   2. A Felügyelt identitás esetén válassza az "Event Grid névtér" lehetőséget.

   3. Válassza ki azt a felügyelt identitást, amelynek neve megegyezik az Event Grid névterével.

   4. Válassza a -t vagy jelölje ki a-et.

      

8. A Szerepkör-hozzárendelés hozzáadása lapon válassza a Tovább gombot.

9. A Véleményezés + hozzárendelés lapon tekintse át a beállításokat, majd válassza a Véleményezés + hozzárendelés lehetőséget.

Útválasztási üzenetek konfigurálása az Azure-függvényhez egyedi témakörön keresztül

Ebben a szakaszban konfigurálja az Event Grid-névtér útválasztását úgy, hogy a kapott üzenetek a létrehozott egyéni témakörhöz legyenek irányítva.

1. Az Event Grid Névtér lapján válassza az Útválasztás lehetőséget.

2. Az Útválasztás lapon válassza az Útválasztás engedélyezése lehetőséget.

3. Témakörtípus esetén válassza az Egyéni témakör lehetőséget.

4. Témakör esetén válassza ki az oktatóanyaghoz létrehozott egyéni témakört.

5. A kézbesítéshez használt felügyelt identitáshoz válassza a Hozzárendelt rendszer lehetőséget.

6. Válassza az Alkalmazás lehetőséget.

   

MQTT-tesztüzenetek küldése az MQTTX használatával

Küldjön teszt MQTT-üzeneteket a névtérbe, és győződjön meg arról, hogy a függvény megkapja őket.

Kövesse az MQTTX-alkalmazással való közzététel és feliratkozás utasításait , és küldjön néhány tesztüzenetet az Event Grid névterébe.

Az események vagy üzenetek folyamata a következő:

1. Az MQTTX üzeneteket küld az Event Grid-névtér témakörterületére.

2. Az üzenetek a konfigurált egyéni témakörhöz lesznek irányítva.

3. Az üzeneteket a rendszer az esemény-előfizetésbe továbbítja, amely az Azure-függvény.

4. A naplózási funkcióval ellenőrizheti, hogy a függvény megkapta-e az eseményt.

   

Következő lépés

Minták az MqttApplicationSamplesben.