Schnellstart: Verwenden von Azure Redis mit einer ASP.NET-Web-App

Erstellen einer Azure Managed Redis-Instanz

1. Um eine Azure Managed Redis-Instanz zu erstellen, melden Sie sich beim Azure-Portal an, und wählen Sie " Ressource erstellen" aus.

2. Geben Sie auf der Seite Neu im Suchfeld Azure Cache for Redis ein.

3. Konfigurieren Sie auf der Registerkarte "Neuer Redis-Cache " die Einstellungen für Ihren neuen Cache in den Grundlagen.

   Konfiguration	Wert auswählen	BESCHREIBUNG
   Abonnement	Öffnen Sie die Dropdownliste, und wählen Sie Ihr Abonnement aus.	Das Abonnement, unter dem diese neue Azure Managed 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.
   Name	Geben Sie einen Namen ein, der in der Region eindeutig ist.	Der Cachename muss zwischen 1 und 63 Zeichen lang sein, wenn er mit dem Regionsnamen des Cache kombiniert wird, und darf nur Ziffern, Buchstaben und Bindestriche enthalten. (Wenn der Cachename weniger als 45 Zeichen lang ist, sollte er in allen derzeit verfügbaren Regionen funktionieren.) Der Name muss mit einer Zahl oder einem Buchstaben beginnen und enden und darf keine aufeinanderfolgenden Bindestriche enthalten. Der Hostname Ihrer Cache-Instanz ist \<DNS name\>.\<Azure region\>.redis.azure.net.
   Region	Öffnen Sie die Dropdownliste, und wählen Sie einen Standort aus.	Azure Managed Redis ist in ausgewählten Azure-Regionen verfügbar.
   Datenebene	Wählen Sie entweder im Arbeitsspeicher für hohe Leistung oder Flash für Caches mit geringerer Leistung aus.	Zu den In-Memory-Ebenen gehören "Balanced", "Memory Optimized" und "Compute Optimized". Verwenden Sie die Flash-Ebene , um Arbeitsspeicher (RAM) und SSD-Datenspeicher (On-Disk) zu verwenden.
   Cachegröße	Öffnen Sie die Dropdownliste, und wählen Sie eine Größe aus.	Die Cachegröße hängt von der Ebene ab. Die kleinste Größe ist eine Ebene „Ausgewogen“. Die Größe mit dem größten Arbeitsspeicher ist eine Ebene „Arbeitsspeicheroptimiert“.
   Leistung	Öffnen Sie die Dropdownliste, und wählen Sie eine Leistungseinstellung aus.	Die Leistung hängt von der Anzahl der vCPUs ab. Die Anzahl der vCPU variiert je nach Ebene. Compute Optimized verfügt über die meisten vCPUs.

   Hinweise zum Auswählen der richtigen Leistungsklasse finden Sie unter Auswählen der richtigen Leistungsklasse.

   Von Bedeutung

   Alle Arbeitsspeicherebenen, die mehr als 120 GB Speicherplatz verwenden, befinden sich in der öffentlichen Vorschau, einschließlich „Arbeitsspeicheroptimiert M150“ und höher; „Ausgewogen B150“ und höher; und „Für Compute optimiert X150“ und höher. Alle diese Ebenen und höher befinden sich in der öffentlichen Vorschau.

   Alle für Flash optimierten Ebenen befinden sich in der öffentlichen Vorschau.

4. Wählen Sie "Weiter" aus: Netzwerk , und wählen Sie entweder einen öffentlichen Endpunkt oder einen privaten Endpunkt aus.

