استخدام Azure Event Grid لإرسال أحداث تخزين Blob إلى نقطة نهاية الويب (مدخل Azure)

  • مقالة
  • قراءة خلال 4 دقائق

Event Grid هي خدمة مدارة بالكامل تمكنك من إدارة الأحداث بسهولة عبر العديد من خدمات وتطبيقات Azure المختلفة. إنها تبسط بناء التطبيقات المستندة إلى الحدث وبلا خادم. للحصول على نظرة عامة عن الخدمة، راجع نظرة عامة على Event Grid.

في هذه المقالة، يمكنك استخدام مدخل Azure لأداء المهام التالية:

  1. إنشاء حساب تخزين بيانات Blob.
  2. الاشتراك في الأحداث لتخزين blob.
  3. تشغيل حدث عن طريق تحميل ملف إلى تخزين blob.
  4. عرض النتيجة في تطبيق ويب معالج. عموماً، يمكنك إرسال الأحداث إلى نقطة نهاية تعالج بيانات الحدث، وتتخذ الإجراءات. لتبسيط الأمر، يمكنك إرسال الأحداث إلى تطبيق ويب يجمع الرسائل ويعرضها.

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

عند الانتهاء من ذلك، سوف ترى أنه تم إرسال بيانات الحدث إلى تطبيق الويب.

View results.

إنشاء حساب تخزين

  1. تسجيل الدخول إلى مدخل Azure .

  2. لإنشاء تخزين Blob، حدد Create a resource.

  3. في Search، أدخل Storage account، وحدد Storage account من قائمة النتائج.

    Screenshot showing the search for Storage account on the Create a resource page.

  4. في الصفحة Storage account حدد Create لبدء إنشاء حساب التخزين. للاشتراك في الأحداث، بادر بإنشاء حساب تخزين V2 للأغراض العامة أو حساب تخزين Blob.

  5. في الصفحة Create storage account، بادر باتخاذ الخطوات التالية:

    1. حدد اشتراكك في Azure.

    2. بالنسبة لمجموعة الموارد، أنشئ مجموعة موارد جديدة أو مجموعة موجودة.

    3. أدخل اسماً مميزاً لحساب التخزين خاصتك.

    4. حدد Region التي تريد إنشاء حساب التخزين فيها.

    5. بالنسبة لخيار Redundancy، حدد Locally-redundant storage (LRS) من القائمة المنسدلة.

    6. حدد Review + create.

      Screenshot showing the Create a storage account page.

    7. في الصفحة Review + create راجع الإعدادات، وحدد Create.

      ملاحظة

      حسابات التخزين فقط من نوع StorageV2 (الأغراض العامة v2) و BlobStorage تدعم دمج الحدث. التخزين (v1 للأغراض العامة)لا يدعم التكامل مع شبكة الأحداث.

قم بإنشاء نقطة نهاية للرسالة

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

  1. حدد Deploy to Azure لنشر الحل في اشتراكك.

    Button to deploy to Azure.

  2. في الصفحة Custom deployment، بادر باتخاذ الخطوات التالية:

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

    2. بالنسبة إلى اسم الموقع، أدخل اسماً لتطبيق الويب.

    3. بالنسبة إلى اسم خطة الاستضافة، أدخل اسماً لخطة خدمة التطبيقات لاستخدامها لاستضافة تطبيق الويب.

    4. حدد Review + create.

      Screenshot showing the Custom deployment page.

  3. في صفحة مراجعة+ إنشاء حدد إنشاء.

  4. قد يستغرق النشر بضع دقائق حتى يكتمل. حدد التنبيهات (أيقونة الجرس) في المدخل، ثم حدد Go to resource group.

    Alert - navigate to resource group.

  5. في الصفحة Resource group، في قائمة الموارد، حدد تطبيق الويب الذي أنشأته. كما ترى أيضاً خطة App Service وحساب التخزين في هذه القائمة.

    Select web site.

  6. في الصفحة App Service لتطبيق الويب الخاص بك، حدد عنوان URL للانتقال إلى موقع الويب. يجب أن يكون عنوان URL بهذا الشكل: https://<your-site-name>.azurewebsites.net.

    Navigate to web site.

  7. تأكد من رؤية الموقع مع عدم نشر أي أحداث عليه حتى الآن.

    View new site.

تمكين موفر موارد Event Grid

إذا لم تكن قد استخدمت Event Grid في اشتراك Azure من قبل، فقد تحتاج إلى تسجيل موفر موارد Event Grid.

في مدخل Azure:

  1. حدد Subscriptions في القائمة اليمنى.
  2. حدد الاشتراك الذي تستخدمه لـ Event Grid.
  3. في القائمة اليسرى، ضمن Settings، حدد Resource providers.
  4. ابحث عن Microsoft.EventGrid.
  5. إذا لم تكن مسجلاً، فحدد Register.

قد يستغرق التسجيل لحظات حتى ينتهي. حدد Refresh لتحديث الحالة. عندما تتحول Status إلى Registered تصبح مستعدًا للمتابعة.

الاشتراك في تخزين Blob

تشترك في موضوع لإخبار Event Grid بالأحداث التي تريد تعقبها، ومكان إرسال هذه الأحداث.

  1. في المدخل، انتقل إلى حساب Azure Storage التي أنشأته سابقاً. في القائمة اليسرى، حدد All resources وحدد حساب التخزين خاصتك.

  2. في الصفحة Storage account، حدد Eventsفي القائمة اليسرى.

  3. حدد More Options، و Web Hook. ترسل أحداث إلى تطبيق العارض خاصتك باستخدام إخطار على الويب لنقطة النهاية.

    Select web hook.

  4. في صفحة Create Event Subscription، بادر بتنفيذ الخطوات التالية:

    1. أدخل اسماً للاشتراك في الحدث.

    2. أدخل اسماً لـ موضوع النظام. للتعرف على موضوعات النظام، راجع نظرة عامة على موضوعات النظام.

      Enter names for event subscription and system topic.

    3. حدد Web Hook في Endpoint type.

      Select web hook endpoint type.

  5. بالنسبة لـ Endpoint، انقر فوق Select an endpoint، وأدخِل عنوان URL لتطبيق الويب خاصتك وأضِف api/updates إلى عنوان URL الخاص بالصفحة الرئيسية (على سبيل المثال: https://spegridsite.azurewebsites.net/api/updates)، ثم حدد Confirm Selection.

    Confirm endpoint selection.

  6. الآن، في صفحة Create Event Subscription، حدد Create لإنشاء اشتراك الحدث.

    Select logs.

  7. اعرض تطبيق الويب الخاص بك مرة أخرى، ولاحظ أنه تم إرسال حدث التحقق من الاشتراك إليه. حدد أيقونة العين لتوسيع بيانات الحدث. ترسل شبكة الأحداث حدث التحقق بحيث يمكن التحقق من نقطة النهاية التي تريد تلقي بيانات الحدث. يتضمن تطبيق الويب تعليمة برمجية للتحقق من صحة الاشتراك.

    View subscription event.

الآن، لنبادر بتشغيل حدث لمعرفة كيف توزع Event Grid الرسالة إلى نقطة النهاية لديك.

إرسال حدث إلى نقطة النهاية خاصتك

تشغل حدث مخزن Blob عن طريق تحميل ملف. لا يحتاج الملف إلى أي محتوى محدد. تفترض المقالات أن لديك ملفاً يُسمى testfile.txt، ولكن يمكنك استخدام أي ملف.

  1. في مدخل Azure، انتقل إلى حساب تخزين Blob خاصتك وحدد Containers في قائمة السماح.

  2. حدد + Container. أعط الحاوية اسماً، واستخدم أي مستوى وصول، وحدد Create.

    Add container.

  3. حدد حاويتك الجديدة.

    Select container.

  4. لتحميل ملف، حدد Upload. في صفحة Upload blob، استعرض وحدد ملفاً تريد تحميله للاختبار، ثم حدد Upload على تلك الصفحة.

    Select upload.

  5. استعرض للوصول إلى ملف الاختبار خاصتك وحمِّله.

  6. لقد شغلت الحدث، وأرسلت Event Grid الرسالة إلى نقطة النهاية التي كونتها عند الاشتراك. الرسالة بتنسيق JSON وتحتوي على صفيف ذي حدثٍ واحدٍ أو أكثر. في المثال التالي، تحتوي رسالة JSON على صفيف ذي حدثٍ واحدٍ. اعرض تطبيق الويب ولاحظ استلام حدث إنشاء blob.

    Blob created event.

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

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

حدد مجموعة الموارد، ثم حدد Delete resource group.

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

الآن بعد أن عرفت كيفية إنشاء مواضيع مخصصة واشتراكات أحداث، تعرف على المزيد عما يمكن أن تساعدك Event Grid على فعله: