استخدام أداة سطر الأوامر Redis مع ذاكرة التخزين المؤقت Azure لـ Redis

استخدم أداة سطر الأوامر redis-cli للتفاعل مع ذاكرة التخزين المؤقت Azure ل Redis كجهاز عميل. استخدم هذه الأداة للتفاعل مباشرة مع Azure Cache لمثيل Redis وتصحيح الأخطاء واستكشاف الأخطاء وإصلاحها.

تثبيت redis-cli

يتم تثبيت أداة redis-cli تلقائيا مع حزمة Redis، والتي تتوفر لأنظمة تشغيل متعددة. راجع دليل تثبيت Redis مصدر مفتوح للحصول على الوثائق الأكثر تفصيلا على نظام التشغيل المفضل لديك.

Linux

يعمل redis-cli بشكل أصلي على Linux، وتتضمن معظم التوزيعات حزمة Redis التي تحتوي على أداة redis-cli. على Ubuntu، على سبيل المثال، يمكنك تثبيت حزمة Redis مع الأوامر التالية:

sudo apt-get update
sudo apt-get install redis

Windows

أفضل طريقة لاستخدام redis-cli على كمبيوتر Windows هي تثبيت نظام Windows الفرعي لـ Linux (WSL). يسمح لك نظام Linux الفرعي بتشغيل أدوات linux مباشرة على Windows. لتثبيت WSL، اتبع إرشادات تثبيت WSL.

بمجرد تثبيت WSL، يمكنك تثبيت redis-cli باستخدام أي إدارة حزمة متوفرة في توزيعة Linux التي اخترتها ل WSL.

جمع معلومات الوصول إلى ذاكرة التخزين المؤقت

يمكنك جمع المعلومات المطلوبة للوصول إلى ذاكرة التخزين المؤقت باستخدام هذه الطرق:

في هذا القسم، يمكنك استرداد المفاتيح من مدخل Microsoft Azure.

الحصول على اسم المضيف والمنافذ ومفتاح الوصول

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

  • للحصول على مفتاح وصول لذاكرة التخزين المؤقت:

    1. في مدخل Microsoft Azure، انتقل إلى ذاكرة التخزين المؤقت.
    2. في قائمة الخدمة، ضمن Settings، حدد Authentication.
    3. في جزء Authentication ، حدد علامة التبويب Access keys .
    4. لنسخ قيمة مفتاح وصول، حدد أيقونة نسخ في حقل المفتاح.

    لقطة شاشة توضح كيفية البحث عن مفتاح وصول ونسخه لمثيل Azure Cache for Redis.

  • للحصول على اسم المضيف والمنافذ لذاكرة التخزين المؤقت الخاصة بك:

    1. في مدخل Microsoft Azure، انتقل إلى ذاكرة التخزين المؤقت.
    2. في قائمة الخدمة، حدد Overview.
    3. ضمن Essentials، بالنسبة إلى Host name، حدد رمز Copy لنسخ قيمة اسم المضيف. تحتوي قيمة اسم المضيف على النموذج <DNS name>.redis.cache.windows.net.
    4. بالنسبة إلى المنافذ، حدد الأيقونة نسخ لنسخ قيم المنفذ.

    لقطة شاشة توضح كيفية البحث عن اسم المضيف ومنافذه ونسخها لمثيل Azure Cache ل Redis.

الاتصال باستخدام redis-cli

افتح shell أو terminal على كمبيوتر مثبت عليه حزمة Redis. إذا كنت تستخدم WSL، يمكنك استخدام وحدة طرفية لـ Windows لفتح سطر أوامر Linux. قبل الاتصال ب redis-cli، تحقق مما يلي:

  1. ما إذا كانت هناك حاجة إلى الوصول إلى TLS - بشكل افتراضي، تستخدم Azure Cache لمثيلات Redis تشفير TLS للاتصالات. كلما تم استخدام TLS على جانب الخادم، يجب تمكين TLS على redis-cli باستخدام --tls الخيار .
  2. المنفذ المستخدم - تستخدم جميع ذاكرة التخزين المؤقت لطبقة Enterprise وEnterprise Flash المنفذ 10000. ومع ذلك، تستخدم ذاكرة التخزين المؤقت الأساسية والقياسية والمتميزة إما المنفذ 6379 للاتصالات غير TLS أو المنفذ 6380 لاتصالات TLS.
  3. ما إذا كان مثيل ذاكرة التخزين المؤقت يستخدم نظام المجموعة - إذا كنت تستخدم ذاكرة التخزين المؤقت للطبقة المتميزة التي تستخدم نظام المجموعة أو ذاكرة التخزين المؤقت لطبقة Enterprise/Enterprise Flash التي تستخدم نهج نظام مجموعة OSS، أضف -cالخيار لضمان إمكانية الوصول إلى جميع الأجزاء.

الأمثلة

  1. استخدم الأمر التالي للاتصال بطبقة أساسية أو قياسية أو متميزة Azure Cache لمثيل Redis باستخدام TLS:

    redis-cli -p 6380 -h yourcachename.redis.cache.windows.net -a YourAccessKey --tls
    
  2. الاتصال بمثيل Azure Cache ل Redis الأساسي أو القياسي أو المتميز الذي لا يستخدم TLS:

    redis-cli -p 6379 -h yourcachename.redis.cache.windows.net -a YourAccessKey
    
  3. الاتصال بمثيل ذاكرة التخزين المؤقت Azure ل Redis من المستوى الأساسي أو القياسي أو المتميز باستخدام TLS وتكوين أنظمة المجموعات:

    redis-cli -p 6380 -h yourcachename.redis.cache.windows.net -a YourAccessKey --tls -c
    
  4. الاتصال بمثيل ذاكرة التخزين المؤقت لطبقة Enterprise أو Enterprise Flash باستخدام نهج مجموعة المؤسسة مع TLS:

    redis-cli -p 10000 -h yourcachename.eastus.redisenterprise.cache.azure.net -a YourAccessKey --tls
    
  5. الاتصال بمثيل ذاكرة التخزين المؤقت لطبقة Enterprise أو Enterprise Flash باستخدام نهج مجموعة OSS دون TLS:

    redis-cli -p 10000 -h yourcachename.eastus.redisenterprise.cache.azure.net -a YourAccessKey -c
    

اختبار الاتصال

بمجرد تأسيس الاتصال، يمكنك إصدار أوامر إلى Azure Cache لمثيل Redis. إحدى الطرق السهلة لاختبار الاتصال هي استخدام PING الأمر . يرجع PONG هذا الأمر في وحدة التحكم.

yourcachename.redis.cache.windows.net:6380> PING
PONG

يمكنك أيضا تشغيل أوامر مثل SET و GET:

yourcachename.redis.cache.windows.net:6380> SET hello world
OK
yourcachename.redis.cache.windows.net:6380> GET hello
"world"

أنت الآن متصل ب Azure Cache لمثيل Redis باستخدام redis-cli.

بدائل redis-cli

في حين أن redis-cli هو أداة مفيدة، يمكنك الاتصال بذاكرة التخزين المؤقت بطرق أخرى لاستكشاف الأخطاء وإصلاحها أو الاختبار:

  • يوفر Azure Cache for Redis وحدة تحكم Redis مضمنة في مدخل Azure حيث يمكنك إصدار الأوامر دون الحاجة إلى تثبيت أداة سطر الأوامر. تتوفر ميزة Redis Console حاليا فقط في المستويات الأساسية والقياسية والمتميزة.
  • RedisInsight هو أداة رسومية غنية مصدر مفتوح لإصدار أوامر Redis وعرض محتويات مثيل Redis. وهو يعمل مع Azure Cache for Redis وهو مدعوم على Linux وWindows وmacOS.

ابدأ بإنشاء مثيل ذاكرة تخزين مؤقت جديد على مستوى المؤسسة.