دمج Azure Cache لـ Redis مع Service Connector

تعرض هذه الصفحة أساليب المصادقة المدعومة والعملاء، وتعرض نموذج التعليمات البرمجية التي يمكنك استخدامها لتوصيل Azure Cache for Redis بخدمات سحابية أخرى باستخدام Service Connector. قد تظل قادراً على الاتصال بـ Azure Cache لـ Redis بلغات الكمبيوتر الأخرى دون استخدام Service Connector. تعرض هذه الصفحة أيضاً أسماء وقيم متغيرات البيئة الافتراضية (أو تكوين Spring Boot) التي تحصل عليها عند إنشاء اتصال الخدمة.

خدمات الحوسبة المدعومة

يمكن استخدام موصل الخدمة لتوصيل خدمات الحوسبة التالية بذاكرة التخزين المؤقت Azure ل Redis:

• "Azure App Service"
• Azure Container Apps
• دالات Azure
• خدمة Azure Kubernetes ‏(AKS)
• Azure Spring Apps

أنواع المصادقة المدعومة وأنواع العملاء

يوضح الجدول أدناه مجموعات أساليب المصادقة والعملاء المدعومة لتوصيل خدمة الحوسبة بذاكرة التخزين المؤقت Azure ل Redis باستخدام موصل الخدمة. يشير "نعم" إلى أن المجموعة مدعومة، بينما تشير "لا" إلى أنها غير مدعومة.

نوع العميل	الهوية المُدارة التي يُعيّنها النظام	الهوية المُدارة التي يعيّنها المُستخدم	بيانات سرية / سلسلة الاتصال	كيان الخدمة
.NET	لا	لا	نعم	لا
انتقال	لا	لا	نعم	لا
Java	لا	لا	نعم	لا
Java - Spring Boot	لا	لا	نعم	لا
Node.js	لا	لا	نعم	لا
Python	لا	لا	نعم	لا
بلا	لا	لا	نعم	لا

يشير هذا الجدول إلى أن أسلوب المصادقة الوحيد المعتمد لجميع أنواع العملاء في الجدول هو الأسلوب secret / سلسلة الاتصال. أساليب المصادقة الأخرى غير مدعومة لأي من أنواع العملاء للاتصال بذاكرة التخزين المؤقت Azure ل Redis باستخدام موصل الخدمة.

أسماء متغيرات البيئة الافتراضية أو خصائص التطبيق ونموذج التعليمات البرمجية

استخدم أسماء متغيرات البيئة وخصائص التطبيق المدرجة أدناه لتوصيل خدمات الحوسبة ب Redis Server. لكل مثال أدناه، استبدل النصوص <redis-server-name>النائبة ، و <redis-key> باسم ومفتاح خادم Redis الخاص بك. لمزيد من المعلومات حول اصطلاحات التسمية، راجع مقالة Service Connector internals .

سلسلة الاتصال

تحذير

توصي Microsoft باستخدام تدفق المصادقة الأكثر أمانا المتوفر. يتطلب تدفق المصادقة الموضح في هذا الإجراء درجة عالية جدا من الثقة في التطبيق، ويحمل مخاطر غير موجودة في تدفقات أخرى. يجب عليك استخدام هذا التدفق فقط عندما لا تكون التدفقات الأخرى الأكثر أمانا، مثل الهويات المدارة، قابلة للتطبيق.

NET.

اسم متغير البيئة الافتراضي	‏‏الوصف	مثال للقيمة
AZURE_REDIS_CONNECTIONSTRING	StackExchange. سلسلة الاتصال Redis	<redis-server-name>.redis.cache.windows.net:6380,password=<redis-key>,ssl=True,defaultDatabase=0

Java

اسم متغير البيئة الافتراضي	‏‏الوصف	مثال للقيمة
AZURE_REDIS_CONNECTIONSTRING	سلسلة اتصال Jedis	rediss://:<redis-key>@<redis-server-name>.redis.cache.windows.net:6380/0

SpringBoot

خصائص التطبيق	‏‏الوصف	مثال للقيمة
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

اسم متغير البيئة الافتراضي	‏‏الوصف	مثال للقيمة
AZURE_REDIS_CONNECTIONSTRING	سلسلة اتصال redis-py	rediss://:<redis-key>@<redis-server-name>.redis.cache.windows.net:6380/0

ذهب

اسم متغير البيئة الافتراضي	‏‏الوصف	مثال للقيمة
AZURE_REDIS_CONNECTIONSTRING	سلسلة اتصال redis-py	rediss://:<redis-key>@<redis-server-name>.redis.cache.windows.net:6380/0

NodeJS

اسم متغير البيئة الافتراضي	‏‏الوصف	مثال للقيمة
AZURE_REDIS_CONNECTIONSTRING	سلسلة اتصال node-redis	rediss://:<redis-key>@<redis-server-name>.redis.cache.windows.net:6380/0

آخر

اسم متغير البيئة الافتراضي	‏‏الوصف	مثال للقيمة
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 Cache for Redis باستخدام سلسلة الاتصال.

NET.

1. تثبيت التبعيات:

   dotnet add package StackExchange.Redis --version 2.6.122
   

2. احصل على سلسلة الاتصال Redis من متغير البيئة الذي تمت إضافته بواسطة Service Connector.

   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 من متغير البيئة الذي تمت إضافته بواسطة 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

راجع استخدام Azure Redis Cache في Spring لإعداد تطبيق Spring الخاص بك. تتم إضافة خصائص التكوين إلى Spring Apps by Service Connector.

Python

1. تثبيت التبعيات:

   pip install redis
   

2. احصل على سلسلة الاتصال Redis من متغير البيئة الذي تمت إضافته بواسطة Service Connector.

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

ذهب

1. تثبيت التبعيات:

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

2. احصل على سلسلة الاتصال Redis من متغير البيئة الذي تمت إضافته بواسطة 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. تثبيت التبعيات:

   npm install redis
   

2. احصل على سلسلة الاتصال Redis من متغير البيئة الذي تمت إضافته بواسطة Service Connector.

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

آخر

بالنسبة للغات الأخرى، يمكنك استخدام معلومات الاتصال التي يعينها Service Connector إلى متغيرات البيئة للاتصال بذاكرة التخزين المؤقت Azure ل Redis. للحصول على تفاصيل متغير البيئة، راجع تكامل Azure App Configuration مع Service Connector.

الخطوات التالية

اتبع البرامج التعليمية المذكورة أدناه لمعرفة المزيد عن Service Connector.

تعرف على مفاهيم Service Connector