5. Wählen Sie "Weiter" aus: Aktive Georeplikation. Um die aktive Georeplikation zu verwenden, muss sie während der Bereitstellung aktiviert werden. Caches ohne aktive Georeplikation können später nicht zu aktiven Georeplikationsgruppen hinzugefügt oder beitreten. Weitere Informationen finden Sie unter Konfigurieren der aktiven Georeplikation für Azure Managed Redis-Instanzen.

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

   Konfigurieren Sie alle Redis-Module , die Sie der Instanz hinzufügen möchten.

   Folgendes gilt standardmäßig für neue verwaltete Caches:

   • Microsoft Entra ID ist aktiviert.
   • Die Authentifizierung mit Zugriffsschlüsseln ist aus Sicherheitsgründen deaktiviert.

   Von Bedeutung

   Für eine optimale Sicherheit empfehlen wir, Microsoft Entra ID mit verwalteten Identitäten zu verwenden, um Anforderungen nach Möglichkeit für Ihren Cache zu autorisieren. Die Autorisierung mit Microsoft Entra ID und verwalteten Identitäten bietet eine höhere Sicherheit und Benutzerfreundlichkeit als die Autorisierung mit gemeinsam verwendetem Schlüssel. Weitere Informationen zum Verwenden verwalteter Identitäten mit Ihren Caches finden Sie unter Verwenden von Microsoft Entra ID für die Cacheauthentifizierung.

   Festlegen der Clusteringrichtlinie:

   • Verwenden von Enterprise zum Verwenden von RedisSearch oder anderen Modulen
   • Verwenden Sie OSS für einen gruppierten Cache.
   • Verwenden Sie nicht gruppierte (Vorschau) für einen nicht gruppierten Cache.

   Weitere Informationen zum Auswählen einer Clusterrichtlinie finden Sie unter Clusterrichtlinie.

   Von Bedeutung

   Sie können die Clusteringrichtlinie einer Azure Managed Redis-Instanz nach dem Erstellen nicht mehr ändern. Wenn Sie RediSearch verwenden, ist die Enterprise-Clusterrichtlinie erforderlich, und NoEviction wird die einzige Entfernungsrichtlinie unterstützt.

   Von Bedeutung

   Wenn Sie diese Cacheinstanz in einer Georeplikationsgruppe verwenden, können Entfernungsrichtlinien nach der Erstellung der Instanz nicht mehr geändert werden. Achten Sie darauf, die Entfernungsrichtlinie Ihrer primären Knoten zu kennen, bevor Sie den Cache erstellen. Weitere Informationen zur aktiven Georeplikation finden Sie unter Voraussetzungen für die aktive Georeplikation.

   Von Bedeutung

   Module können nach dem Erstellen einer Cache-Instanz nicht mehr geändert werden. Module müssen zum Zeitpunkt der Erstellung einer Azure Cache for Redis-Instanz aktiviert sein. Es gibt keine Option, die Konfiguration eines Moduls zu aktivieren, nachdem Sie einen Cache erstellt haben.

7. Wählen Sie Weiter: Tags aus, und überspringen Sie den Schritt.

8. Klicken Sie auf Weiter: Überprüfen + erstellen.

9. Überprüfen Sie die Einstellungen, und wählen Sie Erstellen aus.

   Das Erstellen der Redis-Instanz dauert einige Minuten. Sie können den Fortschritt auf der Seite Übersicht von Azure Managed Redis überwachen. Wenn Wird ausgeführt als Status angezeigt wird, ist der Cache einsatzbereit.

Erstellen einer Azure Cache for Redis-Instanz

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 muss Folgendes gelten:
     • Er 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.

   

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.

   

   Von Bedeutung

   Verwenden Sie Microsoft Entra ID mit verwalteten Identitäten, um nach Möglichkeit Anfragen für Ihren Cache zu autorisieren. 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.

So bearbeiten Sie die Datei web.config

1. Bearbeiten Sie die Datei web.config, indem Sie den folgenden Inhalt hinzufügen:

   <appSettings>
       <add key="RedisHostName" value="<cache-hostname-with-portnumber>"/>
   </appSettings>
   

2. Ersetzen Sie <cache-hostname> durch Ihren Cache-Hostnamen, wie er in der Übersicht im Menü „Ressource“ des Azure-Portals angezeigt wird.

   Beispiel: Mit Azure Managed Redis oder den Enterprise-Ebenen: *my-redis.eastus.azure.net:10000_

3. Speichern Sie die Datei.

Weitere Informationen finden Sie unter StackExchange.Redis sowie den Code in einem GitHub-Repository.

So bearbeiten Sie die Datei web.config

1. Bearbeiten Sie die Datei web.config, indem Sie den folgenden Inhalt hinzufügen:

   <appSettings>
       <add key="RedisHostName" value="<cache-hostname-with-portnumber>"/>
   </appSettings>
   

2. Ersetzen Sie <cache-hostname> durch Ihren Cache-Hostnamen, wie er in der Übersicht im Menü „Ressource“ des Azure-Portals angezeigt wird.

   Beispielsweise durch Azure Cache for Redis, my-redis.eastus.azure.net:6380

3. Speichern Sie die Datei.

Weitere Informationen finden Sie unter StackExchange.Redis sowie den Code in einem GitHub-Repository.