Blob storage-események átirányítása webvégpontra (Azure Portal) az Azure Event Grid használatával

  • Cikk

Az Event Grid egy teljes mértékben felügyelt szolgáltatás, amely lehetővé teszi az események egyszerű kezelését számos különböző Azure-szolgáltatásban és alkalmazásban. Leegyszerűsíti az eseményvezérelt és kiszolgáló nélküli alkalmazások létrehozását. A szolgáltatás áttekintését az Event Grid áttekintésében tekintheti meg.

Ebben a cikkben az Azure Portalon hajtja végre a következő feladatokat:

  1. Blob Storage-fiók létrehozása.
  2. Iratkozzon fel az adott blobtároló eseményeire.
  3. Esemény aktiválásához töltsön fel egy fájlt a blobtárolóba.
  4. Az eredmény megtekintése egy kezelő webalkalmazásban. Általában olyan végpontoknak szoktunk eseményeket küldeni, amelyek eseményadatokat dolgoznak fel és műveleteket hajtanak végre. Az egyszerűség érdekében eseményeket küldhet egy webalkalmazásnak, amely összegyűjti és megjeleníti az üzeneteket.

Ha nem rendelkezik Azure-előfizetéssel, első lépésként hozzon létre egy ingyenes Azure-fiókot.

A folyamat végén látni fogja, hogy a rendszer elküldte az eseményadatokat a webalkalmazásnak.

Screenshot that shows the sample Azure Event Grid Viewer app with an event.

Tárfiók létrehozása

  1. Jelentkezzen be az Azure portálra.

  2. Blob Storage létrehozásához kattintson az Erőforrás létrehozása elemre.

  3. A Keresés mezőbe írja be a Storage-fiókot, és válassza a Storage-fiókot a találatok listájából.

    Screenshot showing the search for Storage account on the Create a resource page.

  4. A Tárfiók lapon válassza a Létrehozás lehetőségeta tárfiók létrehozásának megkezdéséhez. Az eseményekre feliratkozáshoz vagy egy általános célú v2 tárfiókot vagy Blob Storage-fiókot hozzon létre.

  5. A Tárfiók létrehozása lapon hajtsa végre a következő lépéseket:

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

    2. Erőforráscsoport esetén hozzon létre egy új erőforráscsoportot, vagy válasszon ki egy meglévőt.

    3. Adja meg a tárfiók nevét.

    4. Válassza ki azt a régiót , amelyben létre szeretné hozni a tárfiókot.

    5. Redundancia esetén válassza a helyileg redundáns tárolást (LRS) a legördülő listából.

    6. Válassza a Lap alján található Véleményezés lehetőséget.

      Screenshot showing the Create a storage account page.

    7. A Véleményezés lapon tekintse át a beállításokat, és válassza a Létrehozás lehetőséget.

      Feljegyzés

      Csak a StorageV2 (általános célú v2) és a BlobStorage típusú tárfiókok támogatják az eseményintegrációt. A Storage (általános célú v1) nemtámogatja az Event Grid-integrációt.

  6. Az üzembe helyezés végrehajtása néhány percet vesz igénybe. Az Üzembe helyezés lapon válassza az Erőforrás megnyitása lehetőséget.

    Screenshot showing the deployment succeeded page with a link to go to the resource.

  7. A Tárfiók lapon válassza az Események lehetőséget a bal oldali menüben.

    Screenshot showing the Events page for an Azure storage account.

  8. Tartsa nyitva ezt a lapot a webböngészőben.

Üzenetvégpont létrehozása

