Använda Azure Event Grid för att dirigera Blob Storage-händelser till webbslutpunkten (Azure-portalen)

Event Grid är en fullständigt hanterad tjänst som gör att du enkelt kan hantera händelser i många olika Azure-tjänster och program. Det förenklar skapandet av händelsedrivna och serverlösa program. En översikt över tjänsten finns i Översikt över Event Grid.

I den här artikeln använder du Azure-portalen för att utföra följande uppgifter:

  1. Skapa ett Blob Storage-konto.
  2. Prenumerera på händelser för bloblagringen.
  3. Utlös en händelse genom att ladda upp en fil till bloblagringen.
  4. Visa resultatet i en hanterarwebbapp. Normalt kan du skicka händelser till en slutpunkt som bearbetar informationen om händelsen och utför åtgärder. För att hålla det enkelt skickar du händelser till en webbapp som samlar in och visar meddelandena.

Om du inte har en Azure-prenumeration skapar du ett kostnadsfritt Azure-konto innan du börjar.

När du är klar kan se du att händelsedata som har skickats till webbappen.

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

Skapa ett lagringskonto

  1. Logga in på Azure-portal.

  2. Om du vill skapa ett Blob Storage-konto väljer du Skapa en resurs.

  3. I Sök anger du Lagringskonto och väljer Lagringskonto i resultatlistan.

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

  4. På sidan Lagringskonto väljer du Skapa för att börja skapa lagringskontot. Skapa ett v2-lagringskonto för allmän användning eller ett Blob Storage-konto om du vill prenumerera på händelser.

  5. Gör följande på sidan Skapa lagringskonto :

    1. Välj din Azure-prenumerationen.

    2. För Resursgrupp skapar du en ny resursgrupp eller väljer en befintlig.

    3. Ange namnet på lagringskontot.

    4. Välj den region där du vill att lagringskontot ska skapas.

    5. För Redundans väljer du Lokalt redundant lagring (LRS) i listrutan.

    6. Välj Granska längst ned på sidan.

      Screenshot showing the Create a storage account page.

    7. På sidan Granska granskar du inställningarna och väljer Skapa.

      Kommentar

      Endast lagringskonton av typen StorageV2 (generell användning v2) och BlobStorage stöder händelseintegrering. Lagring (generell användning v1) stöder inte integrering med Event Grid.

  6. Distributionen tar några minuter att slutföra. På sidan Distribution väljer du Gå till resurs.

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

  7. På sidan Lagringskonto väljer du Händelser på den vänstra menyn.

    Screenshot showing the Events page for an Azure storage account.

  8. Håll den här sidan öppen i webbläsaren.

Skapa en slutpunkt för meddelanden

Innan du prenumererar på händelserna för Blob Storage-kontot ska vi skapa slutpunkten för händelsemeddelandet. Slutpunkten utför vanligtvis åtgärder baserat på informationen om händelsen. För att förenkla den här snabbstarten distribuerar du en fördefinierad webbapp som visar händelsemeddelandena. Den distribuerade lösningen innehåller en App Service-plan,en webbapp för App Service och källkod från GitHub.

  1. Välj Deploy to Azure (Distribuera till Azure) för att distribuera lösningen till din prenumeration.

    Button to deploy to Azure.

  2. Gör följande på sidan Anpassad distribution :

    1. För Resursgrupp väljer du den resursgrupp som du skapade när du skapade lagringskontot. Det blir enklare för dig att rensa när du är klar med självstudien genom att ta bort resursgruppen.

    2. För Webbplatsnamn anger du ett namn för webbappen.

    3. Som Värdplansnamn anger du ett namn för App Service-planen som ska användas som värd för webbappen.

    4. Välj Granska + skapa.

      Screenshot showing the Custom deployment page.

  3. På sidan Granska + skapa väljer du Skapa.

  4. Distributionen tar några minuter att slutföra. På sidan Distribution väljer du Gå till resursgrupp.

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

  5. På sidan Resursgrupp går du till listan över resurser och väljer den webbapp som du skapade. Du ser även App Service-planen och lagringskontot i den här listan.

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

  6. På App Service-sidan för din webbapp väljer du URL:en för att navigera till webbplatsen. URL:en ska vara i det här formatet: https://<your-site-name>.azurewebsites.net.

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

  7. Bekräfta att du ser webbplatsen men att inga händelser har publicerats än.

    View new site.

    Viktigt!

    Håll Fönstret Azure Event Grid Viewer öppet så att du kan se händelser när de publiceras.

