مشاركة عبر

التشغيل السريع: استخدام Azure Redis مع تطبيق ويب ASP.NET

  • مقالة

في هذه البداية السريعة، يمكنك استخدام Visual Studio 2019 لإنشاء تطبيق ويب ASP.NET يتصل بـ Azure Cache لـ Redis لتخزين البيانات واستردادها من ذاكرة التخزين المؤقت. وبعد ذلك، ستقوم بنشر التطبيق إلى خدمة تطبيقات Azure.

انتقل إلى الكود على GitHub

استنسخ المستودع https://github.com/Azure-Samples/azure-cache-redis-samples/tree/main/quickstart/aspnet على GitHub.

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

إنشاء مثيل Azure Managed Redis (معاينة)

  1. لإنشاء مثيل Azure Managed Redis (معاينة)، سجل الدخول إلى مدخل Microsoft Azure وحدد Create a resource.

  2. في الصفحة New ، في مربع البحث اكتب Azure Cache for Redis.

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

    الإعدادات اختيار قيمة ‏‏الوصف
    الاشتراك اضغط على القائمة المنسدلة وحدد اشتراكك. الاشتراك الذي يتم بموجبه إنشاء مثيل Azure Managed Redis الجديد هذا.
    مجموعة الموارد حدد مجموعة موارد، أو حدد "إCreate new"، ثم أدخل اسماً فريداً لمجموعة الموارد الجديدة. اسم مجموعة الموارد المراد إنشاء ذاكرة التخزين المؤقت والموارد الأخرى فيها. وعبر وضع جميع موارد التطبيق في مجموعة موارد واحدة، يمكنك إدارتها أو حذفها بسهولة.
    اسم DNS أدخل اسما فريدا في المنطقة. يجب أن يكون اسم ذاكرة التخزين المؤقت سلسلة بين 1 و63 حرفا عند دمجها مع اسم منطقة ذاكرة التخزين المؤقت التي تحتوي على أرقام أو أحرف أو واصلات فقط. (إذا كان اسم ذاكرة التخزين المؤقت أقل من 45 حرفا، فيجب أن يعمل في جميع المناطق المتوفرة حاليا.) يجب أن يبدأ الاسم وينتهي برقم أو حرف، ولا يمكن أن يحتوي على واصلات متتالية. اسم مضيف مثيل ذاكرة التخزين المؤقت هو \<DNS name\>.\<Azure region\>.redis.azure.net.
    Location من القائمة المنسدلة، حدد موقعاً. يتوفر Azure Managed Redis في مناطق Azure المحددة.
    نوع ذاكرة التخزين المؤقت منسدلة وحدد مستوى الأداء وحجم ذاكرة التخزين المؤقت. يحدد المستوى أداء مثيل Redis، بينما يحدد حجم ذاكرة التخزين المؤقت الذاكرة المتوفرة لتخزين البيانات. للحصول على إرشادات حول اختيار مستوى الأداء الصحيح، راجع اختيار المستوى الصحيح

    لقطة شاشة تعرض علامة التبويب أساسيات Redis المدارة من Azure.

  4. حدد Next: Networking وحدد إما نقطة نهاية عامة أو خاصة.

  5. حدد Next: Advanced.

    قم بتكوين أي وحدات Redis النمطية التي تريد إضافتها إلى المثيل.

    بشكل افتراضي، لذاكرة تخزين مؤقت مدارة جديدة:

    • تم تمكين معرف Microsoft Entra.
    • تم تعطيل مصادقة مفاتيح الوصول لأسباب أمنية.

    هام

    للحصول على الأمان الأمثل، نوصي باستخدام معرف Microsoft Entra مع الهويات المدارة لتخويل الطلبات مقابل ذاكرة التخزين المؤقت إذا أمكن. يوفر التخويل باستخدام معرف Microsoft Entra والهويات المدارة أمانا فائقا وسهولة استخدام عبر تخويل مفتاح الوصول المشترك. لمزيد من المعلومات حول استخدام الهويات المدارة مع ذاكرة التخزين المؤقت، راجع استخدام معرف Microsoft Entra لمصادقة ذاكرة التخزين المؤقت.

    تعيين نهج التجميع إلى Enterprise لذاكرة تخزين مؤقت غير متفاوتة المسافات، أو إلى OSS لذاكرة تخزين مؤقت مجمعة. لمزيد من المعلومات حول اختيار نهج تكوين أنظمة المجموعات، راجع نهج نظام المجموعة.

    لقطة شاشة تعرض علامة التبويب Azure Managed Redis Advanced.

    إذا كنت تستخدم النسخ المتماثل الجغرافي النشط، فيجب تكوينه أثناء الإنشاء. لمزيد من المعلومات، راجع تكوين النسخ المتماثل الجغرافي النشط لمثيلات Azure Managed Redis.

    هام

    لا يمكنك تغيير نهج التجميع لمثيل Azure Managed Redis (معاينة) بعد إنشائه. إذا كنت تستخدم RediSearch، فإن نهج مجموعة المؤسسة مطلوب، NoEviction وهو نهج الإخلاء الوحيد المدعوم.

    هام

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

    هام

    لا يمكنك تغيير الوحدات النمطية بعد إنشاء مثيل ذاكرة التخزين المؤقت. يجب تمكين الوحدات النمطية عندما تقوم بإنشاء Azure Cache لمثيل Redis. لا يوجد خيار لتمكين تكوين وحدة نمطية بعد إنشاء ذاكرة التخزين المؤقت.

  6. حدد Next: Tags و skip.

  7. حدّد Next: Review + create.

  8. راجع الإعدادات وحدد Create.

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

إنشاء مثيل Azure Cache لـ Redis

  1. لإنشاء ذاكرة تخزين مؤقت، سجل الدخول إلى مدخل Microsoft Azure. في قائمة المدخل، حدد Create a resource.

    لقطة شاشة تعرض خيار إنشاء مورد مميز في جزء التنقل الأيمن في مدخل Microsoft Azure.

  2. في جزء بدء الاستخدام ، أدخل Azure Cache for Redis في شريط البحث. في نتائج البحث، ابحث عن ذاكرة التخزين المؤقت Azure ل Redis، ثم حدد إنشاء.

    لقطة شاشة تعرض Azure Marketplace مع ذاكرة التخزين المؤقت Azure ل Redis في مربع البحث، ويتم تمييز الزر إنشاء.

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

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

  4. حدد علامة التبويب Networking أو حدد Next: Networking.

  5. في علامة التبويب Networking ، حدد أسلوب اتصال لاستخدامه في ذاكرة التخزين المؤقت.

  6. حدد علامة التبويب خيارات متقدمة أو حدد التالي: خيارات متقدمة.

  7. في الجزء Advanced ، تحقق من أسلوب مصادقة أو حدده استنادا إلى المعلومات التالية:

    لقطة شاشة تعرض جزء Advanced والخيارات المتاحة للتحديد.

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

    هام

    للحصول على الأمان الأمثل، نوصي باستخدام معرف Microsoft Entra مع الهويات المدارة لتخويل الطلبات مقابل ذاكرة التخزين المؤقت إذا أمكن. يوفر التخويل باستخدام معرف Microsoft Entra والهويات المدارة أمانا فائقا وسهولة استخدام عبر تخويل مفتاح الوصول المشترك. لمزيد من المعلومات حول استخدام الهويات المدارة مع ذاكرة التخزين المؤقت، راجع استخدام معرف Microsoft Entra لمصادقة ذاكرة التخزين المؤقت.

  8. (اختياري) حدد علامة التبويب Tags أو حدد Next: Tags.

  9. (اختياري) في علامة التبويب Tags ، أدخل اسم علامة وقيمة إذا كنت تريد تصنيف مورد ذاكرة التخزين المؤقت.

  10. انقر فوق زر مراجعة + إنشاء.

    في علامة التبويب Review + create ، يتحقق Azure تلقائيا من صحة التكوين الخاص بك.

  11. بعد ظهور رسالة Validation passed الخضراء، حدد Create.

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

استخدام مصادقة معرف Microsoft Entra على ذاكرة التخزين المؤقت

تحتوي ذاكرة التخزين المؤقت Azure Redis، باستثناء مستويات Enterprise وEnterprise Flash، على تمكين مصادقة Microsoft Entra بشكل افتراضي. يتم تعطيل مفاتيح الوصول بشكل افتراضي.

