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

Esta página mostra métodos e clientes de autenticação com suporte e mostra o código de exemplo que você pode usar para conectar o Cache do Azure para Redis a outros serviços de nuvem usando o Service Connector. 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 Service Connector pode ser usado para conectar os seguintes serviços de computação ao Cache do Azure para Redis:

• Serviço de aplicativo do Azure
• Funções do Azure
• Aplicativos de Contêiner do Azure
• Azure Spring Apps

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

A tabela abaixo mostra quais combinações de métodos de autenticação e clientes têm suporte para conectar seu serviço de computação ao Cache do Azure para Redis usando o Service Connector. Um "Sim" indica que a combinação é suportada, enquanto um "Não" indica que ela não é suportada.

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	Não
Go	Não	No	Sim	Não
Java	Não	No	Sim	Não
Java – Spring Boot	Não	No	Sim	Não
Node.js	Não	No	Sim	Não
Python	Não	No	Sim	Não
Nenhum	Não	No	Sim	Não

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

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

Use os nomes de variáveis de ambiente e as propriedades de aplicativo listados 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 obter mais informações sobre convenções de nomenclatura, consulte o artigo Internos do Service Connector.

Cadeia de conexão

.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

Consulte 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. Obtenha a cadeia de conexão Redis da variável de ambiente adicionada pelo Service Connector.

   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 arquivo pom.xml :

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

2. Obtenha a cadeia de conexão Redis da variável de ambiente adicionada pelo Service Connector.

   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 Redis do Azure no Spring para configurar seu aplicativo Spring . As propriedades de configuração são adicionadas ao Spring Apps pelo Service Connector.

Python

1. Instale as dependências.

   pip install redis
   

2. Obtenha a cadeia de conexão Redis da variável de ambiente adicionada pelo Service Connector.

   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. Obtenha a cadeia de conexão Redis da variável de ambiente adicionada pelo Service Connector.

   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. Obtenha a cadeia de conexão Redis da variável de ambiente adicionada pelo Service Connector.

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

Outras

Para outros idiomas, você pode usar as informações de conexão que o Service Connector define para as variáveis de ambiente para se conectar ao Cache do Azure para Redis. Para obter detalhes sobre variáveis de ambiente, consulte Integrar a Configuração de Aplicativo do Azure ao Service Connector.

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