Registrera Event Grid-resursprovidern

Om du inte har använt Event Grid tidigare måste du registrera Event Grid-resursprovidern. Om du har använt Event Grid tidigare går du vidare till nästa avsnitt.

Gör följande i Azure-portalen:

  1. Välj Prenumerationer på den vänstra menyn.

  2. Välj den prenumeration som du vill använda för Event Grid i prenumerationslistan.

  3. På sidan Prenumeration väljer du Resursprovidrar under Inställningar på den vänstra menyn.

  4. Sök efter Microsoft.EventGrid och bekräfta att statusen inte är registrerad.

  5. Välj Microsoft.EventGrid i providerlistan.

  6. Välj Registrera i kommandofältet.

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

  7. Uppdatera för att kontrollera att statusen för Microsoft.EventGrid har ändrats till Registrerad.

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

Prenumerera på Blob Storage

Du prenumererar på ett ämne därför att du vill ange för Event Grid vilka händelser du vill följa och vart du vill skicka händelserna.

  1. Om du stängde sidan Lagringskonto går du till ditt Azure Storage-konto som du skapade tidigare. Välj Alla resurser på den vänstra menyn och välj ditt lagringskonto.

  2. På sidan Lagringskonto väljer du Händelser på den vänstra menyn.

  3. Välj Fler alternativ och Webhook. Du skickar händelser till visningsappen med hjälp av en webbkrok för slutpunkten.

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

  4. Gör följande på sidan Skapa händelseprenumeration :

    1. Ange ett namn för händelseprenumerationen.

    2. Ange ett namn för systemämnet. Mer information om systemämnen finns i Översikt över systemämnen.

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

    3. Välj Web Hook för Slutpunktstyp.

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

  5. För Slutpunkt väljer du Välj en slutpunkt, anger webbadressen till webbappen och lägger till api/updates webbadressen till startsidan (till exempel: https://spegridsite.azurewebsites.net/api/updates) och väljer sedan Bekräfta markering.

    Screenshot showing the Select Web Hook page.

  6. På sidan Skapa händelseprenumeration väljer du Skapa för att skapa händelseprenumerationen.

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

  7. Visa ditt webbprogram igen och observera att en händelse för verifieringen av prenumerationen har skickats till den. Välj ögonikonen för att utöka informationen om händelsen. Händelserutnätet skickar valideringshändelsen så att slutpunkten kan bekräfta att den vill ta emot händelsedata. Webbappen inkluderar kod för att verifiera prenumerationen.

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

Nu ska vi utlösa en händelse och se hur Event Grid distribuerar meddelandet till slutpunkten.

Skicka en händelse till din slutpunkt

Du kan utlösa en händelse för Blob Storage-kontot genom att ladda upp en fil. Filen behöver inte innehålla något specifikt.

  1. I Azure-portalen går du till ditt Blob Storage-konto och väljer Containrar på let-menyn.

  2. Välj + Container. Ge containern ett namn och använd valfri åtkomstnivå och välj Skapa.

    Screenshot showing the New container page.

  3. Välj din nya container.

    Screenshot showing the selection of the container.

  4. Välj Ladda upp för att ladda upp en fil. På sidan Ladda upp blob bläddrar du och väljer en fil som du vill ladda upp för testning och väljer sedan Ladda upp på den sidan.

    Screenshot showing Upload blob page.

  5. Bläddra till testfilen och ladda upp den.

  6. Du har utlöst händelsen och Event Grid skickade meddelandet till den slutpunkt som du konfigurerade när du prenumererade. Meddelandet är i JSON-format och innehåller en matris med en eller flera händelser. I följande exempel innehåller JSON-meddelandet en matris med en händelse. Visa webbappen och observera att en blob skapad händelse togs emot.

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

Rensa resurser

Om du planerar att fortsätta arbeta med den här händelsen ska du inte rensa upp bland de resurser som skapades i den här artikeln. I annat fall tar du bort alla resurser som du har skapat i den här artikeln.

Välj resursgruppen och sedan Ta bort resursgrupp.

Nästa steg

Nu när du vet hur du skapar anpassade ämnen och prenumerationer på händelser kan du läsa mer om vad Event Grid kan hjälpa dig med: