Freigeben über

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

  • Gilt für:: ✅ Azure Cache for Redis

Wichtig

Azure Cache for Redis kündigte den Auslauftermin für alle SKUs an. Es wird empfohlen, Ihren vorhandenen Azure-Cache für Redis-Instanzen in Azure Managed Redis zu verschieben, sobald Möglich.

Weitere Informationen zur Einstellung finden Sie unter:

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 nicht über ein Azure-Konto verfügen, erstellen Sie ein kostenloses 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: Skalierung im JSON-Format.

Erstellen einer Instanz des Azure Cache for Redis-Caches

  1. Suchen Sie im Azure-Portal nach Azure-Cache für Redis, und wählen Sie sie aus.

  2. Wählen Sie auf der Seite "Azure Cache für Redis" die Option"Azure-Cache für Redis>" aus.

  3. Konfigurieren Sie auf der Registerkarte " Grundlagen " auf der Seite "Neuer Redis-Cache " die folgenden Einstellungen:

    • Abonnement: Wählen Sie das zu verwendende Abonnement aus.
    • Ressourcengruppe: Wählen Sie eine Ressourcengruppe aus, oder wählen Sie "Neu erstellen " aus, und geben Sie einen neuen Ressourcengruppennamen ein. Wenn Sie alle App-Ressourcen in derselben Ressourcengruppe platzieren, können Sie sie ganz einfach verwalten oder löschen.
    • Name: Geben Sie einen Cachenamen ein, der in der Region eindeutig ist. Für den Namen gilt:
      • Muss eine Zeichenfolge mit 1 bis 63 Zeichen sein.
      • Nur Zahlen, Buchstaben und Bindestriche enthalten.
      • Beginnen und enden Sie mit einer Zahl oder einem Buchstaben.
      • Er darf keine aufeinanderfolgenden Bindestriche enthalten.
    • Region: Wählen Sie eine Azure-Region in der Nähe anderer Dienste aus, die Ihren Cache verwenden.
    • Cache-SKU: Wählen Sie eine SKU aus, um die verfügbaren Größen, Leistung und Features für Ihren Cache zu ermitteln.
    • Cachegröße: Wählen Sie eine Cachegröße aus. Weitere Informationen finden Sie unter Azure Cache for Redis.

    Screenshot der Registerkarte

  4. Wählen Sie die Registerkarte "Netzwerk " aus, oder wählen Sie "Weiter: Netzwerk" aus.

  5. Wählen Sie auf der Registerkarte Netzwerk eine Konnektivitätsmethode für den Cache aus. Privater Endpunkt wird für sicherheit empfohlen. Wenn Sie "Privater Endpunkt" auswählen, wählen Sie "Privaten Endpunkt hinzufügen " aus, und erstellen Sie den privaten Endpunkt.

  6. Wählen Sie die Registerkarte "Erweitert " aus, oder wählen Sie "Weiter: Erweitert" aus.

  7. Konfigurieren Sie im Bereich "Erweitert" die folgenden Optionen:

    • Wählen Sie "Microsoft Entra-Authentifizierung " oder "Zugriffstastenauthentifizierung" aus. Die Microsoft Entra-Authentifizierung ist standardmäßig aktiviert.
    • Wählen Sie aus, ob der Nicht-TLS-Port aktiviert werden soll.
    • Für einen Premium-Cache können Sie Verfügbarkeitszonen konfigurieren oder deaktivieren. Verfügbarkeitszonen können nach der Erstellung des Caches nicht deaktiviert werden. Für einen Standardcache werden Verfügbarkeitszonen automatisch zugewiesen. Verfügbarkeitszonen sind für die Standard-SKU nicht verfügbar.
    • Konfigurieren Sie für einen Premium-Cache die Einstellungen für Replikatanzahl, Clustering und Shardanzahl, vom System zugewiesene verwaltete Identität und Datenpersistenz.

    Die folgende Abbildung zeigt die Registerkarte "Erweitert " für die Standard-SKU.

    Screenshot des Bereichs

    Wichtig

    Verwenden Sie Microsoft Entra ID mit verwalteten Identitäten, um Anforderungen für Ihren Cache zu autorisieren, sofern möglich. Die Autorisierung mithilfe der Microsoft Entra-ID und der verwalteten Identität bietet eine bessere Sicherheit und ist einfacher zu verwenden als die Autorisierung gemeinsam genutzter Zugriffstasten. Weitere Informationen zum Verwenden verwalteter Identitäten mit Ihren Caches finden Sie unter Verwenden von Microsoft Entra ID für die Cacheauthentifizierung.

  8. Wählen Sie optional die Registerkarte "Kategorien " aus, oder wählen Sie "Weiter: Kategorien" aus, und geben Sie Tagnamen und Werte ein, um Ihre Cacheressourcen zu kategorisieren.

  9. Wählen Sie "Überprüfen" und "Erstellen" aus, und wählen Sie " Erstellen" aus, sobald die Überprüfung bestanden wurde.

Die neue Cachebereitstellung dauert mehrere Minuten. Sie können den Bereitstellungsfortschritt auf der Seite "Azure Cache für Redis" im Portal überwachen. Wenn der Cachestatus"Ausgeführt" angezeigt wird, kann der Cache verwendet werden.

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.

    Schaltfläche „In Azure bereitstellen“.

  2. 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, in dem Sie die Web-App erstellen möchten.
    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 darf nicht leer 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 darf nicht leer sein.

  3. Wählen Sie im Portal die Option „Warnungen“ (Glockensymbol) und anschließend Zu Ressourcengruppe wechseln aus.

    Benachrichtigung über Bereitstellung im Azure-Portal.

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

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

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

    Event Grid-Viewer: Leere Website.

Registrieren des Event Grid-Ressourcenanbieters

Sofern Sie Event Grid nicht bereits zuvor genutzt haben, müssen Sie den Event Grid-Ressourcenanbieter registrieren. Wenn Sie Event Grid bereits eingesetzt haben, fahren Sie mit dem nächsten Abschnitt fort.

Führen Sie im Azure-Portal folgende Schritte aus:

  1. Wählen Sie im linken Menü Abonnements aus.

  2. Wählen Sie das Abonnement, das Sie für Event Grid verwenden möchten, aus der Abonnementliste aus.

  3. Wählen Sie auf der Seite Abonnement unter Einstellungen im linken Menü Ressourcenanbieter aus.

  4. Suchen Sie nach Microsoft.EventGrid, und vergewissern Sie sich, dass der StatusNicht registriert lautet.

  5. Wählen Sie Microsoft.EventGrid in der Anbieterliste aus.

  6. Wählen Sie Registrieren auf der Befehlsleiste aus.

    Bild, das die Registrierung des Microsoft.EventGrid-Anbieters mit dem Azure-Abonnement zeigt.

  7. Aktualisieren Sie, um sicherzustellen, dass der Status von Microsoft.EventGrid in Registriert geändert wird.

    Bild: Erfolgreiche Registrierung des Microsoft.EventGrid-Anbieters mit dem Azure-Abonnement.

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: Seite „Ereignisse“.

  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: Skalierung im 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:

  • Last updated on