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 megtudhatja, hogyan irányíthatja az Azure Event Grid-névtér által fogadott MQTT-üzeneteket egy Egyéni Event Grid-témakör segítségével egy Azure-függvényhez az alábbi lépések végrehajtásával:

Ha nincs Azure-előfizetése, regisztráljon egy ingyenes próbaverzióra.

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

Feljegyzés

• Hozzon létre minden erőforrást ugyanabban a régióban.
• Ezt az oktatóanyagot egy .NET 8.0 (izolált) futtatókörnyezeti vermet használó Azure-függvényrel 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 a portál használatával. Az Event Grid-témakör létrehozásakor az Eseményséma Speciális lapján válassza a Cloud Event Schema v1.0 lehetőséget.

Feljegyzés

Ebben az oktatóanyagban mindenhol használjon felhőbeli eseménysémát .

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

Ebben a lépésben létrehoz 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 a bal oldali navigációs sávon.

   

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

   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. Pont esetén válassza az Éles elemet.

   5. A függvényhez válassza ki az Azure-függvényt.

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

      

4. Az Esemény-előfizetés létrehozása lapon válassza a Létrehozás lehetőséget.

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ó utasításait: MQTT-üzenetek közzététele és előfizetése Event Grid-névtér használatával az Azure Portallal :

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 korábban létrehozott Event Grid-egyéni témakör küldési engedélyét, hogy az átirányíthassa az üzenetet az egyéni témakörhöz. Ezt úgy teheti meg, 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 a bal oldali navigációs menüben.

   

2. Lépjen az Event Grid egyéni témaköréhez tartozó Event Grid-témakörre .

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, majd a lap alján válassza a Tovább gombot.

   

6. A Szerepkör-hozzárendelés hozzáadása varázsló Tagok lapján 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. 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 Lap alján található Kiválasztás lehetőséget.

      

8. A Szerepkör-hozzárendelés hozzáadása lapon kattintson a Lap alján található Tovább gombra.

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 a lap alján.

Útválasztási üzenetek konfigurálása az Azure-függvényhez egyéni témakör használatával

Ebben a lépésben úgy konfigurálja az Event Grid-névtér útválasztását, 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 a bal oldali navigációs sávon.

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 elemet a lap alján.

   

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 a közzététel utasításait, és iratkozzon fel üzeneteket az MQTTX alkalmazás cikkével, é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

Tekintse meg a GitHub-adattár kódmintáit.