این سند دستورالعمل‌های مفصلی برای راه‌اندازی و پیکربندی اتصال‌دهنده Apigee API hub برای Private Cloud و API hub ارائه می‌دهد که انتقال فراداده API و تجزیه‌وتحلیل‌های زمان اجرا را از نصب Apigee Edge for Private Cloud به Google Cloud's API Hub تسهیل می‌کند.
ادغام Apigee Edge for Private Cloud و API hub برای ایجاد ارتباط بین محیط‌های Apigee در محل کار شما و API Hub در Google Cloud طراحی شده است. این یکپارچه‌سازی جریان یکپارچه فراداده‌های حیاتی API (مانند تعریف‌های پراکسی API، خط‌مشی‌ها، و غیره) و داده‌های تجزیه‌وتحلیل زمان اجرا را از نصب‌های Apigee for Private Cloud مستقیماً به کانون API امکان‌پذیر می‌کند و نمایی متمرکز و جامع از چشم‌انداز API شما ارائه می‌دهد.
نمای کلی
در هسته خود، این یکپارچه‌سازی به کاربران Apigee for Private Cloud اجازه می‌دهد اطلاعات API خود را در API Hub ثبت کنند. این یعنی می‌توانید از قابلیت‌های «مرکز API» برای کاوش، مدیریت، و مدیریت متمرکز میاناهای برنامه‌سازی کاربردی که از استقرار Apigee در محل شما منشأ می‌گیرند استفاده کنید.
عناصر اصلی
- کانون API (Google Cloud): پلاتفرم ابری مرکزی که در آن فراداده‌های API و داده‌های زمان اجرا تجمیع و مدیریت می‌شوند.
- رابط مرکز کنترل Apigee: عنصر جدیدی که درکنار محیط Apigee Edge for Private Cloud نصب می‌شود. این اتصال‌دهنده عامل اصلی مسئول استخراج داده‌ها از Apigee Edge برای «ابر خصوصی» و انتشار ایمن آن در Google Cloud است.
- پردازشگرهای پیام (MPs): عناصر موجود Apigee که برای «نوشتن دوگانه» داده‌های تجزیه‌وتحلیل زمان اجرا در «سیستم فایل شبکه» (NFS) هم‌رسانی‌شده، پیکربندی مجدد می‌شوند و آن را برای اتصال‌دهنده مرکز API Apigee دردسترس قرار می‌دهند.
- سیستم فایل شبکه (NFS): حجم فضای ذخیره‌سازی مشترکی که برای ذخیره موقت داده‌های تجزیه‌وتحلیل از MPs قبل‌از پردازش و بارگذاری آن توسط اتصال‌دهنده مرکز Apigee API استفاده می‌شود.
- Google cloud pub/sub: سرویس پیام‌رسانی که توسط اتصال‌دهنده Apigee API Hub for Private Cloud برای جاری‌سازی ایمن فراداده‌های API و داده‌های زمان اجرا به مرکز API استفاده می‌شود.
- حساب‌های سرویس Google Cloud: برای اصالت‌سنجی و صدور مجوز ایمن اتصال‌دهنده «مرکز API برای ابر خصوصی» Apigee برای تعامل با سرویس‌های Pub/Sub و مرکز API استفاده می‌شود.
جریان یکپارچه‌سازی
ادغام از فرایندی ساختاریافته برای اطمینان از انتقال و دقت داده‌ها پیروی می‌کند:
- راه‌اندازی اولیه و آماده‌سازی:
- با راه‌اندازی پروژه Google Cloud و آماده‌سازی API Hub در آن شروع کنید.
- با ایجاد «نمونه‌های افزایه»، «حساب‌های خدمات Google Cloud» ایجاد کنید و سازمان‌های Apigee for Private Cloud خود را در «مرکز API» ثبت کنید. این مرحله موضوعات Pub/Sub منحصربه‌فرد و «شناسه‌های نمونه افزایه» ضروری برای پیکربندی را ارائه می‌دهد.
- مرکز Apigee API برای نصب اتصال‌دهنده «ابر خصوصی»:
- مرکز Apigee API برای اتصال‌دهنده «ابر خصوصی»، بسته RPM، در کنار محیط Apigee for Private Cloud در ماشین مجازی اختصاصی نصب می‌شود. این کار به نسخه سازگار Apigee for Private Cloud نیاز دارد.
- مرکز Apigee API برای پیکربندی «پیونددهنده ابر خصوصی»:
- این اتصال‌دهنده با جزئیات به‌دست‌آمده درطول ایجاد افزایه API Hub پیکربندی می‌شود (موضوعات Pub/Sub، شناسه‌های نمونه افزایه، جزئیات حساب خدمات).
- اصالت‌سنجی برای هر دو سرویس Google Cloud (ازطریق کلیدهای حساب خدمات) و «سرور مدیریت Apigee» (ازطریق اطلاعات اعتباری کدبندی‌شده با base64) برقرار می‌شود.
- مسیر NFS مشترک نیز در اینجا پیکربندی می‌شود.
- پیکربندی پردازشگر پیام (MP):
- پردازشگرهای پیام Apigee شما به‌روزرسانی می‌شوند تا سازوکار «نوشتن دوگانه» برای داده‌های Analytics فعال شود. این یعنی گزارش‌های Analytics هم در سیستم Analytics سنتی و هم در هم‌رسانی NFS تعیین‌شده نوشته می‌شود.
- جریان داده:
- فراداده API: کانون Apigee API برای رابط Private Cloud فراداده API را از سرور مدیریت Apigee بیرون می‌کشد و آن را در موضوع Pub/Sub فراداده تعیین‌شده در Google Cloud منتشر می‌کند، که سپس به کانون API وارد می‌شود.
- داده‌های زمان اجرا: پردازشگران پیام داده‌های تجزیه‌وتحلیل را در NFS هم‌رسانی‌شده می‌نویسند. اتصال‌دهنده مرکز Apigee این NFS را پایش می‌کند، داده‌های زمان اجرا را پردازش می‌کند، و آن را در موضوع Pub/Sub داده‌های زمان اجرای تعیین‌شده در Google Cloud برای انتقال به API Hub منتشر می‌کند.
- پایش و عیب‌یابی:
- نقطه پایانی وضعیت محلی در مرکز Apigee API برای اتصال‌دهنده «ابر خصوصی» به شما امکان می‌دهد پیشرفت بارگذاری‌های فراداده و داده‌های زمان اجرا را پایش کنید.
- گزارش‌های دقیق برای عیب‌یابی هرگونه مشکل مربوط به راه‌اندازی، انتقال داده، یا اتصال‌پذیری دردسترس است.
وابستگی‌های متقابل:
- اتصال‌دهنده «مرکز API Apigee برای ابر خصوصی» متکی بر این است که NFS به‌درستی نصب شده باشد و هم خود و هم همه «پردازشگران پیام» به آن دسترسی داشته باشند.
- «پردازشگرهای پیام» باید برای نوشتن هم‌زمان در NFS پیکربندی شوند تا جمع‌آوری داده‌های زمان اجرا فعال شود.
- نقش‌های «حساب سرویس Google Cloud» صحیح و جزئیات «نمونه افزایه مرکز API» برای قابلیت‌های اصالت‌سنجی و انتشار داده‌های اتصال‌دهنده حیاتی است.
این یکپارچه‌سازی سازوکار قدرتمندی برای آوردن «میاناهای برنامه‌سازی کاربردی Apigee» در محل کارتان به مدیریت و رؤیت‌پذیری مرکزی ارائه‌شده توسط «مرکز API» فراهم می‌کند و از این طریق حاکمیت و اطلاعات آماری بهتری برای «میاناهای برنامه‌سازی کاربردی» ارائه می‌دهد.