Quickstart: Gebeurtenissen van Azure Cache voor Redis naar het webeindpunt routeren met de Azure Portal

Azure Event Grid is een gebeurtenisservice voor de cloud. In deze quickstart gebruikt u de Azure Portal om een Azure Cache voor Redis-exemplaar te maken, u te abonneren op gebeurtenissen voor dat exemplaar, een gebeurtenis te activeren en de resultaten weer te geven. Normaal gesproken verzendt u gebeurtenissen naar een eindpunt dat de gebeurtenisgegevens verwerkt en vervolgens in actie komt. Om deze snelstart te vereenvoudigen, verzendt u echter gebeurtenissen naar een web-app die de berichten verzamelt en weergeeft.

Als u geen Azure-abonnement hebt, kunt u een gratis Azure-account maken voordat u begint.

Wanneer u klaar bent, ziet u dat de gebeurtenisgegevens naar de web-app zijn verzonden.

Azure Event Grid Viewer schalen in JSON-indeling.

Een Azure Cache voor Redis cache-exemplaar maken

  1. Als u een cache wilt maken, meldt u zich aan bij de Azure-portal en selecteert u Een resource maken.

    Een resource maken is gemarkeerd in het linkernavigatiedeelvenster.

  2. Selecteer op de pagina Nieuw de optie Databases en selecteer vervolgens Azure Cache voor Redis.

    In Nieuw is Databases gemarkeerd. Azure Cache voor Redis is ook gemarkeerd.

  3. Configureer op de pagina Nieuwe Redis-cache de instellingen voor de nieuwe cache.

    Instelling Een waarde kiezen Beschrijving
    Abonnement Open de vervolgkeuzelijst en selecteer uw abonnement. Het abonnement waarmee dit nieuwe Azure Cache voor Redis-exemplaar wordt gemaakt.
    Resourcegroep Open de vervolgkeuzelijst en selecteer een resourcegroep of kies Nieuwe maken en geef een naam voor de nieuwe resourcegroep op. Naam voor de resourcegroep waarin de cache en andere resources moeten worden gemaakt. Door al uw app-resources in één resourcegroep te plaatsen, kunt u ze eenvoudig beheren of verwijderen.
    DNS-naam Voer een unieke naam in. De cachenaam moet een tekenreeks tussen 1 en 63 tekens zijn die alleen cijfers, letters of afbreekstreepjes bevat. De naam moet beginnen en eindigen met een cijfer of letter en mag geen opeenvolgende afbreekstreepjes bevatten. De hostnaam van uw cache-exemplaar is <DNS-naam.redis.cache.windows.net>.
    Locatie Open de vervolgkeuzelijst en selecteer een locatie. Selecteer een regio in de buurt van andere services die gaan gebruikmaken van de cache.
    Cachetype Selecteer een laag in de vervolgkeuzelijst. De grootte, prestaties en functies die beschikbaar zijn voor de cache, zijn afhankelijk van de gekozen laag. Zie het Azure Cache voor Redis-overzicht voor meer informatie.
  4. Selecteer het tabblad Netwerken of selecteer de knop Netwerken onderaan de pagina.

  5. Selecteer uw verbindingsmethode op het tabblad Netwerk.

  6. Selecteer het tabblad Volgende: Geavanceerd of selecteer de knop Volgende: Geavanceerd onderaan de pagina.

  7. Selecteer in het tabblad Geavanceerd voor een basic of standard cache-exemplaar de schakeloptie inschakelen als u een niet-TLS-poort wilt inschakelen. U kunt ook selecteren welke Redis-versie u wilt gebruiken, ofwel 4 of 6.

    Redis-versie 4 of 6.

  8. Configureer in het tabblad Geavanceerd voor premium cache-exemplaar de instellingen voor een niet-TLS-poort, clustering en gegevenspersistentie. U kunt ook selecteren welke Redis-versie u wilt gebruiken, ofwel 4 of 6.

  9. Selecteer het tabblad Volgende: Tags of selecteer de knop Volgende: Tags onderaan de pagina.

  10. Voer desgewenst in het tabblad Tags de naam en waarde in om de resource te categoriseren.

  11. Selecteer Controleren + maken. Het tabblad Beoordelen + maken wordt weergegeven, waar uw configuratie wordt gevalideerd in Azure.

  12. Selecteer Maken nadat het groene bericht Validatie geslaagd verschijnt.

