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

أنت تطّلع على مستندات Apigee Edge.
انتقِل إلى مستندات Apigee X. المعلومات

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

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

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

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

يمكنك حاليًا نشر تطبيقات 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 حالي إلى خادم وكيل للاستهدافات المستضافة.