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

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

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

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

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

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

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

تعمل أداة النشر في Apigee Edge Python مع واجهة Edge management API لاستيراد واجهة برمجة التطبيقات ونشرها أو الوكيل. تتوفر الأداة كجزء من توزيع عينات واجهة برمجة التطبيقات على GitHub. عرض استخدام نماذج الخوادم الوكيلة لواجهة برمجة التطبيقات:

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

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

في الأمر التالي، استبدل اسم الخادم الوكيل واسم المستخدم وكلمة المرور على 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 الحافة.
  • -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 في توزيع عينات المنصات. للحصول على تعليمات، يُرجى الرجوع إلى الملف التمهيدي أو واجهات برمجة تطبيقات Apigee Edge.

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

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