Schnellstart: Weiterleiten von Azure Cache for Redis-Ereignissen an einen Webendpunkt mit dem Azure-Portal

Azure Event Grid ist ein Ereignisdienst für die Cloud. In dieser Schnellstartanleitung verwenden Sie das Azure-Portal, um eine Azure Cache for Redis-Instanz zu erstellen, Ereignisse für diese Instanz zu abonnieren, ein Ereignis auszulösen und die Ergebnisse anzuzeigen. Üblicherweise senden Sie Ereignisse an einen Endpunkt, der die Ereignisdaten verarbeitet und entsprechende Aktionen ausführt. Der Einfachheit halber senden Sie Ereignisse im Rahmen dieser Schnellstartanleitung an eine Web-App, mit der die Nachrichten gesammelt und angezeigt werden.

Wenn Sie kein Azure-Abonnement haben, erstellen Sie ein kostenloses Azure-Konto, bevor Sie beginnen.

Nach Abschluss des Vorgangs können Sie sehen, dass die Ereignisdaten an die Web-App gesendet wurden.

Azure Event Grid Viewer scaling in JSON format.

Erstellen einer Instanz des Azure Cache for Redis-Caches

  1. Melden Sie sich zum Erstellen eines Caches beim Azure-Portal an, und wählen Sie Ressource erstellen aus.

    Create a resource is highlighted in the left navigation pane.

  2. Wählen Sie auf der Seite Neu die Option Datenbanken und dann Azure Cache for Redis aus.

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

  3. Konfigurieren Sie auf der Seite Neuer Redis Cache die Einstellungen für den neuen Cache.

    Einstellung Wert auswählen BESCHREIBUNG
    Abonnement Öffnen Sie die Dropdownliste, und wählen Sie Ihr Abonnement aus. Das Abonnement, unter dem diese neue Azure Cache for Redis-Instanz erstellt wird.
    Ressourcengruppe Öffnen Sie die Dropdownliste, und wählen Sie eine Ressourcengruppe aus, oder wählen Sie Neu erstellen aus, und geben Sie einen Namen für eine neue Ressourcengruppe ein. Der Name der Ressourcengruppe, in der Ihr Cache und weitere Ressourcen erstellt werden. Wenn Sie alle Ihre App-Ressourcen in einer Ressourcengruppe zusammenfassen, können Sie sie einfacher gemeinsam verwalten oder löschen.
    DNS-Name Geben Sie einen eindeutigen Namen ein. Der Cachename muss zwischen 1 und 63 Zeichen lang sein und darf nur Ziffern, Buchstaben und Bindestriche enthalten. Der Name muss mit einer Zahl oder einem Buchstaben beginnen und enden und darf keine aufeinanderfolgenden Bindestriche enthalten. Der Hostname Ihrer Cache-Instanz lautet <DNS-Name>.redis.cache.windows.net.
    Location Öffnen Sie die Dropdownliste, und wählen Sie einen Standort aus. Wählen Sie eine Region in der Nähe anderer Dienste aus, die Ihren Cache verwenden.
    Cachetyp Öffnen Sie die Dropdownliste, und wählen Sie einen Tarif aus. Der Tarif bestimmt Größe, Leistung und verfügbare Features für den Cache. Weitere Informationen finden Sie unter What is Azure Cache for Redis (Was ist Azure Cache for Redis?).
  4. Wählen Sie die Registerkarte Netzwerk oder unten auf der Seite die Schaltfläche Netzwerk aus.

  5. Wählen Sie auf der Registerkarte Netzwerk Ihre Konnektivitätsmethode aus.

  6. Wählen Sie die Registerkarte Weiter: Erweitert oder unten auf der Seite die Schaltfläche Weiter: Erweitert aus.

  7. Aktivieren Sie auf der Registerkarte Erweitert für eine Basic- oder Standard-Cache-Instanz die Aktivierungsoption, wenn Sie einen TLS-fremden Port aktivieren möchten. Sie können auch die zu verwendende Redis-Version auswählen, entweder 4 oder 6.

    Redis version 4 or 6.

  8. Konfigurieren Sie auf der Registerkarte Advanced für eine Premium-Cache-Instanz die Einstellungen für einen TLS-fremden Port, Clustering und Datenpersistenz. Sie können auch die zu verwendende Redis-Version auswählen, entweder 4 oder 6.

  9. Wählen Sie die Registerkarte Weiter: Tags oder unten auf der Seite die Schaltfläche Weiter: Tags aus.

  10. Geben Sie optional auf der Registerkarte Tags den Namen und den Wert ein, wenn Sie die Ressource kategorisieren möchten.

  11. Klicken Sie auf Überprüfen + erstellen. Sie werden zur Registerkarte „Überprüfen und erstellen“ weitergeleitet, auf der Azure Ihre Konfiguration überprüft.

  12. Wenn die grüne Meldung „Validierung erfolgreich“ angezeigt wird, wählen Sie Erstellen aus.

