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

  • 10 minutos

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

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 abaixo tentará gerar um para você, substituindo <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 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 comando abaixo 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 .cs programa:

    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.Type} : {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 de código do Visual Studio, execute os comandos abaixo para criar o aplicativo para verificar se há erros e, em seguida, execute o aplicativo usando os comandos abaixo

    dotnet build
dotnet run

    O resultado deve ser semelhante ao seguinte:

    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 comando para remover o az group delete grupo de recursos.

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