Übung: Verknüpfen einer App mit Azure Cache for Redis mithilfe von .NET Core

  • 10 Minuten

In dieser Übung lernen Sie Folgendes:

  • Erstellen einer neuen Redis Cache-Instanz mithilfe von Azure CLI-Befehlen
  • Erstellen einer .NET Core-Konsolen-App zum Hinzufügen von Werten und zum Abrufen von Werten aus dem Cache mithilfe des Pakets StackExchange.Redis

Voraussetzungen

Erstellen von Azure-Ressourcen

  1. Melden Sie sich unter https://portal.azure.com beim Portal an, öffnen Sie Cloud Shell, und wählen Sie Bash als Shell aus.

  2. Erstellen Sie eine Ressourcengruppe für Azure-Ressourcen. Ersetzen Sie <myLocation> durch eine Region in Ihrer Nähe.

    az group create --name az204-redis-rg --location <myLocation>

  3. Erstellen Sie eine Azure Cache for Redis-Instanz mithilfe des Befehls az redis create. Der Instanzname muss eindeutig sein, und das folgende Skript versucht, einen für Sie zu generieren; ersetzen Sie <myLocation> durch die Region, die Sie im vorherigen Schritt verwendet haben. Die Ausführung dieses Befehls dauert einige Minuten.

    redisName=az204redis$RANDOM
az redis create --location <myLocation> \
    --resource-group az204-redis-rg \
    --name $redisName \
    --sku Basic --vm-size c0

  4. Navigieren Sie im Azure-Portal zu der neu erstellten Redis Cache-Instanz.

  5. Wählen Sie Zugriffsschlüssel im Abschnitt Einstellungen/Authentifizierung des Navigationsbereichs aus, und lassen Sie das Portal geöffnet. Kopieren Sie den unter Primäre Verbindungszeichenfolge (StackExchange.Redis) angegebenen Wert. Er wird später in der App verwendet.

Erstellen der Konsolenanwendung

  1. Erstellen Sie eine Konsolen-App, indem Sie den folgenden Befehl im Visual Studio Code-Terminal ausführen.

    dotnet new console -o Rediscache

  2. Öffnen Sie die App in Visual Studio Code, indem Sie Datei & Ordner öffnen und anschließend den Ordner für die App auswählen.

  3. Fügen Sie dem Projekt das Paket StackExchange.Redis hinzu.

    dotnet add package StackExchange.Redis

  4. Löschen Sie jeglichen vorhandenen Code in der Datei Program.cs, und fügen Sie die folgende using-Anweisung oben in der Datei ein.

    using StackExchange.Redis;

  5. Fügen Sie hinter der using-Anweisung die folgende Variable hinzu, und ersetzen Sie <REDIS_CONNECTION_STRING> durch den Wert von Primäre Verbindungszeichenfolge (StackExchange.Redis) aus dem Portal.

    // connection string to your Redis Cache    
string connectionString = "REDIS_CONNECTION_STRING";

  6. Fügen Sie den folgenden Code in der Datei Program.cs an:

    using (var cache = ConnectionMultiplexer.Connect(connectionString))
{
    IDatabase db = cache.GetDatabase();

    // Snippet below executes a PING to test the server connection
    var result = await db.ExecuteAsync("ping");
    Console.WriteLine($"PING = {result.Resp2Type} : {result}");

    // Call StringSetAsync on the IDatabase object to set the key "test:key" to the value "100"
    bool setValue = await db.StringSetAsync("test:key", "100");
    Console.WriteLine($"SET: {setValue}");

    // StringGetAsync retrieves the value for the "test" key
    string getValue = await db.StringGetAsync("test:key");
    Console.WriteLine($"GET: {getValue}");
}

  7. Führen Sie im Visual Studio Code-Terminal die folgenden Befehle aus, um die App zu erstellen und auszuführen.

    dotnet build
dotnet run

    Die Ausgabe sollte ungefähr wie das folgende Beispiel aussehen:

    PING = SimpleString : PONG
SET: True
GET: 100

  8. Kehren Sie zum Portal zurück, und wählen Sie auf dem Blatt Azure Cache for Redis die Option Aktivitätsprotokoll aus. Sie können sich die Vorgänge im Protokoll ansehen.

Bereinigen von Ressourcen

Wenn Sie die Ressourcen nicht mehr benötigen, können Sie die Ressourcengruppe mithilfe des Befehls az group delete entfernen.

az group delete -n az204-redis-rg --no-wait