Интеграция Кэша Azure для Redis с помощью соединителя сервисов

На этой странице показаны поддерживаемые методы проверки подлинности и клиенты, а также показан пример кода, который можно использовать для подключения Кэш Azure для Redis к другим облачным службам с помощью соединителя служб. Вы по-прежнему можете подключаться к Базе данных Кэша Azure для Redis, используя другие языки программирования без помощи соединителя сервисов. На этой странице также показаны имена и значения переменных среды по умолчанию (или конфигурация Spring Boot), которые вы получаете при создании подключения к службе.

Поддерживаемые службы вычислений

Соединитель служб можно использовать для подключения следующих вычислительных служб к Кэш Azure для Redis:

• Служба приложений Azure
• Приложения-контейнеры Azure
• Функции Azure
• Служба Azure Kubernetes (AKS)
• Azure Spring Apps

Поддерживаемые типы проверки подлинности и типы клиентов

В таблице ниже показано, какие сочетания методов проверки подлинности и клиентов поддерживаются для подключения вычислительной службы к Кэш Azure для Redis с помощью соединителя служб. Значение "Да" указывает, что сочетание поддерживается, а значение "Нет" указывает, что оно не поддерживается.

Тип клиента	Управляемое удостоверение, назначаемое системой	Управляемое удостоверение, назначаемое пользователем	Секрет / строка подключения	Субъект-служба
.NET	No	No	Да	Нет
Go	No	No	Да	Нет
Java	No	No	Да	Нет
Java — Spring Boot	No	No	Да	Нет
Node.js	No	No	Да	Нет
Python	No	No	Да	Нет
нет	No	No	Да	Нет

Эта таблица указывает, что единственным поддерживаемым методом проверки подлинности для всех типов клиентов в таблице является метод Secret /строка подключения. Другие методы проверки подлинности не поддерживаются для любого из типов клиентов для подключения к Кэш Azure для Redis с помощью соединителя службы.

Имена переменных среды по умолчанию или свойства приложения и пример кода

Используйте имена переменных среды и свойства приложения, перечисленные ниже, для подключения вычислительных служб к Серверу Redis. В каждом примере ниже замените текст <redis-server-name>заполнителя и <redis-key> собственным именем сервера Redis и ключом. Дополнительные сведения о соглашениях об именовании см. во внутренней статье соединителя служб.

Строка подключения

Предупреждение

Корпорация Майкрософт рекомендует использовать самый безопасный поток проверки подлинности. Поток проверки подлинности, описанный в этой процедуре, требует очень высокого уровня доверия к приложению и несет риски, которые отсутствуют в других потоках. Этот поток следует использовать только в том случае, если другие более безопасные потоки, такие как управляемые удостоверения, не являются жизнеспособными.

.NET

Имя переменной среды по умолчанию	Description	Пример значения
AZURE_REDIS_CONNECTIONSTRING	StackExchange. Redis строка подключения	<redis-server-name>.redis.cache.windows.net:6380,password=<redis-key>,ssl=True,defaultDatabase=0

Java

Имя переменной среды по умолчанию	Description	Пример значения
AZURE_REDIS_CONNECTIONSTRING	Строка подключения Jedis	rediss://:<redis-key>@<redis-server-name>.redis.cache.windows.net:6380/0

SpringBoot

Свойства приложения	Description	Пример значения
spring.redis.host	Узел Redis	<redis-server-name>.redis.cache.windows.net
spring.redis.port	Порт Redis	6380
spring.redis.database	База данных Redis	0
spring.redis.password	Ключ Redis	<redis-key>
spring.redis.ssl	Параметр SSL	true

Python

Имя переменной среды по умолчанию	Description	Пример значения
AZURE_REDIS_CONNECTIONSTRING	Строка подключения redis-py	rediss://:<redis-key>@<redis-server-name>.redis.cache.windows.net:6380/0

Go

Имя переменной среды по умолчанию	Description	Пример значения
AZURE_REDIS_CONNECTIONSTRING	Строка подключения redis-py	rediss://:<redis-key>@<redis-server-name>.redis.cache.windows.net:6380/0

NodeJS

Имя переменной среды по умолчанию	Description	Пример значения
AZURE_REDIS_CONNECTIONSTRING	Строка подключения node-redis	rediss://:<redis-key>@<redis-server-name>.redis.cache.windows.net:6380/0

Другое

Имя переменной среды по умолчанию	Description	Пример значения
AZURE_REDIS_HOST	Узел Redis	<redis-server-name>.redis.cache.windows.net
AZURE_REDIS_PORT	Порт Redis	6380
AZURE_REDIS_DATABASE	База данных Redis	0
AZURE_REDIS_PASSWORD	Ключ Redis	<redis-key>
AZURE_REDIS_SSL	Параметр SSL	true

Пример кода

Ознакомьтесь с инструкциями и кодом ниже, чтобы подключиться к Кэш Azure для Redis с помощью строка подключения.

.NET

1. Установите зависимости.

   dotnet add package StackExchange.Redis --version 2.6.122
   

2. Получите строка подключения Redis из переменной среды, добавленной соединителем службы.

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

Java

1. Добавьте в файл pom.xml следующую зависимость:

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

2. Получите строка подключения Redis из переменной среды, добавленной соединителем службы.

   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

Сведения об использовании кэша Redis в Azure в Spring для настройки приложения Spring. Свойства конфигурации добавляются в Spring Apps соединителем службы.

Python

1. Установите зависимости.

   pip install redis
   

2. Получите строка подключения Redis из переменной среды, добавленной соединителем службы.

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

Go

1. Установите зависимости.

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

2. Получите строка подключения Redis из переменной среды, добавленной соединителем службы.

   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. Установите зависимости.

   npm install redis
   

2. Получите строка подключения Redis из переменной среды, добавленной соединителем службы.

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

Другое

Для других языков можно использовать сведения о подключении, которые соединитель службы задает переменным среды для подключения к Кэш Azure для Redis. Сведения об переменной среды см. в разделе "Интеграция Конфигурация приложений Azure с соединителем службы".

Следующие шаги

Дополнительные сведения о соединителе служб см. в приведенных ниже учебниках.

относительно соединителя служб