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

Azure Event Grid är en händelsetjänst för molnet. I den här snabbstarten använder du Azure-portalen 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 skapar du 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-portalen 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
    Abonnemang Listrutan och välj din prenumeration. Prenumerationen som den nya Azure Cache for Redis-instansen ska skapas under.
    Resursgrupp Listrutan och välj en resursgrupp eller välj Skapa ny och ange ett nytt resursgruppsnamn. Namn på den resursgrupp där cacheminnet och andra resurser ska skapas. 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 ett tal eller en bokstav och får inte innehålla bindestreck i följd. Värdnamnet för cacheinstansen är <DNS-namnet.redis.cache.windows.net>.
    Plats Listrutan och välj en plats. Välj en region nära andra tjänster som använder din cache.
    Cachetyp Listrutan och välj en nivå. Nivån avgör storlek, prestanda och funktioner som är tillgängliga för cacheminnet. 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 för att se fliken Avancerat .

    Screenshot showing the Advanced tab in the working pane and the available option to select.

    • För Basic- eller Standard-cacheminnen växlar du markeringen för en icke-TLS-port. Du kan också välja om du vill aktivera Microsoft Entra-autentisering.
    • För en Premium-cache konfigurerar du inställningarna för icke-TLS-port, klustring, hanterad identitet och datapersistence. Du kan också välja om du vill aktivera Microsoft Entra-autentisering.
  7. Välj fliken Nästa: Taggar eller välj knappen Nästa: Taggar längst ned på sidan.

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

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

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

Det tar en stund innan en cache skapas. Du kan övervaka förloppet på översiktssidan för Azure Cache for Redis. 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.

  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 cacheinstansen. 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. Markera kryssrutan för Jag godkänner de villkor som anges ovan.
    5. Välj Köp.
    Inställning Föreslaget värde beskrivning
    Abonnemang Listrutan och välj din prenumeration. Den prenumeration där du vill skapa den här webbappen.
    Resursgrupp Listrutan och välj en resursgrupp 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 för App Service-planen som ska användas som värd för webbappen. Det här värdet får inte vara tomt.
  3. Välj Aviseringar (klockikon) i portalen och välj sedan Gå till resursgrupp.

    Azure portal deployment notification.

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

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

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

    Empty Event Grid Viewer site.

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å 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 Description
    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. Korrigering, skalning, import och export är tillgängliga alternativ.
    Slutpunktstyp Välj Web Hook. Händelsehanterare för att ta emot dina händelser.
    Slutpunkt Välj Välj en slutpunkt och ange URL:en för webbappen och lägg till api/updates webbadressen till startsidan (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. Gå till Azure Cache for Redis-instansen i Azure-portalen och välj 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 ned till storleken C0 (250 MB).

    Medan cachen skalas till den nya prisnivån visas en skalningsstatus med Azure Cache for Redis till vänster. När skalningen är klar ändras statusen från Skalning till Körning.

  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 webbappen 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: