Snabbstart: Dirigera Azure Cache for Redis händelser till webbslutpunkten med Azure Portal

Azure Event Grid är en händelsetjänst för molnet. I den här snabbstarten använder du Azure Portal för att skapa en Azure Cache for Redis-instans, prenumerera på händelser för den instansen, utlösa en händelse och visa resultatet. Normalt kan du skicka händelser till en slutpunkt som bearbetar informationen om händelsen och utför åtgärder. Men för att förenkla den här snabbstarten skickar du händelser till en webbapp som samlar in och visar meddelandena.

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

När du är klar ser du att händelsedata har skickats till webbappen.

Azure Event Grid Viewer scaling in JSON format.

Skapa en Azure Cache for Redis cacheinstans

  1. Om du vill skapa en cache loggar du in på Azure Portal och väljer Skapa en resurs.

    Create a resource is highlighted in the left navigation pane.

  2. På sidan Nytt väljer du Databaser och sedan Azure Cache for Redis.

    On New, Databases is highlighted, and Azure Cache for Redis is highlighted.

  3. På sidan Ny Redis Cache konfigurerar du inställningarna för din nya cache.

    Inställning Välj ett värde Beskrivning
    Prenumeration Välj din prenumeration i listrutan. Prenumerationen som den nya Azure Cache for Redis-instansen ska skapas under.
    Resursgrupp Välj en resursgrupp i listrutan eller välj Skapa ny och ange ett nytt resursgruppsnamn. Namn på resursgruppen där du vill skapa cacheminnet och andra resurser. Genom att placera alla dina appresurser i en resursgrupp kan du enkelt hantera eller ta bort dem tillsammans.
    DNS-namn Ange ett unikt namn. Cachenamnet måste vara en sträng mellan 1 och 63 tecken som endast innehåller siffror, bokstäver eller bindestreck. Namnet måste börja och sluta med en siffra eller bokstav och får inte innehålla bindestreck i följd. Cacheinstansens värdnamn är <DNS-namn.redis.cache.windows.net>.
    Plats Välj en plats i listrutan. Välj en region nära andra tjänster som ska använda din cache.
    Cachetyp Listrutan och välj en nivå. Nivån avgör storlek, prestanda och funktioner som är tillgängliga för cachen. Mer information finns i Översikt över Azure Cache for Redis.
  4. Välj fliken Nätverk eller välj knappen Nätverk längst ned på sidan.

  5. På fliken Nätverk väljer du din anslutningsmetod.

  6. Välj fliken Nästa: Avancerat eller välj knappen Nästa: Avancerat längst ned på sidan.

  7. På fliken Avancerat för en grundläggande cacheinstans eller standardcacheinstans väljer du växlingsknappen Aktivera om du vill aktivera en icke-TLS-port. Du kan också välja vilken Redis-version du vill använda, antingen 4 eller 6.

    Redis version 4 or 6.

  8. På fliken Avancerat för premiumcacheinstansen konfigurerar du inställningarna för icke-TLS-port, klustring och datapersistence. Du kan också välja vilken Redis-version du vill använda, antingen 4 eller 6.

  9. Välj fliken Nästa: Taggar eller välj knappen Nästa: Taggar längst ned på sidan.

  10. Du kan också ange namn och värde på fliken Taggar om du vill kategorisera resursen.

  11. Välj Granska + skapa. Du kommer till fliken Granska + skapa där Azure verifierar din konfiguration.

  12. När det gröna verifieringsmeddelandet har skickats visas väljer du Skapa.

Det tar en stund innan cacheminnet skapas. Du kan övervaka förloppet på Azure Cache for Redis översiktssidan. När Status visas som Körs är cachen redo att användas.

Skapa en slutpunkt för meddelanden

Innan vi prenumererar på händelserna för cacheinstansen 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 Distribuera till Azure i GitHub README för att distribuera lösningen till din prenumeration.

Deploy to Azure button.

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

    1. För Resursgrupp väljer du den resursgrupp som du skapade när du skapade cacheinstansen. Det blir enklare för dig att rensa efter att 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 på den App Service plan som ska användas som värd för webbappen.
    4. Markera kryssrutan för Jag godkänner de villkor som anges ovan.
    5. Välj Köp.
    Inställning Föreslaget värde Beskrivning
    Prenumeration Välj din prenumeration i listrutan. Prenumerationen under vilken du vill skapa den här webbappen.
    Resursgrupp Välj en resursgrupp i listrutan eller välj Skapa ny och ange ett nytt resursgruppsnamn. Genom att placera alla dina appresurser i en resursgrupp kan du enkelt hantera eller ta bort dem tillsammans.
    Webbplatsnamn Ange ett namn för webbappen. Det här värdet får inte vara tomt.
    Namn på värdplan Ange ett namn på den App Service plan som ska användas som värd för webbappen. Det här värdet får inte vara tomt.
  2. Välj Aviseringar (klockikon) i portalen och välj sedan Gå till resursgrupp.

    Azure portal deployment notification.

  3. 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 cacheinstansen i den här listan.

  4. sidan App Service för webbappen väljer du url:en för att navigera till webbplatsen. URL:en ska ha följande format: https://<your-site-name>.azurewebsites.net.

  5. Bekräfta att du ser webbplatsen men att inga händelser har publicerats till den ännu.

    Empty Event Grid Viewer site.

Aktivera Event Grid-resursprovider

Om du inte har använt Event Grid förut i din Azure-prenumeration kan du behöva registrera Event Grid-resursprovidern.

I Azure-portalen:

  1. Välj Prenumerationer på den vänstra menyn.
  2. Välj den prenumeration som du använder för Event Grid.
  3. På menyn till vänster går du till Inställningar och väljer Resursprovidrar.
  4. Hitta Microsoft.EventGrid.
  5. Om den inte är registrerad väljer du Registrera.

Det kan ta en stund att slutföra registreringen. Välj Uppdatera för att uppdatera statusen. När Status är Registrerad är du redo att fortsätta.

Prenumerera på Azure Cache for Redis-instansen

I det här steget prenumererar du på ett ämne för att berätta för Event Grid vilka händelser du vill spåra och var händelserna ska skickas.

  1. I portalen navigerar du till din cacheinstans som du skapade tidigare.

  2. På sidan Azure Cache for Redis väljer du Händelser på den vänstra menyn.

  3. Välj Web Hook. Du skickar händelser till visningsappen med hjälp av en webbkrok för slutpunkten.

    Azure portal Events page.

  4. På sidan Skapa händelseprenumeration anger du följande:

    Inställning Föreslaget värde Beskrivning
    Namn Ange ett namn för händelseprenumerationen. Värdet måste vara mellan 3 och 64 tecken långt. Den kan bara innehålla bokstäver, siffror och bindestreck.
    Händelsetyper Listrutan och välj vilka händelsetyper du vill push-överföras till målet. I den här snabbstarten skalar vi cacheinstansen. Korrigeringar, skalning, import och export är tillgängliga alternativ.
    Typ av slutpunkt Välj Web Hook. Händelsehanterare för att ta emot dina händelser.
    Slutpunkt Välj Välj en slutpunkt och ange webbadressen till webbappen och lägg till api/updates i startsidans URL (till exempel: https://cache.azurewebsites.net/api/updates) och välj sedan Bekräfta markering. Det här är URL:en för din webbapp som du skapade tidigare.
  5. På sidan Skapa händelseprenumeration väljer du Skapa för att skapa händelseprenumerationen.

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

    Azure Event Grid Viewer.

Skicka en händelse till din slutpunkt

Nu ska vi utlösa en händelse och se hur Event Grid distribuerar meddelandet till slutpunkten. Vi skalar din Azure Cache for Redis-instans.

  1. I Azure Portal navigerar du till din Azure Cache for Redis-instans och väljer Skala på den vänstra menyn.

  2. Välj önskad prisnivå på sidan Skala och välj Välj.

    Du kan skala till en annan prisnivå med följande begränsningar:

    • Du kan inte skala från en högre prisnivå till en lägre prisnivå.
      • Du kan inte skala från en Premium cache till en Standard- eller Basic-cache.
      • Du kan inte skala från en Standard-cache till en Basic-cache .
    • Du kan skala från en Basic-cache till en Standard-cache , men du kan inte ändra storleken på samma gång. Om du behöver en annan storlek kan du utföra en efterföljande skalningsåtgärd till önskad storlek.
    • Du kan inte skala från en Basic-cache direkt till en Premium cache. Skala först från Basic till Standard i en skalningsåtgärd och sedan från Standard till Premium i en efterföljande skalningsåtgärd.
    • Du kan inte skala från en större storlek till storleken C0 (250 MB).

    Cacheminnet skalas till den nya prisnivån, men skalningsstatusen visas med Azure Cache for Redis till vänster. När skalningen är klar ändras statusen från Skalning till Körs.

  3. 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 din webbapp och observera att en ScalingCompleted-händelse togs emot.

    Azure Event Grid Viewer scaling in JSON format.

Rensa resurser

Om du planerar att fortsätta arbeta med den här händelsen ska du inte rensa resurserna som skapades i den här snabbstarten. Annars tar du bort de resurser som du skapade i den här snabbstarten.

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: