يقدّم هذا المستند تعليمات تفصيلية حول إعداد وتكوين موصّل Apigee API hub لـ "السحابة الإلكترونية الخاصة" وAPI hub، ما يسهّل نقل بيانات وصفية لواجهة برمجة التطبيقات وإحصاءات وقت التشغيل من عملية تثبيت Apigee Edge for Private Cloud إلى API Hub في Google Cloud.
تم تصميم عملية دمج Apigee Edge for Private Cloud مع API Hub لربط بيئات Apigee المحلية بـ API Hub من Google Cloud. يتيح هذا الدمج التدفق السلس للبيانات الوصفية المهمة لواجهة برمجة التطبيقات (مثل تعريفات خادم وكيل لواجهة برمجة التطبيقات والسياسات وما إلى ذلك) وبيانات إحصاءات وقت التشغيل من عمليات تثبيت Apigee for Private Cloud مباشرةً إلى API Hub، ما يوفّر عرضًا مركزيًا وشاملاً لمجموعة واجهات برمجة التطبيقات.
نظرة عامة
في جوهرها، تتيح عملية الدمج هذه لمستخدمي Apigee for Private Cloud إدخال معلومات واجهة برمجة التطبيقات الخاصة بهم إلى API Hub. وهذا يعني أنّه يمكنك الاستفادة من إمكانات API Hub في ما يتعلق باكتشاف واجهات برمجة التطبيقات وإدارتها بشكل مركزي وحوكمتها، وذلك من عمليات نشر Apigee المحلية.
المكوّنات الرئيسية
- مركز واجهات برمجة التطبيقات (Google Cloud): هي المنصة المركزية المستندة إلى السحابة الإلكترونية التي يتم فيها دمج بيانات التشغيل وبيانات واجهات برمجة التطبيقات الوصفية وإدارتها.
- موصِّل مركز Apigee: هو مكوّن جديد يتم تثبيته إلى جانب بيئة Apigee Edge Private Cloud. هذا الرابط هو الوكيل الأساسي المسؤول عن استخراج البيانات من Apigee Edge for Private Cloud ونشرها بشكل آمن على Google Cloud.
- معالجات الرسائل (MP): هي مكونات Apigee الحالية التي تتم إعادة ضبطها على "الكتابة المزدوجة" لبيانات إحصاءات وقت التشغيل إلى نظام ملفات مشترك على الشبكة (NFS)، ما يتيح استخدامها لموصل Apigee API hub.
- نظام ملفات الشبكة (NFS): وحدة تخزين مشترَكة تُستخدَم لتخزين بيانات الإحصاءات مؤقتًا من معالِجات الرسائل قبل أن يعالجها موصّل مركز واجهات برمجة التطبيقات في Apigee ويحمّلها.
- Google Cloud Pub/Sub: هي خدمة مراسلة يستخدمها موصّل Apigee API Hub for Private Cloud لبث البيانات الوصفية لواجهة برمجة التطبيقات وبيانات وقت التشغيل بشكل آمن إلى مركز واجهات برمجة التطبيقات.
- حسابات خدمة Google Cloud: تُستخدم للمصادقة الآمنة على موصّل Apigee API Hub for Private Cloud ومنحه إذن الوصول للتفاعل مع خدمات Pub/Sub وAPI Hub.
مسار الدمج
تتّبع عملية الدمج إجراءات منظَّمة لضمان نقل البيانات ودقتها:
- عملية الإعداد والتوفير الأوّلية:
- ابدأ بإعداد مشروع على Google Cloud وتوفير API Hub فيه.
- أنشئ حسابات خدمة Google Cloud وسجِّل مؤسسات Apigee for Private Cloud في API Hub من خلال إنشاء "مثيلات المكوّن الإضافي". توفّر هذه الخطوة مواضيع Pub/Sub فريدة ومعرّفات مثيلات المكوّنات الإضافية الضرورية للإعداد.
- Apigee API hub لتثبيت أداة الربط في السحابة الخاصة:
- يتم تثبيت حزمة RPM الخاصة بموصِّل Apigee API hub لـ "السحابة الإلكترونية الخاصة" على جهاز افتراضي مخصّص إلى جانب بيئة Apigee for Private Cloud. يتطلّب ذلك توفّر إصدار متوافق من Apigee for Private Cloud.
- مركز Apigee API لإعداد Private Cloudconnector:
- يتم إعداد الموصّل باستخدام التفاصيل التي تم الحصول عليها أثناء إنشاء إضافة API Hub (مواضيع Pub/Sub وأرقام تعريف مثيل الإضافة وتفاصيل حساب الخدمة).
- يتم إعداد المصادقة لكلّ من خدمات Google Cloud (من خلال مفاتيح حساب الخدمة) و"خادم إدارة Apigee" (من خلال بيانات الاعتماد بترميز base64).
- يتم أيضًا ضبط مسار نظام ملفات الشبكة (NFS) المشترَك هنا.
- إعدادات معالج الرسائل (MP):
- يتم تعديل معالِجات الرسائل في Apigee لتفعيل آلية "الكتابة المزدوجة" لبيانات الإحصاءات. وهذا يعني أنّه يتمّ تسجيل بيانات الإحصاءات في كلّ من نظام الإحصاءات التقليدي ومشاركة NFS المحدّدة.
- تدفّق البيانات:
- بيانات وصفية لواجهة برمجة التطبيقات: يسحب موصّل Apigee API hub لـ Private Cloud البيانات الوصفية لواجهة برمجة التطبيقات من خادم إدارة Apigee وينشرها في موضوع Pub/Sub المحدّد للبيانات الوصفية في Google Cloud، والذي يتم بعد ذلك إدخاله إلى API hub.
- بيانات وقت التشغيل: تكتب معالجات الرسائل بيانات الإحصاءات إلى نظام ملفات الشبكة (NFS) المشترَك. يراقب موصّل مركز Apigee نظام الملفات المشتركة (NFS) هذا، ويعالج بيانات وقت التشغيل، وينشرها في موضوع Pub/Sub المحدّد لبيانات وقت التشغيل في Google Cloud من أجل إدخالها إلى API Hub.
- المراقبة وتحديد المشاكل وحلّها:
- تتيح لك نقطة نهاية الحالة المحلية في مركز Apigee API لموصّل السحابة الإلكترونية الخاصة تتبُّع تقدّم عمليات تحميل البيانات الوصفية وبيانات وقت التشغيل.
- تتوفّر سجلّات تفصيلية لتحديد المشاكل وحلّها، سواء كانت متعلّقة بالبدء أو نقل البيانات أو الاتصال.
الاعتمادات المتبادلة:
- يعتمد موصّل Apigee API Hub for Private Cloud على تركيب نظام الملفات المشتركة (NFS) بشكل صحيح وإمكانية الوصول إليه من خلاله ومن خلال جميع معالِجات الرسائل.
- يجب إعداد "معالجات الرسائل" لإجراء عملية الكتابة المزدوجة إلى نظام NFS من أجل تفعيل جمع بيانات وقت التشغيل.
- تُعدّ أدوار حساب خدمة Google Cloud وتفاصيل مثيل إضافة API Hub الصحيحة ضرورية لإمكانات المصادقة ونشر البيانات الخاصة بالموصل.
يوفر هذا التكامل آلية قوية لنقل واجهات Apigee API المحلية إلى الإدارة المركزية وإمكانية الوصول التي يوفّرها API Hub، ما يتيح تحسين إدارة واجهات API والحصول على إحصاءات أفضل.