هام

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

  1. في مدخل Microsoft Azure، حدد ذاكرة التخزين المؤقت حيث تريد استخدام المصادقة المستندة إلى الرمز المميز ل Microsoft Entra.

  2. حدد Authentication من قائمة Resource.

  3. حدد Select member وأدخل اسم مستخدم صالح. يتم تعيين نهج وصول مالك البيانات تلقائيا للمستخدم الذي تدخله بشكل افتراضي عند تحديد حفظ. يمكنك أيضا إدخال هوية مدارة أو كيان خدمة للاتصال بمثيل ذاكرة التخزين المؤقت.

    لقطة شاشة تعرض المصادقة المحددة في قائمة الموارد وتم التحقق من تمكين مصادقة Microsoft Entra.

للحصول على معلومات حول استخدام معرف Microsoft Entra مع Azure CLI، راجع الصفحات المرجعية للهوية.

تثبيت المكتبة لاستخدام Microsoft Entra ID Authentication

تحتوي مكتبة Azure.StackExchange.Redis على Microsoft باستخدام أسلوب مصادقة معرف Microsoft Entra للاتصال بخدمات Azure Redis باستخدام معرف Microsoft Entra. ينطبق على جميع Azure Cache for Redis وAzure Cache ل Redis Enterprise وAzure Managed Redis (معاينة).

  1. افتح مشروعك في Visual Studio

  2. انقر بزر الماوس الأيمن فوق المشروع، واختر إدارة حزم NuGet...

  3. ابحث عن Microsoft.Azure.StackExchangeRedis

  4. انقر فوق الزر "تثبيت " لتثبيته

  5. قبول كافة المحتويات التي تمت مطالبتها بإنهاء التثبيت

الاتصال بذاكرة التخزين المؤقت باستخدام معرف Microsoft Entra

  1. تضمين المكتبات في التعليمات البرمجية الخاصة بك

    using Azure.Identity;
using StackExchange.Redis

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

var configurationOptions = await ConfigurationOptions.Parse($"{_redisHostName}").ConfigureForAzureWithTokenCredentialAsync(new DefaultAzureCredential());
ConnectionMultiplexer _newConnection = await ConnectionMultiplexer.ConnectAsync(configurationOptions);
IDatabase Database = _newConnection.GetDatabase();

لتحرير ملف web.config

  1. قم بتحرير ملف Web.config بإضافة المحتوى التالي:

    <appSettings>
    <add key="RedisHostName" value="<cache-hostname-with-portnumber>"/>
</appSettings>

  2. استبدل <cache-hostname> باسم مضيف ذاكرة التخزين المؤقت كما يظهر في نظرة عامة على قائمة الموارد في مدخل Microsoft Azure.

    على سبيل المثال، باستخدام Azure Managed Redis أو مستويات المؤسسة: my-redis.eastus.azure.net:10000

  3. حفظ الملف.

لمزيد من المعلومات، راجع StackExchange.Redis والتعليمة البرمجية الموجودة في مستودع GitHub.

لتحرير ملف web.config

  1. قم بتحرير ملف Web.config بإضافة المحتوى التالي:

    <appSettings>
    <add key="RedisHostName" value="<cache-hostname-with-portnumber>"/>
</appSettings>

  2. استبدل <cache-hostname> باسم مضيف ذاكرة التخزين المؤقت كما يظهر في نظرة عامة على قائمة الموارد في مدخل Microsoft Azure.

    على سبيل المثال مع ذاكرة التخزين المؤقت Azure ل Redis، my-redis.eastus.azure.net:6380

  3. حفظ الملف.

لمزيد من المعلومات، راجع StackExchange.Redis والتعليمة البرمجية الموجودة في مستودع GitHub.

تشغيل التطبيق محليًا

تتم تهيئة المشروع افتراضيًا لاستضافة التطبيق محليًا في IIS Express لغرض الاختبار وتصحيح الأخطاء.

لتشغيل التطبيق محليًا

  1. في Visual Studio، اختر Debug>Start Debugging لبناء التطبيق وبدئه محليًا لغرض الاختبار وتصحيح الأخطاء.

  2. في المتصفح، اختر Azure Cache for Redis Test بشريط أدوات التصفح.

  3. في المثال التالي، كانت لدي المفتاح Message مسبقًا قيمة مُخزنة، والتي عُينت باستخدام Azure Cache لوحدة تحكم Redis في البوابة. قام التطبيق بتحديث تلك القيمة المخزنة. قام التطبيق أيضًا بتنفيذ PING وأوامر CLIENT LIST.

    لقطة شاشة للاختبار البسيط المكتمل محليا.