Es dauert eine Weile, bis der Cache erstellt wird. Sie können den Fortschritt auf der Seite Übersicht von Azure Cache for Redis überwachen. Wenn Wird ausgeführt als Status angezeigt wird, ist der Cache einsatzbereit.

Erstellen eines Nachrichtenendpunkts

Vor dem Abonnieren der Ereignisse für die Cache-Instanz erstellen wir zunächst den Endpunkt für die Ereignisnachricht. Der Endpunkt führt in der Regel Aktionen auf der Grundlage der Ereignisdaten aus. Der Einfachheit halber stellen Sie in dieser Schnellstartanleitung eine vordefinierte Web-App bereit, die die Ereignisnachrichten anzeigt. Die bereitgestellte Lösung umfasst einen App Service-Plan, eine App Service-Web-App und Quellcode von GitHub.

  1. Wählen Sie in der GitHub-Infodatei die Option Deploy to Azure (In Azure bereitstellen) aus, um die Lösung für Ihr Abonnement bereitzustellen.

Deploy to Azure button.

  1. Gehen Sie auf der Seite Benutzerdefinierte Bereitstellung wie folgt vor:

    1. Wählen Sie unter Ressourcengruppe die Ressourcengruppe aus, die Sie beim Erstellen der Cache-Instanz erstellt haben. Dadurch muss zur Bereinigung nach Abschluss des Tutorials einfach nur die Ressourcengruppe gelöscht werden.
    2. Geben Sie unter Websitename einen Namen für die Web-App ein.
    3. Geben Sie unter Name des Hostingplans einen Namen für den App Service-Plan zum Hosten der Web-App ein.
    4. Aktivieren Sie das Kontrollkästchen Ich stimme den oben genannten Geschäftsbedingungen zu.
    5. Wählen Sie die Option Kaufen.
    Einstellung Vorgeschlagener Wert BESCHREIBUNG
    Abonnement Öffnen Sie die Dropdownliste, und wählen Sie Ihr Abonnement aus. Das Abonnement, unter dem diese Web-App erstellt werden soll.
    Ressourcengruppe Öffnen Sie die Dropdownliste, und wählen Sie eine Ressourcengruppe aus, oder wählen Sie Neu erstellen aus, und geben Sie einen Namen für eine neue Ressourcengruppe ein. Wenn Sie alle Ihre App-Ressourcen in einer Ressourcengruppe zusammenfassen, können Sie sie einfacher gemeinsam verwalten oder löschen.
    Standortname Geben Sie einen Namen für Ihre Web-App ein. Dieser Wert muss angegeben sein.
    Name des Hostingplans Geben Sie einen Namen für den App Service-Plan ein, der zum Hosten der Web-App verwendet werden soll. Dieser Wert muss angegeben sein.
  2. Wählen Sie im Portal die Option „Warnungen“ (Glockensymbol) und anschließend Zu Ressourcengruppe wechseln aus.

    Azure portal deployment notification.

  3. Wählen Sie auf der Seite Ressourcengruppe in der Ressourcenliste die von Ihnen erstellte Web-App aus. Darüber hinaus werden in dieser Liste der App Service-Plan und die Cache-Instanz angezeigt.

  4. Wählen Sie auf der Seite App Service für Ihre Web-App die URL aus, um zur entsprechenden Website zu navigieren. Die URL muss folgendes Format haben: https://<your-site-name>.azurewebsites.net.

  5. Vergewissern Sie sich, dass die Website angezeigt wird, aber noch keine Ereignisse bereitgestellt wurden.

    Empty Event Grid Viewer site.

Aktivieren des Event Grid-Ressourcenanbieters

Wenn Sie zuvor in Ihrem Azure-Abonnement noch nicht Event Grid verwendet haben, sollten Sie den Event Grid-Ressourcenanbieter registrieren.

Führen Sie im Azure-Portal die folgenden Schritte aus:

  1. Wählen Sie im linken Menü Abonnements aus.
  2. Wählen Sie das Abonnement aus, das Sie für Event Grid verwenden.
  3. Wählen Sie im linken Menü unter Einstellungen die Option Ressourcenanbieter aus.
  4. Suchen Sie nach Microsoft.EventGrid.
  5. Wenn Sie nicht registriert sind, klicken Sie auf Registrieren.

Es kann einen Moment dauern, bis die Registrierung abgeschlossen ist. Wählen Sie zum Aktualisieren des Status die Option Aktualisieren aus. Wenn der StatusRegistriert lautet, können Sie den Vorgang fortsetzen.

Abonnieren der Azure Cache for Redis-Instanz

