Exercício - Conectar um aplicativo ao Cache Redis do Azure usando o .NET Core

Concluído

Neste exercício você aprende a:

• Crie uma nova instância do Cache Redis usando comandos da CLI do Azure.
• Crie um aplicativo de console .NET Core para adicionar e recuperar valores do cache usando o pacote StackExchange.Redis .

Pré-requisitos

• Uma conta do Azure com uma assinatura ativa. Se ainda não tiver uma, pode inscrever-se numa avaliação gratuita em https://azure.com/free.
• Visual Studio Code numa das plataformas suportadas.
• A extensão C# para o Visual Studio Code.
• O .NET 8 é a estrutura de destino para este exercício.

Criar recursos do Azure

1. Faça login no portal: https://portal.azure.com abra o Cloud Shell e selecione Bash como shell.

2. Crie um grupo de recursos para recursos do Azure. Substitua <myLocation> por uma região perto de você.

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

3. Crie uma instância do Cache do Azure para Redis usando o az redis create comando. O nome da instância precisa ser exclusivo e o script a seguir tenta gerar um para você, substitua <myLocation> pela região usada na etapa anterior. Este comando leva alguns minutos para ser concluído.

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

4. No portal do Azure, navegue até o novo Cache Redis que você criou.

5. Selecione Teclas de acesso na seção Configurações/de autenticação do Painel de navegação e deixe o portal aberto. Copie o valor da cadeia de conexão primária (StackExchange.Redis) para usar no aplicativo mais tarde.

Criar o aplicativo de console

1. Crie um aplicativo de console executando o seguinte comando no terminal do Visual Studio Code.

   dotnet new console -o Rediscache
   

2. Abra o aplicativo no Visual Studio Code selecionando File > Open Folder e escolhendo a pasta para o aplicativo.

3. Adicione o StackExchange.Redis pacote ao projeto.

   dotnet add package StackExchange.Redis
   

4. Exclua qualquer código existente no arquivo Program.cs e adicione a seguinte using instrução na parte superior.

   using StackExchange.Redis;
   

5. Adicione a seguinte variável após a using instrução, substitua <REDIS_CONNECTION_STRING> pela cadeia de conexão primária (StackExchange.Redis) do portal.

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

6. Anexe o seguinte código no arquivo 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. No terminal do Visual Studio Code, execute os seguintes comandos para criar e executar o aplicativo.

   dotnet build
   dotnet run
   

   A saída deve ser semelhante ao exemplo a seguir:

   PING = SimpleString : PONG
   SET: True
   GET: 100
   

8. Retorne ao portal e selecione Log de atividades na folha Cache do Azure para Redis . Você pode visualizar as operações no log.

Clean up resources (Limpar recursos)

Quando os recursos não forem mais necessários, você poderá usar o az group delete comando para remover o grupo de recursos.

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