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
• Funções do Azure
• Azure Container Apps
• 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 pelo seu próprio nome e <redis-key> 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

.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