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

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

هناك أيضا موفرو التخزين المؤقت في .NET core. لبدء استخدام Redis بسرعة مع الحد الأدنى من التغييرات على التعليمات البرمجية الموجودة، راجع:

• موفر ذاكرة التخزين المؤقت للإخراج الأساسي ASP.NET
• ASP.NET موفر التخزين المؤقت الموزع الأساسي
• ASP.NET موفر جلسة Redis الأساسي

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

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

كخطوة تالية، يمكنك مشاهدة تطبيق eShop للسيناريو في العالم الحقيقي يوضح موفري التخزين المؤقت الأساسي ASP.NET: ASP.NET eShop الأساسي باستخدام موفري التخزين المؤقت Redis.

الميزات المضمنة:

• التخزين المؤقت الموزع ل Redis
• موفر حالة جلسة عمل Redis

توجد إرشادات النشر في README.md.

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

• اشتراك Azure - إنشاء اشتراك مجاني
• .NET Core SDK

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

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.

  

دون ملاحظة HOST NAME ومفتاح الوصول الأساسي. يمكنك استخدام هذه القيم في وقت لاحق لبنية بيانات سرية CacheConnection.

أضف بيانات سرية محليًا لسلسلة الاتصال

في نافذة الأوامر الخاصة بك، نفذ الأمر التالي لتخزين بيانات سرية جديدة تسمى CacheConnection، بعد استبدال العناصر الفرعية، بما في ذلك أقواس الزاوية، لاسم ذاكرة التخزين المؤقت ومفتاح الوصول الأساسي:

dotnet user-secrets set CacheConnection "<cache name>.redis.cache.windows.net,abortConnect=false,ssl=true,allowAdmin=true,password=<primary-access-key>"

الاتصال مع ذاكرة التخزين المؤقت مع RedisConnection

RedisConnection تدير الفئة الاتصال بذاكرة التخزين المؤقت. يرد الربط في HomeController.csهذا البيان في مجلد المراقبين:

_redisConnection = await _redisConnectionFactory;

في RedisConnection.cs، ترى StackExchange.Redis أن مساحة الاسم تمت إضافتها إلى التعليمات البرمجية. هذا مطلوب للفئةRedisConnection.

using StackExchange.Redis;

RedisConnection تضمن التعليمات البرمجية وجود اتصال سليم دائما بذاكرة التخزين المؤقت عن طريق إدارة المثيل ConnectionMultiplexer من StackExchange.Redis. تقوم الفئة RedisConnection بإعادة إنشاء الاتصال عند فقد الاتصال وتعذر إعادة الاتصال تلقائيًا.

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

طرق عرض التخطيط في العينة

يتم تخزين تخطيط الصفحة الرئيسية لهذا النموذج في ملف _Layout.cshtml. من هذه الصفحة، تبدأ اختبار ذاكرة التخزين المؤقت الفعلي بالنقر على Azure Cache for Redis Test من هذه الصفحة.

1. قم بفتح Views\Shared\_Layout.cshtml.

2. يجب أن ترى<div class="navbar-header">:

   <a class="navbar-brand" asp-area="" asp-controller="Home" asp-action="RedisCache">Azure Cache for Redis Test</a>
   

إظهار البيانات من ذاكرة التخزين المؤقت

من الصفحة الرئيسية، ستحدد Azure Cache for Redis Test لمشاهدة عينة الإخراج.

1. في Solution Explorer، قم بتوسيع مجلد Views ثم انقر بزر الماوس الأيمن على مجلد Home.

2. يجب أن تشاهد هذه التعليمة البرمجية في ملف RedisCache.cshtml.

   @{
       ViewBag.Title = "Azure Cache for Redis Test";
   }
   
   <h2>@ViewBag.Title.</h2>
   <h3>@ViewBag.Message</h3>
   <br /><br />
   <table border="1" cellpadding="10">
       <tr>
           <th>Command</th>
           <th>Result</th>
       </tr>
       <tr>
           <td>@ViewBag.command1</td>
           <td><pre>@ViewBag.command1Result</pre></td>
       </tr>
       <tr>
           <td>@ViewBag.command2</td>
           <td><pre>@ViewBag.command2Result</pre></td>
       </tr>
       <tr>
           <td>@ViewBag.command3</td>
           <td><pre>@ViewBag.command3Result</pre></td>
       </tr>
       <tr>
           <td>@ViewBag.command4</td>
           <td><pre>@ViewBag.command4Result</pre></td>
       </tr>
       <tr>
           <td>@ViewBag.command5</td>
           <td><pre>@ViewBag.command5Result</pre></td>
       </tr>
   </table>
   

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

1. نفذ الأمر التالي في نافذة الأوامر الخاص بك لإنشاء التطبيق:

   dotnet build
   

2. ثم قم بتشغيل التطبيق مع الأمر التالي:

   dotnet run
   

3. افتح المتصفح https://localhost:5001 في متصفح الويب لديك.

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

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

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

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

هام

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

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

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

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

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

   

3. حدد Delete resource group.

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

   

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

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

• مرونة الاتصال
• تطوير أفضل ممارسات