بدء استخدام Node.js على Apigee Edge

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

يوضّح هذا الموضوع أبسط طريقة لالتفاف تطبيق Node.js في خادم وكيل لواجهة برمجة التطبيقات باستخدام واجهة مستخدم الإدارة.

مقدمة

من المحتمل أن يكون أول تطبيق Node.js أنشأته من قبل خادم HTTP يستجيب للطلبات بـ "Hello World!" إنّ أبسط طريقة لتجربة Node.js على Apigee Edge هي تنفيذ إجراء مشابه جدًا. ببضع نقرات فقط، ستحصل على خادم Node.js HTTP يعمل على Edge. بعد ذلك، يمكنك استخدام أداة تعديل الرموز في واجهة المستخدم لتعديل تطبيق Node.js وإضافة ملفات Node.js إضافية وإضافة سياسات وما إلى ذلك.

إنشاء النموذج Hello World! الخادم الوكيل لواجهة برمجة التطبيقات

يوضّح هذا القسم طريقة إنشاء خادم وكيل لواجهة برمجة تطبيقات Edge يتفاعل مع خادم Node.js HTTP. سبق أن تمت كتابة رمز خادم Node.js HTTP لك ويتم نشره تلقائيًا على Edge عند اتّباع هذه الخطوات البسيطة.

1. في معالج إنشاء خادم وكيل، اختر تطبيق Node.js.
2. انقر على التالي.
3. اتبع معالج إنشاء خادم وكيل وقم بالتحديدات التالية.
   

   الحقل	الاختيار
   التفاصيل
   اسم الخادم الوكيل	أدخِل Nodejs-Hello. الاسم المعروض لواجهة برمجة التطبيقات.
   المسار الأساسي للخادم الوكيل	أدخِلNodejs-hello.
   المصدر	حدد نموذج"Hello World". (سنناقش الخيارات الأخرى لاحقًا في هذا الموضوع).
   الوصف	أدخِل وصفًا لواجهة برمجة التطبيقات.
   الأمان
   المرور (بدون)	اختَر اجتياز (بدون). ينشئ هذا الإعداد مرورًا بسيطًا عبر الخادم الوكيل.
   المضيفون الافتراضيون
   تلقائي، آمن	لا تغيّر الإعدادات التلقائية. للحصول على معلومات حول المضيفين الافتراضيين، راجع معلومات عن المضيفين الافتراضيين (إصدار تجريبي).
   إنشاء
   نشر البيئات	اختَر اختبار.

4. انقر على إنشاء ونشر
   استجابةً لذلك، من المفترض أن تظهر لك رسالة تشير إلى أنه تم إنشاء الخادم الوكيل الجديد لواجهة برمجة التطبيقات ونشره بنجاح في بيئة "الاختبار".
5. انقر على عرض الخادم الوكيل <proxy name> في المحرِّر لعرض صفحة التفاصيل للخادم الوكيل لواجهة برمجة التطبيقات.

استدعاء الخادم الوكيل hello

عند استدعاء الخادم الوكيل hello، يتم تنفيذ تطبيق Node.js تلقائيًا، ويستجيب بالعبارة "Hello, World!". يُرجى العلم بأنّه يتم نشر تطبيق Node.js في بيئة تُسمى test، ما لم تحدّد خلاف ذلك. في ما يلي المكالمة الأساسية باستخدام Curl (استبدِل اسم مؤسستك بـ myorg).

$ curl http://myorg-test.apigee.net/nodejs-hello
Hello, World!

عرض وتعديل رمز Node.js

لنلقِ نظرة على رمز Node.js الذي تمت إضافته إلى الخادم الوكيل لواجهة برمجة التطبيقات. انتقِل إلى صفحة ملخّص الخادم الوكيل Hello World وانقر على تطوير.

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

على سبيل المثال، يمكنك تغيير الردّ من Hello, World! إلى عبارة أخرى، مثل Hello, Node!، ثم النقر على حفظ. تم حفظ الخادم الوكيل وإعادة نشره.

وأخيرًا، عليك إعادة استدعاء الخادم الوكيل للتحقّق من التغيير:

$ curl http://myorg-test.apigee.net/nodejs-hello
Hello, Node!

مزيد من المعلومات حول تشغيل تطبيقات Node.js على Apigee Edge

مثل جميع تطبيقات Node.js، تعمل تطبيقات Node.js التي تعمل على Apigee Edge في سلسلة واحدة من التحكم. ما مِن حاجة (في الواقع لا يمكن) بدء سلسلة محادثات أخرى أو مزامنة المتغيّرات بين سلاسل المحادثات. ولأنّ Node.js تفرض برمجة لا تؤدي إلى الحظر، يمكن لنص برمجي واحد أن يدعم آلاف الطلبات المتزامنة لأنّ النص البرمجي يترك وحدة المعالجة المركزية (CPU) عندما يضطر إلى انتظار إجراء ما، ويتم إرسال إشعار إليه لاحقًا عند حدوثه.

لاستخدام Node.js في Apigee Edge، يجب تحديد ملف نص Node.js رئيسي. يجب إعداد هذا النص البرمجي لمعالجة الطلبات الواردة، ويتم ذلك عادةً باستخدام وحدات http أو https وإنشاء برنامج، وما إلى ذلك. (إذا لم يتم إعداد النص البرمجي الرئيسي بهذه الطريقة، سيتم تنفيذه والخروج بعد نشره.) ضمن Apigee Edge، يتم بدء كل نص برمجي لتطبيق Node.js من البداية عند تفعيل الخادم الوكيل، ويتوقف عند إلغاء نشر الخادم الوكيل. وخلال هذه الفترة، سيتم انتظار الطلبات الجديدة ومعالجتها. ولمزيد من المعلومات، راجِع "استدعاء ملف Node.js مستورَد" في نشر تطبيق Node.js مستقل.

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

يمكنك أيضًا إنشاء تطبيقات Node.js مستقلة ونشرها من نظام الملفات لديك مباشرةً. يوضّح الموضوع التالي، نشر تطبيق Node.js مستقل، كيفية استخدام الأمر apigeetool لنشر تطبيق Node.js من سطر الأوامر.