مشاركة عبر

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

  • مقالة

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

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

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

لقطة شاشة تعرض نموذج تطبيق Azure Event Grid Viewer مع حدث.

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

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

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

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

    لقطة شاشة تعرض البحث عن حساب التخزين في صفحة إنشاء مورد.

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

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

    1. حدد اشتراك Azure الخاص بك.

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

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

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

    5. بالنسبة للخدمة الأساسية، حدد Azure Blob Storage أو Azure Data Lake Storage Gen 2.

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

    7. حدد مراجعة + إنشاء عند أسفل الصفحة.

      لقطة شاشة تظهر صفحة إنشاء حساب تخزين.

    8. في علامة التبويب Review + create ، راجع الإعدادات، وحدد Create.

      إشعار

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

  6. يستغرق النشر بضع دقائق لإكماله. في صفحة Deployment ، حدد Go to resource.

    لقطة شاشة تعرض صفحة نجاح التوزيع مع ارتباط للانتقال إلى المورد.

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

    لقطة شاشة تعرض صفحة الأحداث لحساب تخزين Azure.

  8. احتفظ بهذه الصفحة في مستعرض الويب مفتوحا.

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

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

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

    زر لنشر قالب Resource Manager إلى Azure.

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

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

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

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

    4. حدد "Review + create".

      لقطة شاشة تعرض صفحة التوزيع المخصصة.

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

  4. يستغرق النشر بضع دقائق لإكماله. في صفحة Deployment ، حدد Go to resource group.

    لقطة شاشة تعرض صفحة نجاح التوزيع مع ارتباط للانتقال إلى مجموعة الموارد.

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

    لقطة شاشة تعرض تحديد تطبيق الويب في مجموعة الموارد.

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

    لقطة شاشة تعرض تحديد الارتباط للانتقال إلى تطبيق الويب.

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

    عرض موقع جديد.

    هام

    احتفظ بنافذة Azure Event Grid Viewer مفتوحة حتى تتمكن من رؤية الأحداث عند نشرها.

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

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

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

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

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

    لقطة شاشة تعرض تحديد Web Hook في صفحة الأحداث.

  4. في صفحة إنشاء اشتراك حدث، قم بتنفيذ الخطوات التالية:

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

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

    3. تأكد من تعيين نوع نقطة النهاية إلى Web Hook.

      لقطة شاشة تعرض صفحة إنشاء اشتراك حدث باسم لموضوع النظام.

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

    لقطة شاشة تعرض صفحة تحديد Web Hook.

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

    لقطة شاشة تعرض صفحة إنشاء اشتراك حدث مع تحديد كافة الحقول.

  7. اعرض تطبيق الويب الخاص بك مرة أخرى، ولاحظ أنه يتم إرسال حدث التحقق من صحة الاشتراك إليه. حدد أيقونة العين لتوسيع بيانات الحدث. ترسل Event Grid حدث التحقق؛ بحيث تتمكن نقطة النهاية من التحقق من رغبتها في تلقي بيانات الحدث. يتضمن تطبيق الويب رمزًا للتحقق من صحة الاشتراك.

    لقطة شاشة تعرض عارض شبكة الأحداث مع حدث التحقق من صحة الاشتراك.

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

إرسال حدث إلى نقطة النهاية

تشغل حدث مخزن Blob عن طريق تحميل ملف. لا يحتاج الملف إلى أي محتوى محدد.

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

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

    لقطة شاشة تعرض صفحة حاوية جديدة.

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

    لقطة شاشة تعرض تحديد الحاوية.

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

    لقطة شاشة تعرض صفحة Upload blob لتحميل صورة عينة.

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

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

    لقطة شاشة تعرض صفحة عارض شبكة الأحداث مع الحدث إنشاء كائن ثنائي كبير الحجم.

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

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

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

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

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