In diesem Schritt abonnieren Sie ein Thema, um Event Grid mitzuteilen, welche Ereignisse Sie nachverfolgen möchten und wohin diese gesendet werden sollen.

  1. Navigieren Sie im Portal zu Ihrer Cache-Instanz, die Sie zuvor erstellt haben.

  2. Wählen Sie auf der Seite Azure Cache for Redis im Menü auf der linken Seite die Option Ereignisse aus.

  3. Wählen Sie Webhook aus. Sie verwenden einen Webhook für den Endpunkt, um Ereignisse an Ihre Viewer-App zu senden.

    Azure portal Events page.

  4. Geben Sie auf der Seite Ereignisabonnement erstellen Folgendes ein:

    Einstellung Vorgeschlagener Wert BESCHREIBUNG
    Name Geben Sie einen Namen für das Ereignisabonnement an. Der Wert muss eine Länge von 3 bis 64 Zeichen haben. Er darf nur Buchstaben, Zahlen und Bindestriche enthalten.
    Ereignistypen Wählen Sie in der Dropdownliste aus, welche Ereignistypen per Pushvorgang auf Ihr Ziel übertragen werden sollen. Für diese Schnellstartanleitung skalieren wir unsere Cache-Instanz. „Patchen“, „Skalierung“, „Import“ und „Export“ sind die verfügbaren Optionen.
    Endpunkttyp Wählen Sie Webhook aus. Der Ereignishandler für den Empfang Ihrer Ereignisse.
    Endpunkt Wählen Sie Endpunkt auswählen aus, geben Sie die URL Ihrer Web-App ein, und fügen Sie api/updates der URL für die Startseite hinzu (z. B. https://cache.azurewebsites.net/api/updates). Wählen Sie anschließend Auswahl bestätigen aus. Dies ist die URL Ihrer Web-App, die Sie zuvor erstellt haben.
  5. Wählen Sie als Nächstes auf der Seite Ereignisabonnement erstellen die Option Erstellen aus, um das Ereignisabonnement zu erstellen.

  6. Zeigen Sie wieder Ihre Web-App an. Wie Sie sehen, wurde ein Abonnementüberprüfungsereignis an sie gesendet. Klicken Sie auf das Augensymbol, um die Ereignisdaten zu erweitern. Event Grid sendet das Überprüfungsereignis, damit der Endpunkt bestätigen kann, dass er Ereignisdaten empfangen möchte. Die Web-App enthält Code zur Überprüfung des Abonnements.

    Azure Event Grid Viewer.

Senden eines Ereignisses an Ihren Endpunkt

Als Nächstes lösen wir ein Ereignis aus, um zu sehen, wie Event Grid die Nachricht an Ihren Endpunkt weiterleitet. Wir skalieren Ihre Azure Cache for Redis-Instanz.

  1. Navigieren Sie im Azure-Portal zu Ihrer Azure Cache for Redis-Instanz, und wählen Sie im Menü auf der linken Seite die Option Skalieren aus.

  2. Wählen Sie auf der Seite Skalierung den gewünschten Tarif und dann Auswählen aus.

    Sie können mit den folgenden Einschränkungen zu einem anderen Tarif wechseln:

    • Sie können keine Skalierung von einem höheren Tarif auf einen niedrigeren Tarif vornehmen.
      • Eine Skalierung von einem Premium-Cache auf einen niedrigeren Standard- oder Basic-Cache ist nicht möglich.
      • Ein Standard-Cache kann nicht auf einen niedrigeren Basic-Cache skaliert werden.
    • Ein Basic-Cache kann auf einen Standard-Cache skaliert werden, die Größe kann jedoch nicht gleichzeitig geändert werden. Wenn Sie eine andere Größe benötigen, können Sie anschließend einen Skalierungsvorgang auf die gewünschte Größe durchführen.
    • Ein Basic-Cache kann nicht direkt auf einen Premium-Cache skaliert werden. Skalieren Sie zunächst in einem ersten Skalierungsvorgang von Basic auf Standard und dann in einem nachfolgenden Skalierungsvorgang von Standard auf Premium.
    • Von einer größeren Größe kann nicht auf C0 (250 MB) herunterskaliert werden.

    Während der Skalierung des Caches auf den neuen Tarif wird links unter Azure Cache for Redis der Status Wird skaliert angezeigt. Wenn die Skalierung abgeschlossen ist, ändert sich der Status von Wird skaliert zu Wird ausgeführt.

  3. Sie haben das Ereignis ausgelöst, und Event Grid hat die Nachricht an den Endpunkt gesendet, den Sie beim Abonnieren konfiguriert haben. Die Nachricht weist das JSON-Format auf und enthält ein Array mit mindestens einem Ereignis. Im folgenden Beispiel enthält die JSON-Nachricht ein Array mit einem Ereignis. Zeigen Sie Ihre Web-App an. Sie sehen, dass das Ereignis ScalingCompleted empfangen wurde.

    Azure Event Grid Viewer scaling in JSON format.

Bereinigen von Ressourcen

Wenn Sie dieses Ereignis weiterverwenden möchten, sollten Sie keine Bereinigung für die in dieser Schnellstartanleitung erstellten Ressourcen durchführen. Löschen Sie andernfalls die Ressourcen, die Sie im Rahmen dieser Schnellstartanleitung erstellt haben.

Wählen Sie die Ressourcengruppe aus, und klicken Sie auf Ressourcengruppe löschen.

Nächste Schritte

Sie haben gelernt, wie Sie benutzerdefinierte Themen und Ereignisabonnements erstellen. Nun können Sie sich ausführlicher darüber informieren, welche Möglichkeiten Event Grid bietet: