نشر الخوادم الوكيلة من سطر الأوامر

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

يوضّح هذا الموضوع كيفية نشر خادم وكيل من سطر الأوامر. توفّر Apigee Edge خيارَين للنشر من سطر الأوامر. الطريقة الأولى هي استخدام أداة نشر Apigee Edge مكتوبة بلغة Python. والطريقة الأخرى هي ضبط نص برمجي للواجهة وتشغيله.

استخدِم أساليب النشر من سطر الأوامر عندما تعمل مباشرةً مع ملفات مصدر الخادم الوكيل على نظامك. هناك العديد من الأسباب التي قد تؤدي إلى العمل بلا إنترنت. قد تحتاج إلى استخدام محرّر XML مفضّل أو قد تكون بصدد تطوير سياسات تتطلّب ترميز Java وتعمل بشكل أساسي في بيئة تطوير متكاملة (IDE). تتيح لك التقنيات الموضّحة في هذا القسم تحميل ملفات المصدر ونشرها في بيئة "خدمات واجهة برمجة التطبيقات" التي تختارها.

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

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

تشغيل أداة نشر Python في Apigee Edge

تعمل أداة النشر في Python على Apigee Edge مع واجهة برمجة التطبيقات الخاصة بالإدارة في Edge لاستيراد خوادم وكيلة لواجهات برمجة التطبيقات ونشرها. تتوفّر الأداة كجزء من توزيع "نماذج منصة واجهة برمجة التطبيقات" على GitHub. اطّلِع على استخدام نماذج الخوادم الوكيلة لواجهة برمجة التطبيقات.

استخدِم أداة Apigee Edge Python لاستيراد (تحميل) واجهة برمجة التطبيقات ونشرها في عملية بسيطة واحدة.

يجب تشغيل أداة النشر من الدليل الأساسي في حزمة توزيع نماذج "منصة واجهات برمجة التطبيقات"، حيث يكون الدليل الأساسي هو الدليل الرئيسي للدليلين setup وtools.

في الأمر التالي، استبدِل اسم الخادم الوكيل واسم المستخدم وكلمة المرور في Edge ومؤسسة Edge وبيئتها ومسار الدليل الذي يحتوي على دليل apiproxy" الخاص بالخادم الوكيل لواجهة برمجة التطبيقات:

python tools/deploy.py -n proxyname -u name:passW -o org -e env -d proxypath -p /

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

python tools/deploy.py -n weatherapi -u me@myCo.com:foo -o myCo -e test -d weatherapi -p /

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

تكتشف أداة النشر تلقائيًا المراجعة الحالية لخادم وكيل واجهة برمجة التطبيقات، وتلغي نشر المراجعة الحالية، ثم تنشر مراجعة متزايدة لخادم وكيل واجهة برمجة التطبيقات.

عند النجاح، سترى الناتج بالتنسيق التالي:

Writing ./<proxybasedir>/apiproxy/weatherapi.xml to apiproxy/weatherapi.xml
Writing ./<proxybasedir>/apiproxy/proxies/default.xml to apiproxy/proxies/default.xml
Writing ./<proxybasedir>/apiproxy/targets/default.xml to apiproxy/targets/default.xml
Imported new proxy version 1
Environment: test
  Revision: 1 BasePath = /
  State: deployed

بشكلٍ تلقائي، تحمّل الأداة خادم وكيل لواجهة برمجة التطبيقات إلى https://api.enterprise.apigee.com، المتوافق مع Edge في السحابة الإلكترونية. يمكنك أيضًا استخدام هذه الأداة لتحميل خادم وكيل لواجهة برمجة التطبيقات إلى إصدار محلي من Edge من خلال تحديد العلامة -h:

python tools/deploy.py -n weatherapi -u me@myCo.com:foo -o myCo -e test -d weatherapi -p / -h https://192.168.11.111:8080

في هذا المثال، عليك تحديد عنوان IP لخادم إدارة Edge. إذا أنشأت سجلّ نظام أسماء نطاقات لخادم الإدارة، يمكنك تحديد عنوان URL بالتنسيق التالي:

https://ms_URL:8080

في ما يلي القائمة الكاملة بالعلامات الخاصة بالأمر:

  • استبدِل -n باسم خادم وكيل واجهة برمجة التطبيقات.
  • -u: اسم المستخدم وكلمة المرور لحسابك في مؤسسة على Apigee Edge
  • -o: اسم المؤسسة التي لديك حساب فيها
  • -e: البيئة التي يجب نشر خادم وكيل واجهة برمجة التطبيقات فيها (test أو prod).
  • -d: مسار الدليل الذي يحتوي على ملفات خادم وكيل واجهة برمجة التطبيقات يجب تخزين ملفات خادم وكيل واجهة برمجة التطبيقات ضمن دليل باسم "apiproxy". هذه القيمة هي مسار الدليل الذي يحتوي على الدليل "apiproxy"، وليس مسار الدليل "apiproxy" نفسه.
  • -p: مسار معرّف الموارد المنتظم (URI) المستخدَم كمطابقة نمط لتوجيه الرسالة الواردة إلى عملية نشر خادم وكيل لواجهة برمجة التطبيقات هذه. في معظم الحالات، يمكنك ضبط هذه القيمة على "/"، ما لم تكن لديك متطلبات متقدمة بشأن النشر والتوجيه. يتم تحديد المسار الأساسي المستخدَم لتوجيه طلبات الخادم الوكيل لواجهة برمجة التطبيقات في ملف إعداد ProxyEndpoint الخاص بالخادم الوكيل لواجهة برمجة التطبيقات.
  • ‫-h: عنوان URL الخاص بخادم Edge. يكون عنوان URL التلقائي https://api.enterprise.apigee.com، وهو ما يتوافق مع Edge في السحابة الإلكترونية. بالنسبة إلى عملية نشر محلية، استخدِم عنوان URL الخاص بخادم إدارة Edge والمنفذ 8080، كما في المثال التالي: 
    https://ms_URL:8080

    أو استخدِم عنوان IP الخاص بخادم الإدارة، كما في https://192.168.11.111:8080.

إعداد نص برمجي لصدفة النشر وتشغيله

أسهل طريقة هي تشغيل نص النشر البرمجي المتوفّر مع نموذج خادم وكيل لواجهة برمجة التطبيقات. تتضمّن النصوص البرمجية الخاصة بالأوامر shell أداة نشر Python في Apigee Edge.

من الدليل /simplyProxy، نفِّذ ما يلي:

$ sh deploy.sh

سيظهر لك ما يلي:

Enter your password for user {myname} in the Apigee Enterprise organization {org_name}, followed by [ENTER]:

أدخِل كلمة المرور واضغط على ENTER.

من المفترض أن يظهر لك ما يلي:

Deploying to test on https://api.enterprise.apigee.com using {myname} on enterprise.apigee.com and {org_name} on enterprise.apigee.com

إذا ظهرت لك الرسالة التالية:

Enter your password for user Your USERNAME on enterprise.apigee.com in the Apigee Enterprise organization Your ORG on enterprise.apigee.com, followed by [ENTER]:

هذا يعني أنّه عليك تعديل الملف /setup/setenv.sh في حزمة توزيع عيّنات النظام الأساسي. للحصول على التعليمات، يُرجى الرجوع إلى ملف README أو إلى واجهات برمجة التطبيقات في Apigee Edge.

عند اكتمال العملية بنجاح، يضغط أداة النشر الملفات في ملف ZIP ضمن /apiproxy, عمليات الاستيراد الحزمة إلى مؤسستك على Apigee Edge، ثم تنشر خادم وكيل واجهة برمجة التطبيقات في بيئة "الاختبار".

وكيل واجهة برمجة التطبيقات جاهز للاستدعاء.