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

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

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

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

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

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

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

تعمل أداة نشر Apigee Edge Python مع واجهة برمجة تطبيقات إدارة 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.

ضبط وتشغيل نص برمجي من خلال واجهة سطر الأوامر

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

من دليل /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، ثم نشر الخادم الوكيل لواجهة برمجة التطبيقات في بيئة "الاختبار".

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