مشاركة عبر

وجهات معالجات الأحداث في Event Grid على Kubernetes

  • مقالة

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

طريقة تهيئة Event Grid لإرسال الأحداث إلى وجهة من خلال إنشاء اشتراك في حدث. ويمكن تنفيذ ذلك من خلال Azure CLI أو إدارة حزمة تطوير البرامج أو استخدام المكالمات HTTPs المباشرة باستخدام إصدار 2020-10-15-معاينة واجهة برمجة التطبيقات.

وبصفة عامة، يمكن أن ترسل Event Grid على Kubernetes الأحداث إلى أي وجهة عبر الإخطارات على الويب. الإخطارات على الويب هي نقاط نهاية HTTP(s) التي تعرضها خدمة أو حمل العمل يمكن لـ Event Grid الوصول إليه. يمكن أن يكون الإخطار على الويب حمل عمل مستضافا في نفس المجموعة، في نفس مساحة الشبكة، على السحابة، أو في الموقع أو في أي مكان يمكن أن تصل إليه شبكة الأحداث.

هام

تكون Event Grid على Kubernetes مع Azure Arc حالياً في المعاينة العامة. يتم توفير إصدار المعاينة هذا دون اتفاقية مستوى الخدمة، ولا يوصى به لأحمال العمل الخاصة بالإنتاج. بعض الميزات ربما لا تكون مدعمة أو بها بعض القدرات المقيدة. لمزيد من المعلومات، راجع ⁧⁩شروط الاستخدام التكميلية لمعاينات Microsoft Azure⁧⁩.

من خلال الإخطارات على الويب، يدعم Event Grid الوجهات التالية المستضافة على مجموعة Kubernetes:

  • Azure App Service على Kubernetes مع Azure Arc.
  • دالات Azure على Kubernetes مع Azure Arc.
  • Azure Logic Apps على Kubernetes مع Azure Arc.

بالإضافة إلى الإخطارات على الويب، يمكن أن ترسل Event Grid على Kubernetes الأحداث إلى الوجهات التالية المستضافة على Azure:

  • Azure Event Grid باستخدام الإخطارات على الويب
  • دالات Azure باستخدام الإخطارات على الويب فقط
  • Azure Event Hubs باستخدام معرّف مورد Azure Resource Manager التابع له
  • موضوعات أو قوائم انتظار ناقل خدمة Azure باستخدام معرّف مورد Azure Resource Manager التابع له
  • قائمة انتظار مساحة تخزين Azure باستخدام معرّف مورد Azure Resource Manager التابع له

تماثل الميزة

تقدم خدمة Event Grid على Kubernetes مستوى جيداً من تماثل الميزات باستخدام دعم Azure Event Grid لاشتراكات الأحداث. تسرد القائمة التالية الاختلافات الرئيسية في الأداء الوظيفي للاشتراك في الحدث. بصرف النظر عن هذه الاختلافات، يمكنك استخدام معاينة الإصدار 2020-10-15 لواجهة برمجة تطبيقات REST الخاصة بخدمة Azure Event Grid كمرجع عند إدارة اشتراكات الأحداث على Event Grid على Kubernetes.

  1. استخدام معاينة الإصدار 2020-10-15 لواجهة برمجة تطبيقات REST.
  2. مشغّل Azure Event Grid لدالات Azure غير مدعوم. يمكنك استخدام نوع وجهة إخطار على الويب لتسليم الأحداث إلى دالات Azure.
  3. لا يتوفر الدعم لموقع الرسائل الضائعة الجغرافية. وهذا يعني أنه لا يمكنك استخدام properties.deadLetterDestination في حمولة اشتراك الحدث.
  4. اتصالات Azure Relay المختلطة كوجهة غير مدعومة حتى الآن.
  5. مخطط CloudEvents فقط مدعوم. قيمة المخطط المدعوم هي "CloudEventSchemaV1_0". مخطط أحداث السحابة قابل للتوسع ويستند إلى معايير مفتوحة.
  6. التصنيفات(properties.labels)غير قابلة للتطبيق على Event Grid على Kubernetes. ومن ثم، فهي غير متوفرة.
  7. التسليم باستخدام هوية المورد غير مدعومة. لذلك، فإن جميع خصائص هوية اشتراك الحدث غير مدعومة.
  8. التحقق من صحة نقطة نهاية الوجهة غير مدعومة حتى الآن.

تصفية الأحداث في اشتراكات الأحداث

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

تهيئات الوجهات النموذجية

فيما يلي بعض تهيئات العينات الأساسية استناداً إلى الوجهة المقصودة.

إخطار على الويب

للنشر إلى نقطة نهاية الإخطار على الويب، اضبط endpointType على WebHook وقدّم:

  • endpointUrl: عنوان URL نقطة نهاية الإخطار على الويب

        {
      "properties": {
        "destination": {
          "endpointType": "WebHook",
          "properties": {
            "endpointUrl": "<your-webhook-endpoint>"
          }
        }
      }
    }

Azure Event Grid

للنشر إلى نقطة نهاية سحابة Azure Event Grid، عيّن endpointType على WebHook وقدم:

  • endpointUrl: عنوان URL لموضوع Azure Event Grid في السحابة مع تعيين معلمة إصدار واجهة برمجة التطبيقات إلى 2018-01-01 وتعيينها aeg-sas-key إلى مفتاح SAS المشفر بعنوان URL.

      {
    "properties": {
      "destination": {
        "endpointType": "WebHook",
        "properties": {
          "endpointUrl": "<your-event-grid-cloud-topic-endpoint-url>?api-version=2018-01-01&aeg-sas-key=urlencoded(sas-key-value)"
        }
      }
    }
  }

مراكز الأحداث

للنشر إلى مراكز الأحداث، قم بتعيين endpointType إلى eventHub وتوفير:

  • معرّف المورد: معرّف المورد لمركز أحداث محدد.

        {
      "properties": {
        "destination": {
          "endpointType": "eventHub",
          "properties": {
            "resourceId": "<Azure Resource ID of your event hub>"
          }
        }
      }
    }

قوائم انتظار ناقل خدمة Microsoft Azure

للنشر في قائمة انتظار ناقل الخدمة، اضبط endpointType على serviceBusQueue وقدّم:

  • معرّف المورد: معرّف المورد لناقل خدمة محدد.

        {
      "properties": {
        "destination": {
          "endpointType": "serviceBusQueue",
          "properties": {
            "resourceId": "<Azure Resource ID of your Service Bus queue>"
          }
        }
      }
    }

مواضيع ناقل الخدمة

للنشر في موضوع ناقل خدمة، اضبط endpointType على serviceBusTopic وقدّم:

  • معرّف المورد: معرّف المورد لموضوع ناقل خدمة محدد.

    {
  "properties": {
    "destination": {
      "endpointType": "serviceBusTopic",
      "properties": {
        "resourceId": "<Azure Resource ID of your Service Bus topic>"
      }
    }
  }
}

Storage Queues

للنشر في قائمة انتظار التخزين، اضبط endpointType على storageQueue وقدم:

  • اسم قائمة الانتظار: اسم قائمة انتظار مساحة تخزين Azure التي تجري بالنشر فيها.

  • معرّف المورد: معرّف مورد Azure لحساب مساحة التخزين الذي يحتوي على قائمة الانتظار.

    {
  "properties": {
    "destination": {
      "endpointType": "storageQueue",
      "properties": {
        "queueName": "<your-storage-queue-name>",
        "resourceId": "<Azure Resource ID of your Storage account>"
      }
    }
  }
}

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