A Blob Storage-eseményekre való feliratkozás előtt hozzuk létre az eseményüzenet végpontját. A végpont általában az eseményadatok alapján hajt végre műveleteket. A rövid útmutató egyszerűsítése érdekében üzembe kell helyeznie egy előre összeállított webalkalmazást , amely megjeleníti az eseményüzeneteket. Az üzembe helyezett megoldás egy App Service-csomagot, egy App Service-webalkalmazást és egy, a GitHubról származó forráskódot tartalmaz.

  1. A megoldásnak az előfizetésébe való telepítéséhez válassza az Üzembe helyezés az Azure-ban lehetőséget.

    Button to deploy the Resource Manager template to Azure.

  2. Az Egyéni üzembe helyezés lapon hajtsa végre a következő lépéseket:

    1. Erőforráscsoport esetén válassza ki a tárfiók létrehozásakor létrehozott erőforráscsoportot. Az oktatóanyag elvégzése után az erőforráscsoport törlésével egyszerűbb lesz a tisztítás.

    2. A Webhely neve mezőben adja meg a webalkalmazás nevét.

    3. Az üzemeltetési csomag neveként adja meg a webalkalmazás üzemeltetéséhez használni kívánt App Service-csomag nevét.

    4. Válassza az Áttekintés + létrehozás lehetőséget.

      Screenshot showing the Custom deployment page.

  3. A Véleményezés + létrehozás lapon válassza a Létrehozás lehetőséget.

  4. Az üzembe helyezés végrehajtása néhány percet vesz igénybe. Az Üzembe helyezés lapon válassza az Ugrás az erőforráscsoportra lehetőséget.

    Screenshot showing the deployment succeeded page with a link to go to the resource group.

  5. Az Erőforráscsoport lapon, az erőforrások listájában válassza ki a létrehozott webalkalmazást. Az App Service-csomag és a tárfiók is megjelenik ebben a listában.

    Screenshot that shows the selection of web app in the resource group.

  6. A webalkalmazás App Service lapján válassza ki a webhelyre navigálni kívánt URL-címet. Az URL-címnek a következő formátumban kell lennie: https://<your-site-name>.azurewebsites.net.

    Screenshot that shows the selection of link to navigate to web app.

  7. Győződjön meg arról, hogy látja a webhelyet, de még nem tettek közzé eseményeket.

    View new site.

    Fontos

    Tartsa nyitva az Azure Event Grid Viewer ablakát, hogy az események megjelenhessenek a közzétételük során.

Az Event Grid-erőforrás-szolgáltató regisztrálása

Ha korábban nem használta az Event Gridet, regisztrálnia kell az Event Grid-erőforrás-szolgáltatót. Ha korábban már használta az Event Gridet, ugorjon a következő szakaszra.

Az Azure Portalon hajtsa végre a következő lépéseket:

  1. A bal oldali menüben válassza az Előfizetések lehetőséget.

  2. Válassza ki az Event Gridhez használni kívánt előfizetést az előfizetési listából.

  3. Az Előfizetés lapon válassza az Erőforrás-szolgáltatóklehetőséget a bal oldali menü Gépház alatt.

  4. Keressen rá a Microsoft.EventGridre, és győződjön meg arról, hogy az állapotnincs regisztrálva.

  5. Válassza a Microsoft.EventGrid elemet a szolgáltatólistában.

  6. Válassza a Regisztráció lehetőséget a parancssávon.

    Image showing the registration of Microsoft.EventGrid provider with the Azure subscription.

  7. Frissítsen, hogy a Microsoft.EventGrid állapota regisztrálva legyen.

    Image showing the successful registration of Microsoft.EventGrid provider with the Azure subscription.

Feliratkozás a Blob Storage-ra

