استخدام أداة سطر الأوامر 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.
جمع معلومات الوصول إلى ذاكرة التخزين المؤقت
يمكنك جمع المعلومات المطلوبة للوصول إلى ذاكرة التخزين المؤقت باستخدام هذه الطرق:
- Azure CLI باستخدام مفاتيح قائمة az redis
- Azure PowerShell باستخدام Get-AzRedisCacheKey
- استخدام مدخل Microsoft Azure
في هذا القسم، يمكنك استرداد المفاتيح من مدخل Microsoft Azure.
الحصول على اسم المضيف والمنافذ ومفتاح الوصول
للاتصال بخادم Azure Cache for Redis، يحتاج عميل ذاكرة التخزين المؤقت إلى اسم مضيف ذاكرة التخزين المؤقت والمنافذ ومفتاح الوصول. قد يشير بعض العملاء إلى هذه العناصر باستخدام أسماء مختلفة قليلا. يمكنك الحصول على اسم المضيف والمنافذ والمفاتيح في مدخل Microsoft Azure.
للحصول على مفتاح وصول لذاكرة التخزين المؤقت:
- في مدخل Microsoft Azure، انتقل إلى ذاكرة التخزين المؤقت.
- في قائمة الخدمة، ضمن Settings، حدد Authentication.
- في جزء Authentication ، حدد علامة التبويب Access keys .
- لنسخ قيمة مفتاح وصول، حدد أيقونة نسخ في حقل المفتاح.
للحصول على اسم المضيف والمنافذ لذاكرة التخزين المؤقت الخاصة بك:
- في مدخل Microsoft Azure، انتقل إلى ذاكرة التخزين المؤقت.
- في قائمة الخدمة، حدد Overview.
- ضمن Essentials، بالنسبة إلى Host name، حدد رمز Copy لنسخ قيمة اسم المضيف. تحتوي قيمة اسم المضيف على النموذج
<DNS name>.redis.cache.windows.net
. - بالنسبة إلى المنافذ، حدد الأيقونة نسخ لنسخ قيم المنفذ.
الاتصال باستخدام redis-cli
افتح shell أو terminal على كمبيوتر مثبت عليه حزمة Redis. إذا كنت تستخدم WSL، يمكنك استخدام وحدة طرفية لـ Windows لفتح سطر أوامر Linux. قبل الاتصال ب redis-cli، تحقق مما يلي:
- ما إذا كانت هناك حاجة إلى الوصول إلى TLS - بشكل افتراضي، تستخدم Azure Cache لمثيلات Redis تشفير TLS للاتصالات. كلما تم استخدام TLS على جانب الخادم، يجب تمكين TLS على redis-cli باستخدام
--tls
الخيار . - المنفذ المستخدم - تستخدم جميع ذاكرة التخزين المؤقت لطبقة Enterprise وEnterprise Flash المنفذ
10000
. ومع ذلك، تستخدم ذاكرة التخزين المؤقت الأساسية والقياسية والمتميزة إما المنفذ6379
للاتصالات غير TLS أو المنفذ6380
لاتصالات TLS. - ما إذا كان مثيل ذاكرة التخزين المؤقت يستخدم نظام المجموعة - إذا كنت تستخدم ذاكرة التخزين المؤقت للطبقة المتميزة التي تستخدم نظام المجموعة أو ذاكرة التخزين المؤقت لطبقة Enterprise/Enterprise Flash التي تستخدم نهج نظام مجموعة OSS، أضف
-c
الخيار لضمان إمكانية الوصول إلى جميع الأجزاء.
الأمثلة
استخدم الأمر التالي للاتصال بطبقة أساسية أو قياسية أو متميزة Azure Cache لمثيل Redis باستخدام TLS:
redis-cli -p 6380 -h yourcachename.redis.cache.windows.net -a YourAccessKey --tls
الاتصال بمثيل Azure Cache ل Redis الأساسي أو القياسي أو المتميز الذي لا يستخدم TLS:
redis-cli -p 6379 -h yourcachename.redis.cache.windows.net -a YourAccessKey
الاتصال بمثيل ذاكرة التخزين المؤقت Azure ل Redis من المستوى الأساسي أو القياسي أو المتميز باستخدام TLS وتكوين أنظمة المجموعات:
redis-cli -p 6380 -h yourcachename.redis.cache.windows.net -a YourAccessKey --tls -c
الاتصال بمثيل ذاكرة التخزين المؤقت لطبقة Enterprise أو Enterprise Flash باستخدام نهج مجموعة المؤسسة مع TLS:
redis-cli -p 10000 -h yourcachename.eastus.redisenterprise.cache.azure.net -a YourAccessKey --tls
الاتصال بمثيل ذاكرة التخزين المؤقت لطبقة 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.
المحتوى ذو الصلة
ابدأ بإنشاء مثيل ذاكرة تخزين مؤقت جديد على مستوى المؤسسة.