قبل تثبيت الموصل وإعداده، عليك توفير مركز API وإنشاء الموارد اللازمة في مشروع Google Cloud:
توفير API Hub
- إنشاء مشروع على Google Cloud: إذا لم يكن لديك مشروع، أنشِئ مشروعًا جديدًا على Google Cloud باستخدام وحدة التحكّم أو gCloud CLI. تأكَّد من ضبط جميع الإعدادات المتعلّقة بالفوترة. لمزيد من المعلومات، يُرجى الاطّلاع على إنشاء مشروع على Google Cloud.
- Provision API Hub: فعِّل واجهات برمجة التطبيقات في Provision API Hub واتّبِع مسار الإعداد باستخدام واجهة مستخدم Google Cloud. تفعيل الأهلية والحِزم الإضافية المطلوبة لمعالجة البيانات الوصفية/أحداث وقت التشغيل
إنشاء مكوّن إضافي
تتضمّن هذه الخطوة إعداد حساب خدمة وتسجيل مؤسسات Apigee Edge for Private Cloud في API Hub.
- إنشاء حساب خدمة: أنشئ حساب خدمة جديدًا على Google Cloud ضمن مشروع العميل. سيستخدم موصّل Apigee API Hub for Private Cloud حساب الخدمة هذا لكتابة البيانات الوصفية لواجهة برمجة التطبيقات وبيانات وقت التشغيل إلى مركز واجهات برمجة التطبيقات. لمزيد من المعلومات، يُرجى الاطّلاع على إنشاء حسابات خدمة.
إنشاء مثيل إضافي في "مركز واجهات برمجة التطبيقات"
- تسجيل مؤسسات Apigee Edge for Private Cloud:
تسجيل مؤسسة واحدة أو أكثر من مؤسسات Apigee Edge for Private Cloud على API Hub يمكن لكل مثيل من المكوّن الإضافي دعم مؤسسة واحدة فقط. لذلك، إذا كنت بحاجة إلى إعداد مؤسسات متعددة، عليك إنشاء مثيلات منفصلة للإضافة لكل مؤسسة. يمكن إجراء ذلك من خلال واجهة مستخدم API Hub أو باستخدام طلب API.
- إعداد حساب الخدمة:
أثناء إنشاء مثيل المكوّن الإضافي، يجب تقديم حساب الخدمة الذي تم إنشاؤه في الخطوة السابقة. سيستخدم موصّل Apigee API Hub for Private Cloud حساب الخدمة لكتابة البيانات الوصفية لواجهة برمجة التطبيقات وبيانات وقت التشغيل إلى API Hub.
- الأنواع المحتملة لعدة مؤسسات::
- الخيار 1: حسابات خدمة منفصلة لكل مؤسسة: أنشئ حساب خدمة مخصّصًا لكل مؤسسة. سيتم ربط كل مثيل من المكوّن الإضافي بحساب الخدمة الخاص به. في هذه الحالة، يجب أن يمتلك حساب الخدمة الذي ينتحل الهوية أذونات لإنشاء مفاتيح نيابةً عن كل حساب خدمة فردي.
- الخيار 2: حساب خدمة واحد لمؤسسات متعددة: إذا كنت تفضّل عملية إعداد أبسط، يمكنك استخدام حساب خدمة واحد لجميع المؤسسات. تسهّل هذه الطريقة عملية الإعداد، لأنّ جميع المؤسسات ستستخدم حساب الخدمة نفسه. ومع ذلك، يعني هذا الأسلوب أنّ التغييرات التي تطرأ على حساب الخدمة (مثل تدوير المفتاح) ستؤثر في جميع المؤسسات المرتبطة به.
- التعامل مع مثيلات متعدّدة من Apigee Edge for Private Cloud: إذا كان الإعداد يتضمّن مثيلات متعدّدة من Apigee Edge for Private Cloud، تنطبق المبادئ نفسها. بالنسبة إلى كل مثيل من Apigee Edge for Private Cloud، ستحتاج إلى مثيل منفصل من المكوّن الإضافي لكل مؤسسة. يمكنك اتّخاذ أحد الإجراءَين التاليَين:
- استخدِم حسابات خدمة منفصلة لكل مثيل من Apigee Edge للسحابة الخاصة، أو
- استخدِم حساب خدمة واحدًا لعدة مثيلات من Apigee Edge for Private Cloud، وذلك حسب تصميم الشبكة الذي تم اختياره.
عند إنشاء مثيل للمكوّن الإضافي بنجاح:
بعد إنشاء مثيل المكوّن الإضافي، ستتلقّى معلومات المفتاح التالية المطلوبة لإعداد موصّل Apigee API Hub لـ Private Cloud:
- موضوع النشر/الاشتراك في بيانات وقت التشغيل: موضوع نشر/اشتراك لتحميل بيانات وقت تشغيل واجهة برمجة التطبيقات (الإحصاءات).
- موضوع النشر والاشتراك في البيانات الوصفية: موضوع نشر واشتراك لتحميل البيانات الوصفية لواجهة برمجة التطبيقات.
- رقم تعريف مثيل المكوّن الإضافي: معرّف فريد لبوابة Apigee Edge for Private Cloud، بالتنسيق:
projects/PROJECT_ID/locations/LOCATION/plugins/PLUGIN_ID/instances/INSTANCE_ID