Intégrer Azure Cache pour Redis avec le connecteur de services

Cette page présente les méthodes d’authentification et les clients pris en charge, et présente des exemples de code que vous pouvez utiliser pour connecter des Azure Cache pour Redis à d’autres services cloud à l’aide du service Connecter or. Vous pouvez toujours vous connecter à Azure Cache pour Redis dans d’autres langages de programmation sans utiliser le connecteur de services. Cette page présente également les noms et les valeurs des variables d’environnement par défaut (ou configuration Spring Boot) que vous obtenez lorsque vous créez des connexions de service.

Service de calcul pris en charge

Le Connecter or de service peut être utilisé pour connecter les services de calcul suivants à Azure Cache pour Redis :

• Azure App Service
• Azure Functions
• Azure Container Apps
• Azure Spring Apps

Types d’authentification et de clients pris en charge

Le tableau ci-dessous montre quelles combinaisons de méthodes d’authentification et de clients sont prises en charge pour connecter votre service de calcul à Azure Cache pour Redis à l’aide de Service Connecter or. Un « Oui » indique que la combinaison est prise en charge, tandis qu’une valeur « Non » indique qu’elle n’est pas prise en charge.

Type de client	Identité managée affectée par le système	Identité managée affectée par l’utilisateur	Secret / chaîne de connexion	Principal du service
.NET	Non	Non	Oui	Non
Go	Non	Non	Oui	Non
Java	Non	Non	Oui	Non
Java - Spring Boot	Non	Non	Oui	Non
Node.js	Non	Non	Oui	Non
Python	Non	Non	Oui	Non
Aucun	Non	Non	Oui	Non

Ce tableau indique que la seule méthode d’authentification prise en charge pour tous les types clients de la table est la méthode Secret /chaîne de connexion. D’autres méthodes d’authentification ne sont pas prises en charge pour l’un des types clients pour se connecter à Azure Cache pour Redis à l’aide du Connecter or de service.

Noms de variables d’environnement par défaut ou propriétés d’application et exemple de code

Utilisez les noms des variables d’environnement et les propriétés d’application répertoriées ci-dessous pour connecter les services de calcul à Redis Server. Pour chaque exemple ci-dessous, remplacez les textes des espaces réservés <redis-server-name> et <redis-key> par le nom et la clé de votre propre serveur Redis. Pour plus d’informations sur les conventions d’affectation de noms, case activée l’article interne du service Connecter or.

Chaîne de connexion

.NET

Nom de variable d’environnement par défaut	Description	Exemple de valeur
AZURE_REDIS_CONNECTIONSTRING	StackExchange. Chaîne de connexion Redis	<redis-server-name>.redis.cache.windows.net:6380,password=<redis-key>,ssl=True,defaultDatabase=0

Java

Nom de variable d’environnement par défaut	Description	Exemple de valeur
AZURE_REDIS_CONNECTIONSTRING	Chaîne de connexion Jedis	rediss://:<redis-key>@<redis-server-name>.redis.cache.windows.net:6380/0

SpringBoot

Propriétés de l’application	Description	Exemple de valeur
spring.redis.host	Hôte Redis	<redis-server-name>.redis.cache.windows.net
spring.redis.port	Port Redis	6380
spring.redis.database	Base de données Redis	0
spring.redis.password	Clé Redis	<redis-key>
spring.redis.ssl	Paramètre SSL	true

Python

Nom de variable d’environnement par défaut	Description	Exemple de valeur
AZURE_REDIS_CONNECTIONSTRING	Chaîne de connexion redis-py	rediss://:<redis-key>@<redis-server-name>.redis.cache.windows.net:6380/0

Go

Nom de variable d’environnement par défaut	Description	Exemple de valeur
AZURE_REDIS_CONNECTIONSTRING	Chaîne de connexion redis-py	rediss://:<redis-key>@<redis-server-name>.redis.cache.windows.net:6380/0

NodeJS

Nom de variable d’environnement par défaut	Description	Exemple de valeur
AZURE_REDIS_CONNECTIONSTRING	Chaîne de connexion node-redis	rediss://:<redis-key>@<redis-server-name>.redis.cache.windows.net:6380/0

Autres

Nom de variable d’environnement par défaut	Description	Exemple de valeur
AZURE_REDIS_HOST	Hôte Redis	<redis-server-name>.redis.cache.windows.net
AZURE_REDIS_PORT	Port Redis	6380
AZURE_REDIS_DATABASE	Base de données Redis	0
AZURE_REDIS_PASSWORD	Clé Redis	<redis-key>
AZURE_REDIS_SSL	Paramètre SSL	true

Exemple de code

Reportez-vous aux étapes et au code ci-dessous pour vous connecter à Azure Cache pour Redis à l’aide d’un chaîne de connexion.

.NET

1. Installez des dépendances.

   dotnet add package StackExchange.Redis --version 2.6.122
   

2. Obtenez le chaîne de connexion Redis à partir de la variable d’environnement ajoutée par service Connecter or.

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

Java

1. Ajoutez la dépendance suivante dans votre fichier pom.xml :

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

2. Obtenez le chaîne de connexion Redis à partir de la variable d’environnement ajoutée par service Connecter or.

   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

Reportez-vous à Utiliser le cache Redis Azure dans Spring pour configurer votre application Spring. Les propriétés de configuration sont ajoutées à Spring Apps by Service Connecter or.

Python

1. Installez des dépendances.

   pip install redis
   

2. Obtenez le chaîne de connexion Redis à partir de la variable d’environnement ajoutée par service Connecter or.

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

Go

1. Installez des dépendances.

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

2. Obtenez le chaîne de connexion Redis à partir de la variable d’environnement ajoutée par service Connecter or.

   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. Installez des dépendances.

   npm install redis
   

2. Obtenez le chaîne de connexion Redis à partir de la variable d’environnement ajoutée par service Connecter or.

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

Autres

Pour d’autres langages, vous pouvez utiliser les informations de connexion que Service Connecter or définit sur les variables d’environnement pour vous connecter à Azure Cache pour Redis. Pour plus d’informations sur la variable d’environnement, consultez Intégrer Azure App Configuration à Service Connecter or.

Étapes suivantes

Suivez les tutoriels ci-dessous pour en savoir plus sur Service Connector.

En savoir plus sur les concepts Service Connector