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

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

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

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

للحصول على خادم وكيل 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. راجِع أيضًا هل من الممكن التغلب على مشكلة عدم إمكانية الوصول إلى واجهة برمجة التطبيقات؟

نقل رمز التطبيق الحالي إلى الأهداف المستضافة

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