دورة تطوير واجهة برمجة التطبيقات

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

لكل مؤسسة دورة حياة فريدة لتطوير البرامج (SDLC). غالبًا ما يكون من الضروري مزامنة نشر خادم وكيل واجهة برمجة التطبيقات ومواءمته مع العمليات نفسها التي تستخدمها حاليًا وتطوير تطبيقات أخرى واختبارها ونشرها

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

يتم توثيق واجهات برمجة التطبيقات لخدمات واجهة برمجة التطبيقات في مرجع واجهة برمجة التطبيقات. عرض الحصول على مرجع واجهة برمجة التطبيقات البدء.

البيئات

لدى كل مؤسسة على Apigee Edge بيئتان على الأقل متاحتان للنشر. للخوادم الوكيلة لواجهة برمجة التطبيقات: 'test' و"prod". التفريق بين البيئتين يكون عشوائيًا — يتم ببساطة تحديد كل بيئة عن طريق مجموعة مختلفة من عناوين الشبكة (عناوين URL). تشير رسالة الأشكال البيانية هو تقديم نطاق يمكنك من خلاله إنشاء خوادم وكيلة لواجهة برمجة التطبيقات والتحقق منها قبل دخول واجهة برمجة التطبيقات. تظهر للمطورين الخارجيين.

يمكنك الاستفادة من هذه البيئات لمزامنة تطوير الخادم الوكيل لواجهة برمجة التطبيقات التي تمت معالجتها مع SDLC. يتم تحديد كل بيئة من خلال عنوان شبكة، مما يتيح لك فصل حركة المرور بين الخوادم الوكيلة لواجهة برمجة التطبيقات التي تعمل عليها وتلك التي يتم الوصول إليها بواسطة التطبيقات في وقت التشغيل. يتم تحديد عناوين الشبكة المتاحة لكل بيئة في مجموعة من المضيفات الافتراضية. المتاحة في تلك البيئة.

الرسائل الواردة، يتم تفعيل بروتوكول أمان طبقة النقل (TLS)/طبقة المقابس الآمنة (SSL) الخاصة بالخادم تلقائيًا لكل بيئة. هناك مضيفان افتراضيان محددة مسبقًا في كل بيئة: default وsecure. يتم تحديد عنوان HTTP، بينما يحدد الأمان عنوان HTTP/S، مع طبقة النقل الآمنة (TLS)/طبقة المقابس الآمنة (SSL) المُعدّة مسبقًا من جهة الخادم. ضِمن تهيئة خادم وكيل لواجهة برمجة التطبيقات، يمكنك تحديد VirtualHosts التي يجب أن يصغي إليها ProxyEndpoint. عند الترويج إلى الإنتاج، يتم عادةً إيقاف HTTP عن طريق إزالة default VirtualHost من إعداد الخادم الوكيل لواجهة برمجة التطبيقات.

مثلاً، يرصد عنصر ProxyEndpoint التالي على HTTP وHTTPS.

<HTTPProxyConnection>
  <BasePath>/v0/weather</BasePath>
  <Properties/>
  <VirtualHost>default</VirtualHost>
  <VirtualHost>secure</VirtualHost>
</HTTPProxyConnection>

من خلال حذف VirtualHost default من إعدادات ProxyEndpoint، يمكنك إنشاء خادم وكيل لواجهة برمجة التطبيقات للاستماع إلى HTTPS فقط وليس على HTTP.

<HTTPProxyConnection>
  <BasePath>/v0/weather</BasePath>
  <Properties/>
  <VirtualHost>secure</VirtualHost>
</HTTPProxyConnection>

يمكنك معرفة أي مضيفات VirtualHost متوفرة في بيئة ما عن طريق تحديد البيئات في القائمة الرئيسية لواجهة مستخدم الإدارة.

