مسارات مشتركة قابلة لإعادة الاستخدام

أنت تعرض مستندات Apigee Edge.
انتقل إلى مستندات Apigee X. معلومات

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

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

يوضح الفيديو التالي كيفية إنشاء وتتبع تدفق مشترك في واجهة مستخدم Edge.

يوضح الفيديو التالي الذي تبلغ مدته 5 دقائق كيفية إنشاء وتتبع تدفق مشترك في الكلاسيكي واجهة مستخدم Edge (ميزة Edge للسحابة الإلكترونية الخاصة فقط)

يمكنك طلب مسار مشترك باستخدام سياسة FlowCallout. وأيضًا، من خلال إرفاق تدفق مشترك عنصر جذب للتدفق، يمكنك تنفيذ التدفق المشترك قبل طلب خادم وكيل أو هدف، أو بعد استجابة الخادم الوكيل أو الهدف.

كمرجع بشأن سياسة FlowCallout، يُرجى الاطّلاع على سياسة Floodlight. لمزيد من المعلومات على هوامشًا للتدفق، راجع إرفاق تدفق مشترك باستخدام لفتة في المسار.

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

  • الأمان، مع رمز تفويض باستخدام التحقق من مفتاح OAuth وواجهة برمجة التطبيقات، بالإضافة إلى رمز حماية من التهديدات.
  • تسجيل الدخول، لإنشاء رسائل الخطأ العادية.
  • التوسّط للتبديل بين تنسيقَي رسائل XML وJSON.

في الرسم التوضيحي التالي، يستدعي خادمان وكيلان لواجهة برمجة التطبيقات (باستخدام سياسة FlowCallout) التدفق المشترك لمصادقة طلبات المستخدم الواردة. تم نشر AuthSharedFlow بشكل منفصل مع المؤسسة قبل الخوادم الوكيلة، حتى تكون متاحة لدعم الطلبات من أو الوكيل. يمكن تطوير التدفق المشترك وإدارته من قبل فريق مسئول عن مجموعة واسعة من الشركات ، ثم يتم استهلاكها في الخوادم الوكيلة من قِبل فرق العمل التي تعمل على إنشاء تطبيقات أكثر تخصصًا.

تطوير تدفق مشترك

عند تطوير مسار مشترك، عليك دائمًا اختباره من خلال الطلبات المُرسَلة إلى الخادم الوكيل لواجهة برمجة التطبيقات. ضِمن بمعنى آخر، لا يمكنك إرسال الطلبات مباشرةً إلى التدفق المشترك كما تفعل مع أي خادم وكيل لواجهة برمجة التطبيقات. بدلاً من ذلك، يمكنك إرسال الطلبات إلى خادم وكيل لواجهة برمجة التطبيقات، وهو ما يؤدّي بدوره إلى استدعاء المسار المشترك.

فيما يلي الخطوات عالية المستوى لإعداد تدفق مشترك:

  1. معرفة ما يجب أن تكون عليه مجموعة الميزات المشتركة.

    على سبيل المثال، قد ترغب في الجمع بين ميزات إدارة الزيارات، بما في ذلك منع الارتفاعات في حركة المرور. وبهذه الطريقة، يمكنك إدارة إعدادها خارج نطاق سير العمل لتلك تنفيذ منطق خط العمل.

  2. تطوير مسار مشترَك من خلال تنفيذ السياسات والموارد الداعمة، تمامًا كما عند تطوير الخادم الوكيل لواجهة برمجة التطبيقات.

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

    على سبيل المثال، يمكنك تنفيذ "ارتفاع عدد الزيارات" كجزء من دعم إدارة عدد الزيارات تسمح سياسة الاعتقال بـ 30 طلبًا فقط في الثانية، كما في المثال التالي:

    <SpikeArrest async="false" continueOnError="false" enabled="true" name="Spike-Arrest">
    <DisplayName>Spike Arrest</DisplayName>
    <Properties/>
    <Identifier ref="request.header.some-header-name"/>
    <MessageWeight ref="request.header.weight"/>
    <Rate>30ps</Rate>
</SpikeArrest>

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

    <SharedFlow name="default">
    <Step>
        <Name>Spike-Arrest</Name>
    </Step>
</SharedFlow>

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

    كما هو الحال مع الخوادم الوكيلة لواجهة برمجة التطبيقات، يمكنك استيراد ملف ZIP يحتوي على مصدر التدفق المشترك (راجع استيراد ملف الخادم الوكيل لواجهة برمجة التطبيقات للاطّلاع على مزيد من المعلومات عن استيراد الخوادم الوكيلة) يوضح ما يلي كيفية استيراد مسار مشترك مع واجهة برمجة تطبيقات الإدارة:

    curl -X POST -F "file=@/path/to/zip/file.zip" \ 'https://api.enterprise.apigee.com/v1/o/{org_name}/sharedflows?action=import&name=shared-flow-name' \