النشر والتشغيل في Azure

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

لنشر التطبيق إلى Azure

  1. في Visual Studio، انقر بزر الماوس الأيمن فوق عقدة المشروع في Solution Explorer. ثم اختر Publish.

    لقطة شاشة تعرض زر النشر.

  2. اختر Microsoft Azure App Service، ثم اختر Create New، وبعدها Publish.

    لقطة شاشة توضح كيفية النشر إلى App Service.

  3. في المربع الحواري Create App Service، قم بصنع التغييرات التالية:

    الإعدادات القيمة الموصى بها ‏‏الوصف
    اسم التطبيق استخدم الافتراضي. اسم التطبيق هو اسم المضيف للتطبيق عند نشره في Azure. قد تكون للاسم لاحقة طابع الزمني مضافة إليه لجعله فريدًا إذا لزم الأمر.
    الاشتراك اختر مُعرف اشتراك Azure الخاص بك. يتم احتساب هذا الاشتراك على أي تكاليف استضافة ذات صلة. إذا كان لديك العديد من اشتراكات Azure، فتحقق من تحديد الاشتراك الذي تريده.
    مجموعة الموارد استخدم نفس مجموعة الموارد التي أنشأت فيها ذاكرة التخزين المؤقتة. (على سبيل المثال، TestResourceGroup). تساعدك مجموعة الموارد في إدارة كافة الموارد كمجموعة. لاحقًا، عندما تريد حذف التطبيق، يمكنك حذف المجموعة فقط.
    خطة App Service اختر New، ثم قم بإنشاء خدمة تطبيق جديدة اسمها TestingPlan.
    استخدم نفس الموقع الذي استخدمته عند إنشاء ذاكرة التخزين المؤقتة.
    اختر Free لتحديد الحجم.    		 تحدد خطة خدمة التطبيق مجموعة من الموارد المحسوبة كي يعمل تطبيق الويب بواسطتها.

    لقطة شاشة تعرض مربع حوار App Service.

  4. بعد تهيئة إعدادات استضافة خدمة التطبيق، اختر Create.

  5. راقب نافذة المُخرج في Visual Studio لمعرفة حالة النشر. بعد نشر التطبيق، يتم تسجيل عنوان URL للتطبيق:

    لقطة شاشة لمعلومات النشر في جزء الإخراج.

إضافة إعداد التطبيق لذاكرة التخزين المؤقت

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

لإضافة إعداد التطبيق

  1. للعثور على التطبيق الجديد الذي أنشأته، اكتب اسم التطبيق في شريط البحث في أعلى مدخل Microsoft Azure.

    لقطة شاشة توضح كيفية العثور على التطبيق على مدخل Microsoft Azure.

  2. أضف إعداد تطبيق جديدًا اسمه CacheConnection للتطبيق كي تستخدمه للاتصال مع ذاكرة التخزين المؤقت. استخدم نفس القيمة التي قمت بتكوينها RedisHostName في ملف web.config.

تشغيل التطبيق في Azure

  1. في المتصفح، انتقل إلى عنوان URL للتطبيق. يظهر URL في نتائج عملية النشر في نافذة مُخرج Visual Studio. يتم توفير عنوان URL أيضا في مدخل Microsoft Azure في صفحة النظرة العامة للتطبيق الذي أنشأته.

  2. حدد Azure Cache for Redis Test على شريط التنقل لاختبار الوصول إلى ذاكرة التخزين المؤقت كما فعلت مع الإصدار المحلي.

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

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

وإلا، إذا انتهيت من الموارد، يمكنك حذف مجموعة موارد Azure التي قمت بإنشائها لتجنب الرسوم.

هام

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

لحذف مجموعة موارد

  1. سجل الدخول إلى مدخل Azure، وحدد "Resource groups".

  2. حدد مجموعة الموارد التي تريد حذفها.

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

    لقطة شاشة تعرض قائمة بمجموعات الموارد المراد حذفها في جزء العمل.

  3. حدد Delete resource group.

  4. يُطلب منك تأكيد حذف مجموعة الموارد. اكتب اسم مجموعة الموارد لتأكيده، واختر "Delete".

    لقطة شاشة تعرض نموذجا يتطلب اسم المورد لتأكيد الحذف.

بعد مرور لحظات قليلة، يتم حذف مجموعة الموارد وجميع مواردها.

المحتوى ذو الصلة