توفّر البيئات أيضًا فصلاً للبيانات والموارد. يمكنك، على سبيل المثال، إعداد ذاكرات تخزين مؤقتة مختلفة في الاختبار والإنتاج، والتي لا يمكن الوصول إليها إلا من خلال الخوادم الوكيلة لواجهة برمجة التطبيقات التي يتم تنفيذها في تلك محددة. بالإضافة إلى ذلك، لا تكون مفاتيح واجهة برمجة التطبيقات التي يتم إصدارها في بيئة الاختبار صالحة في وبيئة الإنتاج، والعكس صحيح.

نشر الخوادم الوكيلة لواجهة برمجة التطبيقات في البيئات

عند إنشاء خادم وكيل لواجهة برمجة التطبيقات، سيكون عليك تحديد البيئة التي ستعمل فيها. إِنْتَ اختيار إنشاء خادم وكيل جديد لواجهة برمجة التطبيقات في مرحلة الإنتاج، ولكن لا يوصى بذلك حيث قد تعرض واجهة برمجة التطبيقات للمطورين قبل أن تصبح جاهزة. بشكل عام، ابدأ بإنشاء خادم وكيل لواجهة برمجة التطبيقات في test بعد الاختبار، ثم ترقيتها إلى prod

لمزيد من المعلومات، يُرجى مراجعة فهم عملية النشر

التطور المتكرر في الاختبار

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

الترويج إلى الإنتاج

بعد تنفيذ خادم وكيل لواجهة برمجة التطبيقات واختباره بشكل كامل، يصبح جاهزًا للترقية إلى "إنتاج". سيتم استخدام مراجعة خادم وكيل واجهة برمجة التطبيقات قيد الاختبار لاستبدال النسخة السابقة من الخادم الوكيل لواجهة برمجة التطبيقات. نشره على الإنتاج.

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

نشر النصوص البرمجية

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

الموارد البيئية

لمزيد من التحكّم خلال فترة العرض الترويجي، ننصحك باستخدام خيار التكرار على واجهة برمجة التطبيقات فقط. الخوادم الوكيلة قيد الاختبار، وإجراء بعض التغييرات اللازمة على الخوادم الوكيلة لواجهة برمجة التطبيقات التي تم نشرها في الإنتاج.

للقيام بذلك، تحتاج إلى التأكد من أن بعض الموارد المرتبطة بكل بيئة طريقة تجعلها ثابتة في ضبط الخادم الوكيل لواجهة برمجة التطبيقات

• عناوين URL المستهدفة: من الشائع أن تتصل الخوادم الوكيلة لواجهة برمجة التطبيقات بعناوين URL مختلفة للواجهة الخلفية أثناء الاختبار والإنتاج. يمكنك استخدام عمليات ضبط TargetServer لإنشاء خادم مستقل للبيئة إعدادات TargetEndpoint عرض موازنة التحميل على خوادم الخلفية
• ذاكرات التخزين المؤقت وخرائط المفتاح/القيمة: يتم تحديد نطاق كل من موارد الاحتفاظ بالبيانات حسب البيئة. عليك والتأكد من استخدام اصطلاحات التسمية لتمكين الخوادم الوكيلة لواجهة برمجة التطبيقات من تخزين البيانات بدون الحاجة إلى التغييرات على الإعدادات أثناء العرض الترويجي. عرض إنشاء ذاكرة تخزين مؤقت للبيئة وتعديلها
• أهداف ServiceCallout: قد تستخدم وسائل شرح الخدمة أهدافًا مختلفة وفقًا إذا كانت أداة ServiceCallout في بيئة الاختبار تستهلك خدمة تجريبية مثلاً. يُرجى الاطّلاع على سياسة وسيلة شرح الخدمة.

لجعل إعدادات ضبط الخادم الوكيل لواجهة برمجة التطبيقات مستقلة عن البيئة، يمكنك أيضًا استخدام خيارات البيانات. يمكن أن تكون العبارة الشرطية المنشأة باستخدام المتغير environment.name يُستخدم لتقييم البيئة الحالية قبل فرض سياسة أو قبل التوجيه إلى عنوان URL على الواجهة الخلفية.

لمزيد من المعلومات، يمكنك الاطّلاع على فهم عملية النشر.