Het duurt even voor de cache is gemaakt. U kunt de voortgang bekijken op de overzichtspagina van Azure Cache voor Redis. Als u bij StatusWordt uitgevoerd ziet staan, kunt u de cache gebruiken.

Het eindpunt van een bericht maken

Voordat u zich abonneert op de gebeurtenissen voor het cache-exemplaar, maken we het eindpunt voor het gebeurtenisbericht. Het eindpunt onderneemt normaal gesproken actie op basis van de gebeurtenisgegevens. Om deze quickstart te vereenvoudigen, implementeert u een vooraf gemaakte web-app die de gebeurtenisberichten weergeeft. De geïmplementeerde oplossing omvat een App Service-plan, een App Service-web-app en broncode van GitHub.

  1. Selecteer Implementeren in Azure in GitHub README om de oplossing te implementeren in uw abonnement.

Knop Implementeren naar Azure.

  1. Voer op de pagina Aangepaste implementatie de volgende stappen uit:

    1. Selecteer bij Resourcegroep de resourcegroep die u hebt gemaakt bij het maken van het cache-exemplaar. Het is voor u eenvoudiger om op te schonen door de resourcegroep te verwijderen wanneer u klaar bent met de zelfstudie.
    2. Voer in het vak Sitenaam een naam in voor de web-app.
    3. Voer voor Naam van hostingplan een naam in voor het App Service-plan dat u wilt gebruiken voor het hosten van de web-app.
    4. Schakel het selectievakje in voor Ik ga akkoord met de bovenstaande voorwaarden.
    5. Selecteer Aankoop.
    Instelling Voorgestelde waarde Beschrijving
    Abonnement Open de vervolgkeuzelijst en selecteer uw abonnement. Het abonnement waaronder deze web-app moet worden gemaakt.
    Resourcegroep Open de vervolgkeuzelijst en selecteer een resourcegroep of kies Nieuwe maken en geef een naam voor de nieuwe resourcegroep op. Door al uw app-resources in één resourcegroep te plaatsen, kunt u ze eenvoudig beheren of verwijderen.
    Sitenaam Voer een naam in voor uw web-app. Deze waarde mag niet leeg zijn.
    Naam van hostingabonnement Voer een naam in voor de App Service wilt gebruiken voor het hosten van de web-app. Deze waarde mag niet leeg zijn.
  2. Selecteer Waarschuwingen (belpictogram) in de portal en selecteer vervolgens Naar de resourcegroep gaan.

    Azure Portal implementatiemelding.

  3. Selecteer in de lijst met resources op de pagina Resourcegroep de web-app die u hebt gemaakt. U ziet ook het App Service-plan en het cache-exemplaar in deze lijst.

  4. Selecteer op de pagina App Service voor uw web-app de URL om naar de website te gaan. De URL moet de volgende indeling hebben: https://<your-site-name>.azurewebsites.net.

  5. Controleer of de site wordt weergegeven en dat er zijn nog geen gebeurtenissen naar zijn gepost.

    Lege Event Grid Viewer-site.

Event Grid-resourceprovicer inschakelen

Als u Event Grid in uw Azure-abonnement nog niet eerder hebt gebruikt, moet u mogelijk de Event Grid-resourceprovider registreren.

In Azure Portal:

  1. Selecteer Abonnementen in het menu links.
  2. Selecteer het abonnement dat u voor Event Grid gebruikt.
  3. Selecteer onder Instellingen in het menu links de optie Resourceproviders.
  4. Zoek Microsoft.EventGrid.
  5. Als deze niet is geregistreerd, selecteert u Registreren.

Het kan even duren voordat de registratie is voltooid. Selecteer Vernieuwen om de status bij te werken. Wanneer de StatusGeregistreerde is, bent u klaar om verder te gaan.

Abonneren op het Azure Cache voor Redis-exemplaar