-u email:password
  3. نشر التدفق المشترك إلى البيئة قبل نشر الخوادم الوكيلة أو التدفقات المشتركة والذي سيستهلكه. يمكنك تفعيل التدفق المشترك بالطريقة نفسها التي تفعِّل بها الخادم الوكيل لواجهة برمجة التطبيقات. (بالنسبة إلى المزيد، راجِع النشر نظرة عامة).

    يجب أن يكون التدفق المشترك في المؤسسة نفسها وأن يتم نشره في بيئة واجهة برمجة التطبيقات نفسها والخوادم الوكيلة والتدفقات المشتركة الأخرى التي تستهلكها. نشر التدفق المشترك قبل الخوادم الوكيلة من الممكن حل اعتماد الخادم الوكيل على التدفق المشترك في وقت النشر.

    يمكنك نشر مسار مشترك باستخدام طلب بيانات للإدارة من واجهة برمجة التطبيقات، مثل ما يلي:

    curl -X POST --header "Content-Type: application/octet-stream" \
https://api.enterprise.apigee.com/v1/o/{org_name}/e/{env_name}/sharedflows/{shared_flow_name}/revisions/{revision_number}/deployments \
-u email:password

    يمكنك أيضًا استبدال مسار مشترك منشور حاليًا بدون فترات توقف عن العمل. (يشبه هذا إلى حد كبير الخوادم الوكيلة لواجهة برمجة التطبيقات. راجِع نشر الخوادم الوكيلة لواجهة برمجة التطبيقات باستخدام Management API لمزيد من المعلومات). إليك نموذج الطلب باستخدام واجهة برمجة تطبيقات الإدارة:

    curl -X POST --header "Content-Type:application/x-www-form-urlencoded" \
https://api.enterprise.apigee.com/v1/o/{org_name}/e/{env_name}/sharedflows/{shared_flow_name}/revisions/{revision_number}/deployments?"override=true" \
-u email:password
  4. تطوير الخادم الوكيل لواجهة برمجة التطبيقات المُستهلِك حتى يتمكّن من استدعاء التدفق المشترك كجزء من برنامجه التدفق.

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

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

    في التعليمة البرمجية التالية، تستدعي سياسة FlowCallout تدفقًا مشتركًا يسمى traffic-management-shared

    <FlowCallout async="false" continueOnError="false" enabled="true" name="Traffic-Management-Flow-Callout">
    <DisplayName>Traffic Management FlowCallout</DisplayName>
    <Properties/>
    <SharedFlowBundle>traffic-management-shared</SharedFlowBundle>
</FlowCallout>

    لمزيد من المعلومات، يمكنك الاطّلاع على مقالة طلب مسار مشترك من خادم وكيل لواجهة برمجة التطبيقات أو مسار مشترَك

  5. انشر الخادم الوكيل لواجهة برمجة التطبيقات المستهلك لبدء استخدام المسار المشترك. (لمزيد من المعلومات حول النشر بشكل عام، راجع فهم النشر).
  6. يمكنك التطوير بالتكرار عن طريق التتبُّع، كما هو الحال مع الخادم الوكيل لواجهة برمجة التطبيقات.

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

    إليك الخطوات التي يمكنك اتّباعها:

    1. تأكد من أن كل من التدفق المشترك والخادم الوكيل لواجهة برمجة التطبيقات الذي يستدعي الأمر باستخدام FlowCallout في نفس المؤسسة ويتم نشرها في نفس البيئة.
    2. في علامة التبويب Trace ضمن خادم وكيل واجهة برمجة التطبيقات، ابدأ بتتبُّع الخادم الوكيل لواجهة برمجة التطبيقات.
    3. يمكنك إرسال طلب إلى نقطة نهاية خادم وكيل في الخادم الوكيل لواجهة برمجة التطبيقات. يجب أن يكون التدفق من نقطة النهاية تضمين سياسة FlowCallout التي تستدعي التدفق المشترك.
    4. في علامة التبويب Trace، تحقَّق من التدفق من الخادم الوكيل لواجهة برمجة التطبيقات إلى المسار المشترك.

      لاحظ أنه في التتبع، يتم تمثيل التدفق المشترك كمجموعة من الخطوات أو السياسات في مربع رمادي. تأتي الرموز التي تمثل سياسات FlowCallout قبل المسارات المشتركة. (لمزيد من المعلومات عن التتبع، راجع استخدام أداة التتبُّع).

إنشاء تدفق مشترك في واجهة مستخدم Edge

عند استخدام واجهة مستخدم Apigee Edge لإنشاء مسار مشترك، يمكنك إنشاء واحد من البداية أو عن طريق استيراد مصادر التدفق الحالية كملف .zip لحزمة التدفق.

  1. يمكنك الوصول إلى صفحة "التدفقات المشتركة"، كما هو موضح أدناه. في صفحة "التدفقات المشتركة"، يمكنك عرض قائمة التدفقات المشتركة في المؤسسة، أو تعديل أو حذف التدفقات في القائمة.

    Edge

    للوصول إلى صفحة "التدفقات المشتركة" باستخدام واجهة مستخدم Edge:

    1. سجِّل الدخول إلى apigee.com/edge.
    2. اختَر المؤسسة التي تحتوي على التدفق المشترك. يُرجى الاطّلاع على التبديل بين المؤسسات.

      سيكون المسار المشترَك متاحًا لأي خوادم وكيلة لواجهة برمجة التطبيقات ومسارات مشتركة تم نشرها في من هذه المؤسسة. ولن يكون هذا الحساب متاحًا من خارج هذه المؤسسة.

    3. اختَر التطوير > المسارات المشتركة في شريط التنقل الأيمن.

    الإصدار الكلاسيكي Edge (السحابة الإلكترونية الخاصة)

    للوصول إلى صفحة "التدفقات المشتركة" باستخدام واجهة مستخدم Edge الكلاسيكي:

    1. سجّل الدخول إلى http://ms-ip:9000، حيث ms-ip هو عنوان IP أو اسم نظام أسماء النطاقات لعقدة خادم الإدارة.
    2. اختَر المؤسسة التي تحتوي على التدفق المشترك. يُرجى الاطّلاع على التبديل بين المؤسسات.

      سيكون المسار المشترَك متاحًا لأي خوادم وكيلة لواجهة برمجة التطبيقات ومسارات مشتركة تم نشرها في من هذه المؤسسة. ولن يكون هذا الحساب متاحًا من خارج هذه المؤسسة.

    3. حدد APIs > المسارات المشتركة في شريط التنقل العلوي.
  2. انقر على الزر + تدفق مشترك لبدء إضافة تدفق مشترك جديد.
  3. في صفحة إنشاء تدفق مشترك، اختر الطريقة التي تريد بها إنشاء التدفق الجديد:
    • أنشئ مسارًا جديدًا من البداية. ستتمكّن من ضبط السياسات والموارد الخطوات في التدفق.
      1. اختَر تدفق مشترك فارغ.
      2. يُرجى إدخال قيمة للاسم. سيكون هذا هو الاسم الذي تستخدمه الخوادم الوكيلة لواجهة برمجة التطبيقات والمسارات المشتركة الأخرى استخدامها للإشارة إلى هذا التدفق المشترك. يجب أن يكون الاسم وصفيًا للمطوّرين. التي تستهلك التدفق.
      3. أدخل وصفًا لتقديم مزيد من المعلومات حول ما يفعله التدفق.
      4. انقر على التالي.
      5. اختياريًا، حدِّد البيئات التي تريد نشر التدفق الجديد إليها.

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

      6. انقر على إنشاء ونشر لإنشاء التدفق المشترك الجديد ونشره في البيئات التي حددتها. إذا لم تحدد أي بيئة، فسيتغير التدفق المشترك ولكن لا يتم نشرها.

    • يمكنك إنشاء مسار مشترك من المصادر الحالية عن طريق تحميل حزمة تدفق.
      1. اختَر حزمة التدفق المشتركة لتحديد ملف zip. الذي يحتوي على العناصر. التي تريدها في التدفق الجديد.

        تحتوي حزمة التدفق المشترك على عناصر المصدر لتدفق مشترك. على سبيل المثال: إذا كنت ستقوم بتنزيل تدفق مشترك من واجهة مستخدم Edge، فسيكون لديك ملف zip. مع حزمة التدفق.

      2. انقر على التالي.
      3. انقر على اختيار ملف لتصفح ملف .zip الذي يحتوي على المسار المشترك المصادر التي تريد استيرادها.
      4. في مربع اسم التدفق المشترك، أدخِل اسمًا للتدفق الذي تم استيراده. سيؤدي هذا إلى الاسم الذي تستخدمه الخوادم الوكيلة لواجهة برمجة التطبيقات وغيرها من التدفقات المشتركة للإشارة إلى هذا التدفق المشترك. يجب أن يكون الاسم وصفيًا للمطوّرين الذين يستخدمون التدفق.
      5. انقر على التالي.
      6. انقر على إنشاء لإنشاء التدفق الجديد من المصادر التي تستوردها.

طلب مسار مشترَك من خادم وكيل لواجهة برمجة التطبيقات أو مسار مشترَك

يمكنك استدعاء تدفق مشترك من خادم وكيل أو من تدفق مشترك آخر باستخدام سياسة Floodlight:

  1. في واجهة مستخدم Edge، حدد موقع الخادم الوكيل أو التدفق المشترك الذي تريد لاستدعاء تدفق مشترك آخر.
  2. في المستكشف، بجانب السياسات، انقر على الزر +.
  3. في قائمة السياسات، ضمن الإضافة، انقر على FlowCallout.
  4. أدخِل الاسم المعروض والاسم (المعرّف الفريد)، ثم اختَر المسار المشترَك الذي الاتصال بهذه السياسة.
  5. انقر على إضافة.
  6. أضِف سياسة FlowCallout الجديدة إلى الخادم الوكيل الذي تريد إجراء الاتصال به.

انظر أيضًا

ربط الخوادم الوكيلة لواجهة برمجة التطبيقات معًا