التشغيل السريع: استخدم Azure Cache لـ Redis في Node.js

في هذا quickstart، يمكنك دمج Azure Cache لـ Redis في تطبيق Node.js للوصول إلى ذاكرة تخزين مؤقت آمنة ومخصصة يمكن الوصول إليها من أي تطبيق داخل Azure.

المتطلبات الأساسية

• اشتراك Azure - إنشاء اشتراك مجاني
• node_redis، والتي يمكنك تثبيتها باستخدام الأمر npm install redis.

للحصول على أمثلة من استخدام عملاء Node.js الآخرين، راجع الوثائق الفردية لعملاء Node.js المدرجة في عملاء Node.js Redis.

إنشاء ذاكرة تخزين مؤقت

1. لإنشاء ذاكرة تخزين مؤقت، قم بتسجيل الدخول إلى منصة Azure وحدد إنشاء مورد.

   

2. في صفحة بدء الاستخدام ، اكتب ذاكرة التخزين المؤقت Azure ل Redis في مربع البحث. وبعد ذلك، حدد إنشاء.

   

3. في صفحة New Redis Cache ، قم بتكوين إعدادات ذاكرة التخزين المؤقت.

   الإعدادات	اختيار قيمة	‏‏الوصف
   الاشتراك	اضغط على القائمة المنسدلة وحدد اشتراكك.	الاشتراك الذي يتم بموجبه إنشاء مثيل Azure Cache الجديد لـ Redis.
   مجموعة الموارد	حدد مجموعة موارد، أو حدد "إCreate new"، ثم أدخل اسماً فريداً لمجموعة الموارد الجديدة.	اسم مجموعة الموارد المراد إنشاء ذاكرة التخزين المؤقت والموارد الأخرى فيها. وعبر وضع جميع موارد التطبيق في مجموعة موارد واحدة، يمكنك إدارتها أو حذفها بسهولة.
   اسم DNS	أدخل اسمًا فريدًا.	يجب أن يكون اسم ذاكرة التخزين المؤقت عبارة عن سلسلة بين 1 و63 حرفًا تحتوي فقط على أرقام أو أحرف أو واصلات. لا بد أن يبدأ الاسم وينتهي برقم أو حرف، ولا يمكن أن يحتوي على واصلات متتالية. اسم مضيف مثيل ذاكرة التخزين المؤقت هو <اسم DNS.redis.cache.windows.net>.
   Location	من القائمة المنسدلة، حدد موقعاً.	حدد منطقة بالقرب من الخدمات الأخرى التي تستخدم ذاكرة التخزين المؤقت.
   ذاكرة التخزين المؤقت SKU	منسدلة وحدد SKU.	تحدد SKU معلمات الحجم والأداء والميزات المتوفرة لذاكرة التخزين المؤقت. لمزيد من المعلومات، راجع Azure Cache من أجل Redis Overview.
   حجم ذاكرة التخزين المؤقت	القائمة المنسدلة وحدد حجم ذاكرة التخزين المؤقت	لمزيد من المعلومات، راجع Azure Cache من أجل Redis Overview.

4. حدد علامة التبويب Networking أو انقر فوق زر Networking في أسفل الصفحة.

5. في علامة التبويب شبكة الاتصال، حدد أسلوب الاتصال.

6. حدد علامة التبويب Next: Advanced أو حدد الزر Next: Advanced أسفل الصفحة لمشاهدة علامة التبويب Advanced.

   

   • بالنسبة لذاكرة التخزين المؤقت الأساسية أو القياسية، قم بتبديل التحديد لمنفذ غير TLS. يمكنك أيضا تحديد ما إذا كنت تريد تمكين مصادقة Microsoft Entra.
   • بالنسبة لذاكرة التخزين المؤقت Premium، قم بتكوين الإعدادات لمنفذ غير TLS والتكتلة والهوية المدارة واستمرارية البيانات. يمكنك أيضا تحديد ما إذا كنت تريد تمكين مصادقة Microsoft Entra.

7. حدد علامة Next: Tags أو حدد الزر Next: Tags في أسفل الصفحة.

8. اختياريا، من علامة التبويب أدخل الاسم والقيمة إذا كنت ترغب في تصنيف المورد.

9. حدد "Review + create". يتم نقلك إلى علامة التبويب Review + create إذ يقوم Azure بالتحقق من صحة التكوين الخاص بك.

10. بعد ظهور رسالة "التحقق من الصحة" الخضراء، حدد إنشاء.

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

استرجع اسم المضيف والمنافذ ومفاتيح الوصول من مدخل Azure

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

• للحصول على مفاتيح الوصول، حدد Authentication من قائمة Resource. ثم حدد علامة التبويب مفاتيح الوصول.

  

• للحصول على اسم المضيف والمنافذ لذاكرة التخزين المؤقت، حدد نظرة عامة من قائمة الموارد. اسم المضيف هو من نموذج<DNS name>.redis.cache.windows.net.

  

إضافة متغيرات بيئية لـ اسم المضيف ومفتاح الاختصار الأساسي. استخدم هذه المتغيرات من التعليمات البرمجية بدلاً من تضمين المعلومات الحساسة مباشرة في التعليمات البرمجية الخاصة بك.

set AZURE_CACHE_FOR_REDIS_HOST_NAME=contosoCache
set AZURE_CACHE_FOR_REDIS_ACCESS_KEY=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

الاتصال بذاكرة التخزين المُؤقت

توفر أحدث إصدارات node_redis العديد من خيارات الاتصال. لا تقم بإنشاء اتصال جديد لكل عملية في التعليمات البرمجية الخاصة بك. بدلاً من ذلك، أعد استخدام الاتصالات قدر الإمكان.

إنشاء تطبيق Node.js جديد

1. إنشاء ملف برنامج نصي جديد يُسمى redistest.js.

2. استخدم الأمر لتثبيت حزمة redis.

   `npm install redis`
   

3. أضف رمز JavaScript المثال التالي إلى الملف.

   const redis = require("redis");
   
   // Environment variables for cache
   const cacheHostName = process.env.AZURE_CACHE_FOR_REDIS_HOST_NAME;
   const cachePassword = process.env.AZURE_CACHE_FOR_REDIS_ACCESS_KEY;
   
   if(!cacheHostName) throw Error("AZURE_CACHE_FOR_REDIS_HOST_NAME is empty")
   if(!cachePassword) throw Error("AZURE_CACHE_FOR_REDIS_ACCESS_KEY is empty")
   
   async function testCache() {
   
       // Connection configuration
       const cacheConnection = redis.createClient({
           // rediss for TLS
           url: `rediss://${cacheHostName}:6380`,
           password: cachePassword
       });
   
       // Connect to Redis
       await cacheConnection.connect();
   
       // PING command
       console.log("\nCache command: PING");
       console.log("Cache response : " + await cacheConnection.ping());
   
       // GET
       console.log("\nCache command: GET Message");
       console.log("Cache response : " + await cacheConnection.get("Message"));
   
       // SET
       console.log("\nCache command: SET Message");
       console.log("Cache response : " + await cacheConnection.set("Message",
           "Hello! The cache is working from Node.js!"));
   
       // GET again
       console.log("\nCache command: GET Message");
       console.log("Cache response : " + await cacheConnection.get("Message"));
   
       // Client list, useful to see if connection list is growing...
       console.log("\nCache command: CLIENT LIST");
       console.log("Cache response : " + await cacheConnection.sendCommand(["CLIENT", "LIST"]));
   
       // Disconnect
       cacheConnection.disconnect()
   
       return "Done"
   }
   
   testCache().then((result) => console.log(result)).catch(ex => console.log(ex));
   

   يوضح هذا الرمز كيفية الاتصال بمثيل ذاكرة التخزين المؤقت Azure لـ Redis باستخدام اسم مضيف ذاكرة التخزين المؤقت ومتغيرات بيئة المفتاح. كما تقوم التعليمات البرمجية بتخزين قيمة سلسلة واستردادها في ذاكرة التخزين المؤقت. أوامر PING وCLIENT LIST تنفذ أيضًا. لمزيد من الأمثلة على استخدام Redis مع عميل node_redis، راجع https://redis.js.org/.

4. تشغيل البرنامج النصي مع Node.js.

   node redistest.js
   

5. مثال على الإخراج.

   Cache command: PING
   Cache response : PONG
   
   Cache command: GET Message
   Cache response : Hello! The cache is working from Node.js!
   
   Cache command: SET Message
   Cache response : OK
   
   Cache command: GET Message
   Cache response : Hello! The cache is working from Node.js!
   
   Cache command: CLIENT LIST
   Cache response : id=10017364 addr=76.22.73.183:59380 fd=221 name= age=1 idle=0 flags=N db=0 sub=0 psub=0 multi=-1 qbuf=26 qbuf-free=32742 argv-mem=10 obl=0 oll=0 omem=0 tot-mem=61466 ow=0 owmem=0 events=r cmd=client user=default numops=6
   
   Done
   

تنظيف الموارد

إذا تابعت إلى البرنامج التعليمي التالي، فإنه يمكنك الاحتفاظ بالموارد التي أنشأتها في التشغيل السريع وإعادة استخدامها. وإلا، في حال كنت قد انتهيت من تطبيق نموذج التشغيل السريع، يمكنك حذف موارد Azure التي تم إنشاؤها في هذه البداية السريعة لتجنب المصاريف.

هام

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

1. سجل الدخول إلىمدخل Azureوحددمجموعات الموارد.

2. في مربع النصتصفية حسب الاسم، اكتب اسم مجموعة الموارد الخاصة بك. استخدمت إرشادات هذه المقالة مجموعة موارد تسمى TestResources. في مجموعة الموارد في قائمة النتائج، حدد ... ثم حذف مجموعة الموارد.

   

3. تأكيد حذف مجموعة الموارد. أدخل اسم مجموعة الموارد للتأكيد وحدد "Delete".

4. بعد لحظات قليلة، يتم حذف مجموعة الموارد وكافة الموارد المضمنة.

الحصول على التعليمات البرمجية للعينة

احصل على التشغيل السريع Node.js على GitHub.

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

في هذه quickstart، تعلمت كيفية استخدام ذاكرة التخزين المؤقت Azure لـ Redis من تطبيق Node.js. تابع إلى التشغيل السريع التالي لاستخدام Azure Cache for Redis مع تطبيق ويب ASP.NET.

أنشئ تطبيق ويب ASP.NET يستخدم Azure Cache لـ Redis.