In deze stap abonneert u zich op een onderwerp om Event Grid te laten weten welke gebeurtenissen u wilt bijhouden en waar de gebeurtenissen naartoe moeten worden verzonden.

  1. Navigeer in de portal naar het cache-exemplaar dat u eerder hebt gemaakt.

  2. Selecteer gebeurtenissen in het linkermenu op de pagina Azure Cache voor Redis.

  3. Selecteer Webhook. U verzendt gebeurtenissen naar uw viewer-app met behulp van een webhook voor het eindpunt.

    Azure Portal pagina Gebeurtenissen.

  4. Voer op de pagina Gebeurtenisabonnement maken het volgende in:

    Instelling Voorgestelde waarde Beschrijving
    Naam Voer een naam in voor het gebeurtenisabonnement. De waarde moet tussen 3 en 64 tekens lang zijn. Deze mag alleen letters, cijfers en streepjes bevatten.
    Gebeurtenistypen Selecteer de vervolgkeuzelijst en selecteer welke gebeurtenistypen u naar uw bestemming wilt pushen. Voor deze quickstart schalen we het cache-exemplaar. Patchen, schalen, importeren en exporteren zijn de beschikbare opties.
    Eindpunttype Selecteer Webhook. Gebeurtenis-handler om uw gebeurtenissen te ontvangen.
    Eindpunt Selecteer Een eindpunt selecteren, voer de URL van uw web-app in en voeg toe api/updates aan de URL van de startpagina (bijvoorbeeld: https://cache.azurewebsites.net/api/updates) en selecteer vervolgens Selectie bevestigen. Dit is de URL van uw web-app die u eerder hebt gemaakt.
  5. Selecteer nu op de pagina Gebeurtenisabonnement maken de optie Maken om het gebeurtenisabonnement te maken.

  6. Bekijk opnieuw uw web-app en u zult zien dat er een validatiegebeurtenis voor een abonnement naartoe is verzonden. Selecteer het oogpictogram om de gebeurtenisgegevens uit te breiden. Via Event Grid wordt de validatiegebeurtenis verzonden zodat het eindpunt kan controleren of de gebeurtenisgegevens in aanmerking komen om ontvangen te worden. De web-app bevat code waarmee het abonnement kan worden gevalideerd.

    Azure Event Grid Viewer.

Een gebeurtenis verzenden naar het eindpunt

Nu gaan we een gebeurtenis activeren om te zien hoe het bericht via Event Grid naar het eindpunt wordt gedistribueerd. Uw Azure Cache voor Redis exemplaar wordt geschaald.

  1. Navigeer in de Azure Portal naar uw Azure Cache voor Redis exemplaar en selecteer Schaal in het menu links.

  2. Selecteer de gewenste prijscategorie op de pagina Schaal en selecteer Selecteren.

    U kunt schalen naar een andere prijscategorie met de volgende beperkingen:

    • U kunt niet schalen van een hogere prijscategorie naar een lagere prijscategorie.
      • U kunt niet schalen van een Premium-cache naar een Standard - of Basic-cache .
      • U kunt niet schalen van een Standard-cache naar een Basic-cache .
    • U kunt schalen van een Basic-cache naar een Standard-cache , maar u kunt de grootte niet tegelijkertijd wijzigen. Als u een andere grootte nodig hebt, kunt u een volgende schaalbewerking uitvoeren naar de gewenste grootte.
    • U kunt niet rechtstreeks van een Basic-cache naar een Premium-cache schalen. Schaal eerst van Basic naar Standard in één schaalbewerking en vervolgens van Standard naar Premium in een volgende schaalbewerking.
    • U kunt niet schalen van een groter formaat naar beneden naar de grootte C0 (250 MB).

    Terwijl de cache wordt geschaald naar de nieuwe prijscategorie, wordt aan de linkerkant een schaalstatus weergegeven met behulp van Azure Cache voor Redis. Wanneer het schalen is voltooid, verandert de status van Schalen in Actief.

  3. U hebt de gebeurtenis geactiveerd en Event Grid heeft het bericht verzonden naar het eindpunt dat u hebt geconfigureerd toen u zich abonneerde. Het bericht heeft de JSON-indeling en bevat een matrix met een of meer gebeurtenissen. In het volgende voorbeeld bevat het JSON-bericht een matrix met één gebeurtenis. Bekijk uw web-app en u ziet dat er een ScalingCompleted-gebeurtenis is ontvangen.

    Azure Event Grid Viewer schalen in JSON-indeling.

Resources opschonen

Als u van plan bent om met deze gebeurtenis te blijven werken, moet u de resources die in deze quickstart zijn gemaakt, niet opschonen. Verwijder anders de resources die u in deze quickstart hebt gemaakt.

Selecteer de resourcegroep en klik op Resourcegroep verwijderen.

Volgende stappen

U weet nu hoe u aangepaste onderwerpen maakt en hoe u zich abonneert op een gebeurtenis. Kijk waar Event Grid u nog meer bij kan helpen: