إشعار
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تسجيل الدخول أو تغيير الدلائل.
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تغيير الدلائل.
في هذا البدء السريع، تستخدم Azure CLI لإنشاء موضوع مخصص في Azure Event Grid، ثم تشترك في الموضوع المخصص، وتفعل حدث نموذجي لعرض النتيجة.
وعادةً، ما ترسل الأحداث إلى نقطة نهاية تعالج بيانات الحدث وتتخذ الإجراءات. ومع ذلك، لتبسيط هذا البدء السريع، ترسل عينات من الأحداث إلى تطبيق ويب يجمع ويعرض الرسائل. عند الانتهاء، ترى بيانات الأحداث في تطبيق الويب، كما هو موضح في الصورة التالية:
إذا لم يكن لديك حساب Azure، فأنشئ حساباً مجانياً قبل أن تبدأ.
المتطلبات الأساسية
استخدم بيئة Bash في Azure Cloud Shell. لمزيد من المعلومات، راجع بدء استخدام Azure Cloud Shell.
إذا كنت تفضل تشغيل أوامر مرجع CLI محلياً قم بتثبيت CLI Azure. إذا كنت تعمل على نظام تشغيل Windows أو macOS، ففكر في تشغيل Azure CLI في حاوية Docker. لمزيد من المعلومات، راجع كيفية تشغيل Azure CLI في حاوية Docker.
إذا كنت تستخدم تثبيت محلي، يُرجى تسجيل الدخول إلى Azure CLI مستخدمًا أمر az login. لإنهاء عملية المصادقة، اتبع الخطوات المعروضة في جهازك. للحصول على خيارات تسجيل الدخول الأخرى، راجع المصادقة على Azure باستخدام Azure CLI.
عندما يُطلب منك، قم بتثبيت ملحق Azure CLI عند الاستخدام لأول مرة. لمزيد من المعلومات حول الملحقات، راجع استخدام الملحقات وإدارتها باستخدام Azure CLI.
يُرجى تشغيل إصدار az للوصول إلى الإصدار والمكتبات التابعة التي تم تثبيتها. للتحديث لآخر إصدار، يُرجى تشغيل تحديث az.
- يتطلب هذا البدء السريع إصدار 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
إذا كانت هذه هي المرة الأولى التي تستخدم فيها Event Grid في اشتراك Azure، فقد تحتاج إلى تسجيل موفر موارد Event Grid. قم بتشغيل الأمر التالي لتسجيل الموفر :
az provider register --namespace Microsoft.EventGridقد يستغرق التسجيل بعض الوقت. للتحقق من الحالة، قم بتشغيل الأمر التالي:
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، و"-"
انسخ الأمر التالي، وحدد اسما للموضوع، واختر Enter لتشغيل الأمر.
topicname=<your-topic-name>az eventgrid topic createاستخدم الأمر لإنشاء موضوع مخصص.az eventgrid topic create --name $topicname -l westus2 -g gridResourceGroup
قم بإنشاء نقطة نهاية للرسالة
قبل الاشتراك في الموضوع المخصص، قم بإنشاء نقطة النهاية لرسالة الحدث. عادةً ما تتخذ نقطة النهاية إجراءات بناءً على بيانات الحدث. لتبسيط هذا البدء السريع، قم بنشر تطبيق ويب جاهز يعرض رسائل الأحداث. يتضمن الحل المنشور خطة خدمة التطبيقات، وتطبيق الويب الخاص بخدمة التطبيقات، وكود المصدر من GitHub.
انسخ الأمر التالي، وحدد اسما لتطبيق الويب (عينة عارض شبكة الأحداث)، واختر Enter لتشغيل الأمر. استبدل
<your-site-name>باسم فريد من أجل تطبيق الويب الخاص بك. يجب أن يكون اسم تطبيق الويب فريدًا؛ لأنه جزء من إدخال DNS.sitename=<your-site-name>قم بتشغيل
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/.
انسخ الأمر التالي، استبداله
$sitenameباسم تطبيق الويب الذي أنشأته في الخطوة السابقة، واختر Enter لتشغيل الأمر.endpoint=https://$sitename.azurewebsites.net/api/updatesقم بتشغيل الأمر التالي للحصول على معرف المورد للموضوع الذي قمت بإنشائه.
topicresourceid=$(az eventgrid topic show --resource-group gridResourceGroup --name $topicname --query "id" --output tsv)قم بتشغيل الأمر التالي لإنشاء اشتراك في الموضوع المخصص باستخدام نقطة النهاية.
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
المحتوى ذو الصلة
الآن بعد أن عرفت كيفية إنشاء مواضيع مخصصة واشتراكات الأحداث، تعرف على المزيد حول ما يمكن أن تساعدك شبكة الأحداث على القيام به:
- حول شبكة الأحداث
- توجيه أحداث تخزين Blob إلى نقطة نهاية ويب مخصصة
- نقل البيانات الكبيرة إلى مستودع البيانات
للتعرف على نشر الأحداث واستهلاكها من Event Grid بلغات برمجة مختلفة، راجع العينات التالية: