نظرة عامة على الأهداف المستضافة

أنت الآن بصدد الاطّلاع على مستندات Apigee Edge.
انتقِل إلىمستندات Apigee X. info

تتيح لك "الخدمات المستضافة" تشغيل تطبيقات Node.js في بيئة وقت تشغيل أصلية تستضيفها Apigee. الهدف من "الخدمات المستضافة" بسيط: السماح لك بنشر التطبيقات في بيئة أصلية وآمنة وقابلة للتوسّع ومعزولة، حيث يمكن لوكلاء Edge API استدعاؤها كخدمات مستهدَفة.

كما يوضّح الشكل التالي، يستدعي وكيل Edge API تطبيق Node.js يتم نشره في بيئة "الخدمات المستضافة". يُرجى العِلم أنّ بيئة "الخدمات المستضافة" محصورة ضمن مؤسسة:بيئة Apigee.

لجعل وكيل Edge API يتواصل مع تطبيق "الخدمات المستضافة" الذي تم إنشاؤه ونشره بشكل صحيح، يتطلب ذلك إعدادًا بسيطًا في نقطة النهاية المستهدَفة للوكيل. للبدء، انتقِل إلى البرامج التعليمية حول "الخدمات المستضافة".

ما هي أوقات تشغيل التطبيقات التي تتيحها "الخدمات المستضافة"؟

في الوقت الحالي، يمكنك نشر تطبيقات Node.js فقط على "الخدمات المستضافة".

تثبيت "الخدمات المستضافة"

تتوفّر "الخدمات المستضافة" في جميع مؤسسات Edge Public Cloud. ولست بحاجة إلى تثبيت أي شيء لاستخدام "الخدمات المستضافة".

التأكّد من تفعيل "الخدمات المستضافة"

إذا أردت التأكّد من تفعيل "الخدمات المستضافة" في مؤسستك، احصل على تفاصيل مؤسستك وتأكَّد من ضبط السمة features.isEdgeFunctionsEnabled على "صحيح". السمة للقراءة فقط.

على سبيل المثال:

https://api.enterprise.apigee.com/v1/organizations/myorg

  {
     "createdAt":1507572884047,
     "createdBy":"jdoe@apigee.com",
     "displayName":"myorg",
     "environments":[
        "prod",
        "dev",
        "test",
        "portal"
     ],
     "lastModifiedAt":1507578673194,
     "lastModifiedBy":"jdoe@apigee.com",
     "name":"jdoe",
     "properties":{
        "property":[
           {
              "name":"features.isSmbOrganization",
              "value":"false"
           },
           {
              "name":"self.service.virtual.host.enabled",
              "value":"true"
           },
           {
              "name":"features.isCpsEnabled",
              "value":"true"
           },
           {
              "name":"features.isEdgeFunctionsEnabled",
              "value":"true"
           }
        ]
     },
     "type":"paid"
  }
  

ما تحتاج إلى معرفته عن "الخدمات المستضافة"

تسمح "الخدمات المستضافة" بتشغيل تطبيقات Node.js في بيئة أصلية لا تعتمد على أي تكنولوجيا وقت تشغيل خاصة بـ Apigee. يمكنك تصحيح أخطاء تطبيقك واختباره محليًا قبل نشره، والتأكّد من أنّ الإصدار الذي تم نشره سيعمل تمامًا كما يعمل محليًا. عند النشر، يمكنك اختيار أي إصدار من وقت تشغيل التطبيق لـ تشغيل تطبيقك في "الخدمات المستضافة". على سبيل المثال، يمكنك اختيار تشغيل تطبيق Node.js في بيئة الإصدار 8.10.0 على وجه التحديد.

الحدود

للاطّلاع على حدود استخدام "الخدمات المستضافة"، يُرجى مراجعة حدود منتجات Apigee.

الخطوات الأساسية التي يجب اتّباعها

إذا كنت على دراية بتطوير وكلاء Edge، ما عليك سوى تعلُّم بضع خطوات بسيطة لاستخدام "الخدمات المستضافة" بنجاح. بشكل أساسي، يمكنك إنشاء ونشر وإدارة وكلاء Edge لـ "الخدمات المستضافة" تمامًا كما تفعل مع أي وكيل Apigee Edge آخر.

لاستخدام "الخدمات المستضافة"، عليك تنفيذ المهام التالية. تتناول البرامج التعليمية كل مهمة من هذه المهام بالتفصيل.

• طوِّر تطبيق Node.js واختبِره محليًا.
• أنشئ ملف بيان في الدليل الجذري لمشروع تطبيقك. البيان هو ملف YAML يحدّد المعلومات اللازمة لإنشاء التطبيق ونشره.
• أضِف تطبيقك إلى وكيل Edge كـ نوع مورد مستضاف.
• في نقطة النهاية المستهدَفة للوكيل، أضِف علامة <HostedTarget/> فارغة. تخبر هذه العلامة Edge بنشر تطبيق Node.js في بيئة "الخدمات المستضافة". على سبيل المثال:

<?xml version="1.0" encoding="UTF-8"?>
<TargetEndpoint name="default">
   <PreFlow name="PreFlow">
      <Request />
      <Response />
   </PreFlow>
   <PostFlow name="PostFlow">
      <Request />
      <Response />
   </PostFlow>
   <Flows />
   <HostedTarget />
</TargetEndpoint>

نطاق تطبيقات "الخدمات المستضافة"

تكون تطبيقات "الخدمات المستضافة" محصورة ضمن مؤسسة:بيئة Edge. هذا النطاق هو نفسه نطاق أي وكيل Edge.

هل يمكن لتطبيقات "الخدمات المستضافة" الوصول إلى بيانات الوكيل؟

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

باستخدام Node.js المضمّنة (الدعم التقليدي لـ Node.js المستند إلى Trireme في Edge)، يمكنك استخدام apigee-access للوصول إلى متغيرات التدفق والكيانات الأخرى في Edge. ومع ذلك، لا تتيح "الخدمات المستضافة" استخدام وحدة apigee-access لعمليات نشر Node.js. راجِع أيضًا هل من الممكن حلّ مشكلة عدم توفّر apigee-access؟

نقل الرمز البرمجي للتطبيق الحالي إلى "الخدمات المستضافة"

لا يتوفّر حاليًا مسار نقل تلقائي من تطبيق Node.js مضمّن تقليدي مستند إلى Trireme إلى "الخدمات المستضافة". ومع ذلك، يمكنك تحويل الرمز البرمجي للتطبيق الحالي إلى "الخدمات المستضافة" يدويًا. للاطّلاع على مثال، يُرجى مراجعة مقالة نقل وكيل Node.js حالي إلى وكيل "الخدمات المستضافة".