Integración de Azure Cache for Redis con Service Connector

En esta página se muestran los métodos de autenticación y los clientes admitidos y se muestra el código de ejemplo que puede usar para conectar los Azure Cache for Redis a otros servicios en la nube mediante Service Connector. Es posible que todavía pueda conectarse a Azure Cache for Redis en otros lenguajes de programación sin usar Service Connector. Esta página también muestra los nombres y valores predeterminados de las variables de entorno o la configuración de Spring Boot que se obtiene al crear la conexión de servicio.

Servicios de proceso admitidos

Service Connector se puede usar para conectar los siguientes servicios de proceso a Azure Cache for Redis:

• Azure App Service
• Azure Container Apps
• Funciones de Azure
• Azure Kubernetes Service (AKS)
• Azure Spring Apps

Tipos de autenticación y tipos de cliente admitidos

La siguiente tabla muestra qué combinaciones de métodos de autenticación y clientes se admiten para conectar su servicio de cómputo a Azure Cache for Redis mediante Service Connector. Un valor "Sí" indica que se admite la combinación, mientras que "No" indica que no se admite.

Tipo de cliente	Identidad administrada asignada por el sistema	Identidad administrada asignada por el usuario	Secreto/cadena de conexión	Entidad de servicio
.NET	No	No	Sí	No
Go	No	No	Sí	No
Java	No	No	Sí	No
Java: Spring Boot	No	No	Sí	No
Node.js	No	No	Sí	No
Python	No	No	Sí	No
Ninguno	No	No	Sí	No

Esta tabla indica que el único método de autenticación admitido para todos los tipos de cliente de la tabla es el método de cadena de conexión o secreto. No se admiten otros métodos de autenticación para ninguno de los tipos de cliente para conectarse a Azure Cache for Redis mediante Service Connector.

Nombres de variables de entorno predeterminados o propiedades de aplicación y código de ejemplo

Use los nombres de variables de entorno y las propiedades de la aplicación que se enumeran a continuación para conectar servicios de proceso a Redis Server. En los ejemplos siguientes, sustituya los textos del marcador de posición <redis-server-name> y <redis-key> por el nombre y la clave de su propio servidor Redis. Para más información sobre las convenciones de nomenclatura, consulte el artículo sobre los elementos internos del conector de servicio.

Cadena de conexión

Advertencia

Microsoft recomienda usar el flujo de autenticación más seguro disponible. El flujo de autenticación que se describe en este procedimiento requiere un alto grado de confianza en la aplicación y conlleva riesgos que no están presentes en otros flujos. Solo debe usar este flujo cuando otros flujos más seguros, como las identidades administradas, no sean viables.

.NET

Nombre de la variable de entorno predeterminado	Descripción	Valor de ejemplo
AZURE_REDIS_CONNECTIONSTRING	StackExchange. Cadena de conexión de Redis	<redis-server-name>.redis.cache.windows.net:6380,password=<redis-key>,ssl=True,defaultDatabase=0

Java

Nombre de la variable de entorno predeterminado	Descripción	Valor de ejemplo
AZURE_REDIS_CONNECTIONSTRING	Cadena de conexión de Jedis	rediss://:<redis-key>@<redis-server-name>.redis.cache.windows.net:6380/0

SpringBoot

Propiedades de la aplicación	Descripción	Valor de ejemplo
spring.redis.host	Host de Redis	<redis-server-name>.redis.cache.windows.net
spring.redis.port	Puerto de Redis	6380
spring.redis.database	Base de datos de Redis	0
spring.redis.password	Clave de Redis	<redis-key>
spring.redis.ssl	Configuración de SSL	true

Python

Nombre de la variable de entorno predeterminado	Descripción	Valor de ejemplo
AZURE_REDIS_CONNECTIONSTRING	cadena de conexión redis-py	rediss://:<redis-key>@<redis-server-name>.redis.cache.windows.net:6380/0

Go

Nombre de la variable de entorno predeterminado	Descripción	Valor de ejemplo
AZURE_REDIS_CONNECTIONSTRING	cadena de conexión redis-py	rediss://:<redis-key>@<redis-server-name>.redis.cache.windows.net:6380/0

NodeJS

Nombre de la variable de entorno predeterminado	Descripción	Valor de ejemplo
AZURE_REDIS_CONNECTIONSTRING	Cadena de conexión node-redis	rediss://:<redis-key>@<redis-server-name>.redis.cache.windows.net:6380/0

Otros

Nombre de la variable de entorno predeterminado	Descripción	Valor de ejemplo
AZURE_REDIS_HOST	Host de Redis	<redis-server-name>.redis.cache.windows.net
AZURE_REDIS_PORT	Puerto de Redis	6380
AZURE_REDIS_DATABASE	Base de datos de Redis	0
AZURE_REDIS_PASSWORD	Clave de Redis	<redis-key>
AZURE_REDIS_SSL	Configuración de SSL	true

Código de ejemplo

Consulte los pasos y el código siguientes para conectarse a Azure Cache for Redis mediante una cadena de conexión.

.NET

1. Instale las dependencias.

   dotnet add package StackExchange.Redis --version 2.6.122
   

2. Obtenga la cadena de conexión de Redis de la variable de entorno agregada por el conector de servicio.

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

Java

1. Agregue la siguiente dependencia al archivo pom.xml:

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

2. Obtenga la cadena de conexión de Redis de la variable de entorno agregada por el conector de servicio.

   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 Uso de Azure Redis Cache en Spring para configurar la aplicación de Spring. Las propiedades de configuración se agregan a las aplicaciones de Spring mediante el conector de servicio.

Python

1. Instale las dependencias.

   pip install redis
   

2. Obtenga la cadena de conexión de Redis de la variable de entorno agregada por el conector de servicio.

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

Go

1. Instale las dependencias.

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

2. Obtenga la cadena de conexión de Redis de la variable de entorno agregada por el conector de servicio.

   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 las dependencias.

   npm install redis
   

2. Obtenga la cadena de conexión de Redis de la variable de entorno agregada por el conector de servicio.

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

Otros

Para otros lenguajes, puede usar la información de conexión que el Conector de servicio establece en las variables de entorno para conectarse a Azure Cache for Redis. Para más información sobre las variables de entorno, vea Integración de Azure App Configuration con Service Connector.

Pasos siguientes

Para más información sobre Service Connector, siga los tutoriales que se enumeran a continuación.

Más información sobre los conceptos de Service Connector