Ćwiczenie — łączenie aplikacji z usługą Azure Cache for Redis przy użyciu platformy .NET Core

Ukończone

W tym ćwiczeniu dowiesz się, jak wykonywać następujące czynności:

• Utwórz nowe wystąpienie usługi Redis Cache przy użyciu poleceń interfejsu wiersza polecenia platformy Azure.
• Utwórz aplikację konsolową platformy .NET Core, aby dodać i pobrać wartości z pamięci podręcznej przy użyciu pakietu StackExchange.Redis .

Wymagania wstępne

• Konto platformy Azure z aktywną subskrypcją. Jeśli jej jeszcze nie masz, możesz zarejestrować się w celu uzyskania bezpłatnej wersji próbnej na stronie https://azure.com/free.
• Program Visual Studio Code na jednej z obsługiwanych platform.
• Rozszerzenie obsługujące język C# dla programu Visual Studio Code.
• Platforma .NET 8 jest platformą docelową dla tego ćwiczenia.

Tworzenie zasobów platformy Azure

1. Zaloguj się do portalu: https://portal.azure.com i otwórz usługę Cloud Shell, a następnie wybierz pozycję Bash jako powłokę.

2. Utwórz grupę zasobów dla zasobów platformy Azure. Zastąp <myLocation> element regionem blisko Ciebie.

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

3. Utwórz wystąpienie usługi Azure Cache for Redis przy użyciu az redis create polecenia . Nazwa wystąpienia musi być unikatowa, a poniższy skrypt próbuje go wygenerować, zastąp <myLocation> element regionem użytym w poprzednim kroku. Wykonanie tego polecenia może potrwać kilka minut.

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

4. W witrynie Azure Portal przejdź do nowo utworzonej pamięci podręcznej Redis Cache.

5. Wybierz pozycję Klucze dostępu w sekcji Uwierzytelnianie ustawień/okienka nawigacji i pozostaw otwarty portal. Skopiuj wartość Primary parametry połączenia (StackExchange.Redis) do późniejszego użycia w aplikacji.

Tworzenie aplikacji konsolowej

1. Utwórz aplikację konsolową, uruchamiając następujące polecenie w terminalu programu Visual Studio Code.

   dotnet new console -o Rediscache
   

2. Otwórz aplikację w programie Visual Studio Code, wybierając pozycję Plik > Otwórz folder i wybierając folder dla aplikacji.

3. StackExchange.Redis Dodaj pakiet do projektu.

   dotnet add package StackExchange.Redis
   

4. Usuń dowolny istniejący kod w pliku Program.cs i dodaj następującą using instrukcję u góry.

   using StackExchange.Redis;
   

5. Dodaj następującą zmienną po instrukcji using zastąp zmienną <REDIS_CONNECTION_STRING> Primary parametry połączenia (StackExchange.Redis) z portalu.

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

6. Dołącz następujący kod w pliku Program.cs :

   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. W terminalu programu Visual Studio Code uruchom następujące polecenia, aby skompilować i uruchomić aplikację.

   dotnet build
   dotnet run
   

   Dane wyjściowe powinny być podobne do następującego przykładu:

   PING = SimpleString : PONG
   SET: True
   GET: 100
   

8. Wróć do portalu i wybierz pozycję Dziennik aktywności w bloku Azure Cache for Redis. Operacje można wyświetlić w dzienniku.

Czyszczenie zasobów

Gdy zasoby nie są już potrzebne, możesz użyć az group delete polecenia , aby usunąć grupę zasobów.

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