Integrar o Cache do Azure para Redis com o Conector de serviço

Esta página mostra os métodos de autenticação e clientes com suporte e mostra um código de exemplo que é possível usar para conectar o Cache do Azure para Redis a outros serviços de nuvem usando o conector de serviço. Você ainda poderá se conectar ao Cache do Azure para Redis em outras linguagens de programação sem usar o Conector de serviço. Esta página também mostra nomes e valores da variável de ambiente padrão (ou configuração do Spring Boot) que você obtém ao criar a conexão de serviço.

Serviço de computação com suporte

O conector de serviço pode ser usado para conectar os seguintes serviços de computação ao Cache do Azure para Redis:

• Serviço de Aplicativo do Azure
• Aplicativos de Contêiner do Azure
• Azure Functions
• AKS (Serviço de Kubernetes do Azure)
• Azure Spring Apps

Tipos de autenticação e tipos de cliente com suporte

A tabela abaixo mostra quais combinações de clientes e métodos de autenticação têm suporte para conectar o serviço de computação ao Cache do Azure para Redis usando o conector de serviço. “Sim” indica que a combinação tem suporte e “Não” indica que ela não tem.

Tipo de cliente	Identidade gerenciada atribuída pelo sistema	Identidade gerenciada atribuída pelo usuário	Cadeia de conexão/segredo	Entidade de serviço
.NET	Não	No	Sim	No
Go	Não	No	Sim	Não
Java	Não	No	Sim	No
Java – Spring Boot	Não	No	Sim	No
Node.js	Não	No	Sim	Não
Python	Não	No	Sim	Não
Nenhum	Não	No	Sim	No

Esta tabela indica que o único método de autenticação com suporte para todos os tipos de cliente na tabela é o método Segredo/cadeia de conexão. Não há suporte para outros métodos de autenticação para que nenhum dos tipos de cliente se conecte ao Cache do Azure para Redis usando o conector de serviço.

Nomes de variáveis de ambiente padrão ou propriedades de aplicativo e código de exemplo

Usar os nomes de variável de ambiente e as propriedades de aplicativo listadas abaixo para conectar serviços de computação ao servidor Redis. Para cada exemplo abaixo, substitua os textos de espaço reservado <redis-server-name> e <redis-key> pelo nome do seu próprio servidor de Redis e chave. Para saber mais sobre as convenções de nomenclatura, confira o artigo Detalhes internos no conector de serviço.

Cadeia de conexão

Aviso

A Microsoft recomenda usar o fluxo de autenticação mais seguro disponível. O fluxo de autenticação descrito neste procedimento exige um grau muito alto de confiança no aplicativo e traz riscos que não estão presentes em outros fluxos. Você só deve usar esse fluxo quando outros fluxos mais seguros, como identidades gerenciadas, não forem viáveis.

.NET

Nome da variável de ambiente padrão	Descrição	Valor de exemplo
AZURE_REDIS_CONNECTIONSTRING	StackExchange. Cadeia de conexão Redis	<redis-server-name>.redis.cache.windows.net:6380,password=<redis-key>,ssl=True,defaultDatabase=0

Java

Nome da variável de ambiente padrão	Descrição	Valor de exemplo
AZURE_REDIS_CONNECTIONSTRING	Cadeia de conexão Jedis	rediss://:<redis-key>@<redis-server-name>.redis.cache.windows.net:6380/0

SpringBoot

Propriedades do aplicativo	Descrição	Valor de exemplo
spring.redis.host	Host Redis	<redis-server-name>.redis.cache.windows.net
spring.redis.port	Porta Redis	6380
spring.redis.database	Banco de dados Redis	0
spring.redis.password	Chave Redis	<redis-key>
spring.redis.ssl	Configurações SSL	true

Python

Nome da variável de ambiente padrão	Descrição	Valor de exemplo
AZURE_REDIS_CONNECTIONSTRING	Cadeia de conexão Redis-py	rediss://:<redis-key>@<redis-server-name>.redis.cache.windows.net:6380/0

Go

Nome da variável de ambiente padrão	Descrição	Valor de exemplo
AZURE_REDIS_CONNECTIONSTRING	Cadeia de conexão Redis-py	rediss://:<redis-key>@<redis-server-name>.redis.cache.windows.net:6380/0

NodeJS

Nome da variável de ambiente padrão	Descrição	Valor de exemplo
AZURE_REDIS_CONNECTIONSTRING	string de conexão node-redis	rediss://:<redis-key>@<redis-server-name>.redis.cache.windows.net:6380/0

Outras

Nome da variável de ambiente padrão	Descrição	Valor de exemplo
AZURE_REDIS_HOST	Host Redis	<redis-server-name>.redis.cache.windows.net
AZURE_REDIS_PORT	Porta Redis	6380
AZURE_REDIS_DATABASE	Banco de dados Redis	0
AZURE_REDIS_PASSWORD	Chave Redis	<redis-key>
AZURE_REDIS_SSL	Configurações SSL	true

Código de exemplo

Veja as etapas e o código abaixo para se conectar ao Cache do Azure para Redis usando uma cadeia de conexão.

.NET

1. Instale as dependências.

   dotnet add package StackExchange.Redis --version 2.6.122
   

2. Obter a cadeia de conexão do Redis por meio da variável de ambiente adicionada pelo conector de serviço.

   using StackExchange.Redis;
   var connectionString = Environment.GetEnvironmentVariable("AZURE_REDIS_CONNECTIONSTRING");
   var _redisConnection = await RedisConnection.InitializeAsync(connectionString: connectionString);
   

Java

1. Adicione a seguinte dependência no seu arquivo pom.xml:

   <dependency>
     <groupId>redis.clients</groupId>
     <artifactId>jedis</artifactId>
     <version>4.1.0</version>
     <type>jar</type>
     <scope>compile</scope>
   </dependency>
   

2. Obter a cadeia de conexão do Redis por meio da variável de ambiente adicionada pelo conector de serviço.

   import redis.clients.jedis.DefaultJedisClientConfig;
   import redis.clients.jedis.Jedis;
   import redis.clients.jedis.JedisShardInfo;
   import java.net.URI;
   
   String connectionString = System.getenv("AZURE_REDIS_CONNECTIONSTRING");
   URI uri = new URI(connectionString);
   JedisShardInfo shardInfo = new JedisShardInfo(uri);
   shardInfo.setSsl(true);
   Jedis jedis = new Jedis(shardInfo);
   

SpringBoot

Consulte Usar o Cache do Azure para Redis no Spring para configurar seu aplicativo Spring. As propriedades de configuração são adicionadas aos Aplicativos Spring pelo Conector de Serviço.

Python

1. Instale as dependências.

   pip install redis
   

2. Obter a cadeia de conexão do Redis por meio da variável de ambiente adicionada pelo conector de serviço.

   import os
   import redis
   
   url = os.getenv('AZURE_REDIS_CONNECTIONSTRING')
   url_connection = redis.from_url(url)
   url_connection.ping()
   

Go

1. Instale as dependências.

   go get github.com/redis/go-redis/v9
   

2. Obter a cadeia de conexão do Redis por meio da variável de ambiente adicionada pelo conector de serviço.

   import (
       "context"
       "fmt"
   
       "github.com/redis/go-redis/v9"
   )
   
   connectionString := os.Getenv("AZURE_REDIS_CONNECTIONSTRING")
   opt, err := redis.ParseURL(connectionString)
   if err != nil {
   	panic(err)
   }
   
   client := redis.NewClient(opt)
   

NodeJS

1. Instale as dependências.

   npm install redis
   

2. Obter a cadeia de conexão do Redis por meio da variável de ambiente adicionada pelo conector de serviço.

   const redis = require("redis");
   
   const connectionString = process.env.AZURE_REDIS_CONNECTIONSTRING;
   const cacheConnection = redis.createClient({
       url: connectionString,
   });
   await cacheConnection.connect();
   

Outras

Para outras linguagens, você pode usar as informações de conexão definidas pelo Conector de Serviço para as variáveis de ambiente para se conectar ao Cache do Azure para Redis. Para obter detalhes sobre as variáveis de ambiente, confira Integrar a Configuração de Aplicativos do Azure ao conector de serviço.

Próximas etapas

Siga os tutoriais listados abaixo para saber mais sobre o Conector de Serviço.

Saiba mais sobre os conceitos do Conector de Serviço