A témakörre való feliratkozással lehet tudatni az Event Griddel, hogy mely eseményeket kívánja nyomon követni, és hová szeretné küldeni az eseményeket.

  1. Ha bezárta a Tárfiók lapot, lépjen a korábban létrehozott Azure Storage-fiókjára. A bal oldali menüben válassza a Minden erőforrás lehetőséget, és válassza ki a tárfiókot.

  2. A Tárfiók lapon válassza az Események lehetőséget a bal oldali menüben.

  3. Válassza a További beállítások, majd a Webhook elemet. Eseményeket küld a megtekintő alkalmazásnak egy webes horog használatával a végponthoz.

    Screenshot showing the selection of Web Hook on the Events page.

  4. Az Esemény-előfizetés létrehozása lapon hajtsa végre a következő lépéseket:

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

    2. Adja meg a rendszertémakör nevét. A rendszertémakörökről a rendszertémakörök áttekintésében olvashat.

      Screenshot showing the Create Event Subscription page with a name for the system topic.

    3. Válassza a Web Hook lehetőséget a végponttípushoz.

      Screenshot showing the Create Event Subscription page with Web Hook selected as an endpoint.

  5. Végpont esetén válassza a Végpont kiválasztása lehetőséget, majd adja meg a webalkalmazás URL-címét, és adja hozzá api/updates a kezdőlap URL-címét (például: https://spegridsite.azurewebsites.net/api/updates), majd válassza a Kijelölés megerősítése lehetőséget.

    Screenshot showing the Select Web Hook page.

  6. Most az Esemény-előfizetés létrehozása lapon válassza a Létrehozás lehetőséget az esemény-előfizetés létrehozásához.

    Screenshot showing the Create Event Subscription page with all fields selected.

  7. Tekints meg újra a webalkalmazást, ahol láthatja, hogy az fogadta az előfizetés érvényesítési eseményét. Az eseményadatok kibontásához kattintson a szem ikonra. Az Event Grid elküldi az érvényesítési eseményt, így a végpont megerősítheti, hogy eseményadatokat akar kapni. A webalkalmazás az előfizetés érvényesítéséhez szükséges kódot tartalmaz.

    Screenshot showing the Event Grid Viewer with the subscription validation event.

Most aktiváljunk egy eseményt, és lássuk, hogyan küldi el az üzenetet az Event Grid a végpontnak.

Esemény elküldése a végpontra

A Blob Storage-hoz egy eseményt egy fájl feltöltésével aktiválhat. A fájlnak nem kell tartalommal rendelkeznie.

  1. Az Azure Portalon lépjen a Blob Storage-fiókjára, és válassza a Tárolók lehetőséget a Let menüben.

  2. Válassza a + Tároló lehetőséget. Adjon nevet a tárolónak, és használjon bármilyen hozzáférési szintet, és válassza a Létrehozás lehetőséget.

    Screenshot showing the New container page.

  3. Válassza ki az új tárolót.

    Screenshot showing the selection of the container.

  4. Fájl feltöltéséhez válassza a Feltöltés lehetőséget. A Blob feltöltése lapon tallózással jelölje ki a teszteléshez feltölteni kívánt fájlt, majd válassza a Feltöltés lehetőséget az adott lapon.

    Screenshot showing Upload blob page.

  5. Keresse meg tallózással a tesztfájlt, és töltse fel.

  6. Ön kiváltotta az eseményt, az Event Grid pedig elküldte az üzenetet a feliratkozáskor konfigurált végpontnak. Az üzenet JSON formátumú, és egy vagy több eseményt tartalmazó tömböt tartalmaz. Az alábbi példában a JSON-üzenet egy egy eseményt tartalmazó tömböt tartalmaz. Tekintse meg a webalkalmazást, és figyelje meg, hogy egy blob által létrehozott esemény érkezett.

    Screenshot showing the Event Grid Viewer page with the Blob Created event.

Az erőforrások eltávolítása

Ha tovább kívánja használni az eseményt, akkor ne törölje a cikkben létrehozott erőforrásokat. Ellenkező esetben törölje a cikkben létrehozott erőforrásokat.

Válassza ki az erőforráscsoportot, majd válassza az Erőforráscsoport törlése elemet.

Következő lépések

Most, hogy megismerte, hogyan hozhat létre egyéni témaköröket és esemény-előfizetéseket, bővebben is tájékozódhat arról, hogy miben nyújthat segítséget az Event Grid: