Integrar o Cache Redis do Azure com o Service Connector

Esta página mostra os métodos de autenticação e os clientes suportados e mostra o código de exemplo que pode utilizar para ligar a Cache Redis do Azure a outros serviços de nuvem utilizando o Service Connector. Talvez você ainda consiga se conectar ao Cache Redis do Azure em outras linguagens de programação sem usar o Service Connector. Esta página também mostra nomes e valores de variáveis de ambiente padrão (ou configuração do Spring Boot) que você obtém quando cria a conexão de serviço.

Serviços de computação suportados

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

• Serviço de Aplicações do Azure
• Azure Container Apps
• Funções do Azure
• Azure Kubernetes Service (AKS)
• Azure Spring Apps

Tipos de autenticação suportados e tipos de cliente

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 Redis do Azure 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 gerida atribuída pelo sistema	Identidade gerida atribuída pelo utilizador	Segredo / cadeia de conexão	Service principal (Principal de serviço)
.NET	No	No	Sim	No
Go	No	No	Sim	No
Java	No	No	Sim	No
Java - Arranque primavera	No	No	Sim	No
Node.js	No	No	Sim	No
Python	No	No	Sim	No
Nenhuma	No	No	Sim	No

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

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

Use os nomes das variáveis de ambiente e as propriedades do aplicativo listadas abaixo para conectar serviços de computação ao Servidor Redis. Para cada exemplo abaixo, substitua os textos <redis-server-name>de espaço reservado e <redis-key> pelo seu próprio nome e chave do servidor Redis. Para obter mais informações sobre convenções de nomenclatura, consulte o artigo interno do Service Connector.

Cadeia de Ligação

Aviso

A Microsoft recomenda que você use o fluxo de autenticação mais seguro disponível. O fluxo de autenticação descrito neste procedimento requer um grau muito alto de confiança no aplicativo e acarreta 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	Description	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	Description	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 da aplicação	Description	Valor de exemplo
spring.redis.host	Anfitrião Redis	<redis-server-name>.redis.cache.windows.net
spring.redis.port	Porto Redis	6380
spring.redis.banco de dados	Base de dados Redis	0
spring.redis.password	Chave Redis	<redis-key>
primavera.redis.ssl	Configuração SSL	true

Python

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

Ir

Nome da variável de ambiente padrão	Description	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	Description	Valor de exemplo
AZURE_REDIS_CONNECTIONSTRING	cadeia de conexão node-redis	rediss://:<redis-key>@<redis-server-name>.redis.cache.windows.net:6380/0

Outro

Nome da variável de ambiente padrão	Description	Valor de exemplo
AZURE_REDIS_HOST	Anfitrião Redis	<redis-server-name>.redis.cache.windows.net
AZURE_REDIS_PORT	Porto Redis	6380
AZURE_REDIS_DATABASE	Base de dados Redis	0
AZURE_REDIS_PASSWORD	Chave Redis	<redis-key>
AZURE_REDIS_SSL	Configuração SSL	true

Código de exemplo

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

.NET

1. Instale 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 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()
   

Ir

1. Instale 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 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();
   

Outro

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 do aplicativo do Azure com o Service Connector.

Próximos passos

Siga os tutoriais listados abaixo para saber mais sobre o Service Connector.

Saiba mais sobre os conceitos do Service Connector