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

في هذا البدء السريع، تستخدم Azure CLI لإنشاء موضوع مخصص في Azure Event Grid، ثم تشترك في الموضوع المخصص، وتفعل حدث نموذجي لعرض النتيجة.

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

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

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

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

  • يتطلب هذا البدء السريع إصدار 2.0.70 أو أحدث من Azure CLI. إذا كنت تستخدم Azure Cloud Shell، فإن أحدث إصدار مثبت بالفعل.
  • إذا كنت جديدا على Azure Event Grid، راجع What's Azure Event Grid للحصول على نظرة عامة على الخدمة قبل بدء هذه البداية السريعة.

إنشاء مجموعة موارد

مواضيع Event Grid هي موارد Azure يجب وضعها في مجموعة موارد Azure. مجموعة الموارد هي مجموعة منطقية تقوم بنشر وإدارة موارد Azure فيها.

أنشئ مجموعة موارد باستخدام الأمر az group create. ينشئ المثال التالي مجموعة موارد باسم gridResourceGroup في موقع westus2. غير اسم مجموعة الموارد والموقع إذا أردت.

az group create --name gridResourceGroup --location westus2

قم بتمكين مزود موارد Event Grid

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

    az provider register --namespace Microsoft.EventGrid
    
  2. قد يستغرق التسجيل بعض الوقت. للتحقق من الحالة، قم بتشغيل الأمر التالي:

    az provider show --namespace Microsoft.EventGrid --query "registrationState"
    

    عندما registrationStateيكونRegistered، كنت على استعداد للمتابعة.

إنشاء موضوع مخصص

يوفر موضوع Event Grid نقطة نهاية معرّفة من قِبل المستخدم تقوم بنشر الأحداث إليها. المثال التالي ينشئ الموضوع المخصص في مجموعة الموارد الخاصة بك باستخدام Bash في Azure Cloud Shell. استبدل <your-topic-name> باسم فريد لموضوعك: يجب أن يكون اسم الموضوع المخصص فريدا لأنه جزء من إدخال نظام أسماء المجالات (DNS). أيضا، يجب أن يكون بين 3-50 حرفا ويحتوي فقط على القيم a-z، A-Z، 0-9، و"-"

  1. انسخ الأمر التالي، وحدد اسما للموضوع، واختر Enter لتشغيل الأمر.

    topicname=<your-topic-name>
    
  2. az eventgrid topic create استخدم الأمر لإنشاء موضوع مخصص.

    az eventgrid topic create --name $topicname -l westus2 -g gridResourceGroup
    

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

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

  1. انسخ الأمر التالي، وحدد اسما لتطبيق الويب (عينة عارض شبكة الأحداث)، واختر Enter لتشغيل الأمر. استبدل <your-site-name> باسم فريد من أجل تطبيق الويب الخاص بك. يجب أن يكون اسم تطبيق الويب فريدًا؛ لأنه جزء من إدخال DNS.

    sitename=<your-site-name>
    
  2. قم بتشغيل az deployment group create تطبيق الويب لنشر التطبيق باستخدام قالب Azure Resource Manager.

    az deployment group create \
      --resource-group gridResourceGroup \
      --template-uri "https://raw.githubusercontent.com/Azure-Samples/azure-event-grid-viewer/main/azuredeploy.json" \
      --parameters siteName=$sitename hostingPlanName=viewerhost
    

قد يستغرق انتهاء النشر بضع دقائق. بعد نجاح النشر، اعرض تطبيق الويب للتأكد من أنه قيد التشغيل. في مستعرض ويب، انتقل إلى: https://<your-site-name>.azurewebsites.net

يجب أن ترى الموقع بدون أي رسائل.

الاشتراك في موضوع مخصص

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

ينبغي أن تتضمن نقطة النهاية لتطبيق الويب الخاص بك اللاحقة /api/updates/.

  1. انسخ الأمر التالي، استبداله $sitename باسم تطبيق الويب الذي أنشأته في الخطوة السابقة، واختر Enter لتشغيل الأمر.

    endpoint=https://$sitename.azurewebsites.net/api/updates
    
  2. قم بتشغيل الأمر التالي للحصول على معرف المورد للموضوع الذي قمت بإنشائه.

    topicresourceid=$(az eventgrid topic show --resource-group gridResourceGroup --name $topicname --query "id" --output tsv)
    
  3. قم بتشغيل الأمر التالي لإنشاء اشتراك في الموضوع المخصص باستخدام نقطة النهاية.

    az eventgrid event-subscription create \
      --source-resource-id $topicresourceid \
      --name demoViewerSub \
      --endpoint $endpoint
    

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

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

أرسل حدث إلى موضوعك المُخصص

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

endpoint=$(az eventgrid topic show --name $topicname -g gridResourceGroup --query "endpoint" --output tsv)
key=$(az eventgrid topic key list --name $topicname -g gridResourceGroup --query "key1" --output tsv)

لتبسيط هذا البدء السريع، استخدم بيانات الأحداث النموذجية لإرسالها إلى الموضوع المخصص. عادة، يرسل تطبيق أو خدمة Azure بيانات الحدث. ينشئ المثال التالي نموذج بيانات الحدث:

event='[ {"id": "'"$RANDOM"'", "eventType": "recordInserted", "subject": "myapp/vehicles/motorcycles", "eventTime": "'`date +%Y-%m-%dT%H:%M:%S%z`'", "data":{ "make": "Ducati", "model": "Monster"},"dataVersion": "1.0"} ]'

يكون عنصر data JSON هو حمولة الحدث. يمكن لأي JSON تم تشكيله بشكل جيد أن يذهب في هذا المجال. يمكنك أيضًا استخدام حقل الموضوع للتوجيه والتصفية المتقدمين.

cURL هي أداة ترسل طلبات HTTP. في هذا البدء السريع، استخدم cURL لإرسال الحدث إلى الموضوع.

curl -X POST -H "aeg-sas-key: $key" -d "$event" $endpoint

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

[{
  "id": "1807",
  "eventType": "recordInserted",
  "subject": "myapp/vehicles/motorcycles",
  "eventTime": "2017-08-10T21:03:07+00:00",
  "data": {
    "make": "Ducati",
    "model": "Monster"
  },
  "dataVersion": "1.0",
  "metadataVersion": "1",
  "topic": "/subscriptions/{subscription-id}/resourceGroups/{resource-group}/providers/Microsoft.EventGrid/topics/{topic}"
}]

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

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

az group delete --name gridResourceGroup --yes --no-wait

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

للتعرف على نشر الأحداث واستهلاكها من Event Grid بلغات برمجة مختلفة، راجع العينات التالية: