खास जानकारी और इंटिग्रेशन फ़्लो

इस दस्तावेज़ में, Private Cloud और API हब के लिए Apigee API हब कनेक्टर को सेट अप और कॉन्फ़िगर करने के बारे में पूरी जानकारी दी गई है. इससे, Apigee Edge for Private Cloud इंस्टॉलेशन से Google Cloud के API हब में एपीआई मेटाडेटा और रनटाइम के दौरान के आंकड़ों को ट्रांसफ़र करने में मदद मिलती है.

Apigee Edge for Private Cloud और API हब इंटिग्रेशन को इस तरह से डिज़ाइन किया गया है कि यह आपके ऑन-प्रिमाइसेस Apigee एनवायरमेंट को Google Cloud के API हब से जोड़ सके. इस इंटिग्रेशन की मदद से, एपीआई के अहम मेटाडेटा (जैसे, एपीआई प्रॉक्सी की परिभाषाएं, नीतियां वगैरह) और रनटाइम के दौरान इकट्ठा किए गए आंकड़ों के डेटा को Apigee for Private Cloud इंस्टॉलेशन से सीधे API Hub में भेजा जा सकता है. इससे आपको एपीआई के लैंडस्केप की पूरी जानकारी एक ही जगह पर मिलती है.

खास जानकारी

इस इंटिग्रेशन की मदद से, Apigee for Private Cloud के उपयोगकर्ता, एपीआई हब में अपने एपीआई की जानकारी शामिल कर सकते हैं. इसका मतलब है कि एपीआई हब की सुविधाओं का इस्तेमाल करके, अपने ऑन-प्रिमाइसेस Apigee डिप्लॉयमेंट से जनरेट होने वाले एपीआई को खोजा जा सकता है, उन्हें कंट्रोल किया जा सकता है, और उन्हें एक जगह से मैनेज किया जा सकता है.

मुख्य कॉम्पोनेंट

  • API हब (Google Cloud): यह क्लाउड पर आधारित एक ऐसा प्लैटफ़ॉर्म है जहां एपीआई मेटाडेटा और रनटाइम डेटा को इकट्ठा और मैनेज किया जाता है.
  • Apigee हब कनेक्टर: यह एक नया कॉम्पोनेंट है, जिसे Apigee Edge for Private Cloud एनवायरमेंट के साथ इंस्टॉल किया जाता है. यह कनेक्टर, Apigee Edge for Private Cloud से डेटा निकालने और उसे Google Cloud पर सुरक्षित तरीके से पब्लिश करने के लिए मुख्य एजेंट होता है.
  • मैसेज प्रोसेसर (एमपी): ये Apigee के मौजूदा कॉम्पोनेंट हैं. इन्हें फिर से कॉन्फ़िगर किया गया है, ताकि ये शेयर किए गए नेटवर्क फ़ाइल सिस्टम (एनएफ़एस) में रनटाइम के दौरान इकट्ठा किए गए आंकड़ों को "डुअल-राइट" कर सकें. इससे, Apigee API हब कनेक्टर के लिए ये आंकड़े उपलब्ध हो जाते हैं.
  • नेटवर्क फ़ाइल सिस्टम (एनएफ़एस): यह शेयर किया गया स्टोरेज वॉल्यूम है. इसका इस्तेमाल, Apigee API हब कनेक्टर के प्रोसेस और अपलोड करने से पहले, एमपी से मिले आंकड़ों के डेटा को कुछ समय के लिए सेव करने के लिए किया जाता है.
  • Google Cloud Pub/Sub: यह एक मैसेजिंग सेवा है. इसका इस्तेमाल Apigee API Hub for Private Cloud connector करता है. इससे एपीआई मेटाडेटा और रनटाइम डेटा को एपीआई हब पर सुरक्षित तरीके से स्ट्रीम किया जा सकता है.
  • Google Cloud सेवा खाते: इनका इस्तेमाल, Apigee API Hub for Private Cloud कनेक्टर की सुरक्षित पुष्टि करने और उसे अनुमति देने के लिए किया जाता है. इससे यह कनेक्टर, Pub/Sub और API हब सेवाओं के साथ इंटरैक्ट कर पाता है.

इंटिग्रेशन का फ़्लो

डेटा ट्रांसफ़र और सटीक डेटा पाने के लिए, इंटिग्रेशन एक तय प्रोसेस का पालन करता है:

  1. शुरुआती सेटअप और प्रोविज़निंग:
    • इसके लिए, सबसे पहले एक Google Cloud प्रोजेक्ट सेट अप करें और उसमें API Hub को प्रोविज़न करें.
    • Google Cloud सेवा खाते बनाएं. साथ ही, "प्लगिन इंस्टेंस" बनाकर, Private Cloud संगठनों के लिए Apigee को API Hub के साथ रजिस्टर करें. इस चरण में, कॉन्फ़िगरेशन के लिए ज़रूरी यूनीक Pub/Sub विषय और प्लगिन इंस्टेंस आईडी दिए जाते हैं.
  2. Private Cloud कनेक्टर इंस्टॉल करने के लिए Apigee API hub:
    • Apigee API hub for Private Cloud कनेक्टर, एक आरपीएम पैकेज है. इसे Apigee for Private Cloud एनवायरमेंट के साथ-साथ, किसी खास वीएम पर इंस्टॉल किया जाता है. इसके लिए, Apigee for Private Cloud का ऐसा वर्शन होना ज़रूरी है जो इस सुविधा के साथ काम करता हो.
  3. Private Cloud Connector को कॉन्फ़िगर करने के लिए Apigee API हब:
    • कनेक्टर को एपीआई हब प्लगिन बनाते समय मिली जानकारी के साथ कॉन्फ़िगर किया जाता है. जैसे, Pub/Sub के विषय, प्लगिन इंस्टेंस आईडी, सेवा खाते की जानकारी.
    • Google Cloud की दोनों सेवाओं (सेवा खाते के पासकोड के ज़रिए) और Apigee Management Server (base64-encoded क्रेडेंशियल के ज़रिए) के लिए पुष्टि की जाती है.
    • शेयर किए गए NFS का पाथ भी यहां कॉन्फ़िगर किया जाता है.
  4. मैसेज प्रोसेसर (एमपी) का कॉन्फ़िगरेशन:
    • आपके Apigee मैसेज प्रोसेसर अपडेट किए जाते हैं, ताकि आंकड़ों के डेटा के लिए "डुअल-राइट" मेकेनिज़्म चालू किया जा सके. इसका मतलब है कि Analytics के रिकॉर्ड, Analytics के पारंपरिक सिस्टम और तय किए गए NFS शेयर, दोनों में लिखे जाते हैं.
  5. डेटा फ़्लो:
    • एपीआई मेटाडेटा: Private Cloud कनेक्टर के लिए Apigee API हब, Apigee मैनेजमेंट सर्वर से एपीआई मेटाडेटा को पुल करता है. इसके बाद, इसे Google Cloud में तय किए गए मेटाडेटा Pub/Sub विषय पर पब्लिश करता है. यह मेटाडेटा, API हब में फ़ीड होता है.
    • रनटाइम डेटा: मैसेज प्रोसेसर, Analytics डेटा को शेयर किए गए NFS में लिखते हैं. Apigee हब कनेक्टर, इस NFS की निगरानी करता है. साथ ही, रनटाइम डेटा को प्रोसेस करता है और उसे Google Cloud में मौजूद, तय किए गए रनटाइम डेटा Pub/Sub विषय पर पब्लिश करता है, ताकि उसे API हब में शामिल किया जा सके.
  6. निगरानी और समस्या हल करना:
    • Private Cloud कनेक्टर के लिए, Apigee API हब पर मौजूद लोकल स्टेटस एंडपॉइंट की मदद से, मेटाडेटा और रनटाइम डेटा के अपलोड की प्रोसेस को मॉनिटर किया जा सकता है.
    • स्टार्टअप, डेटा ट्रांसफ़र या कनेक्टिविटी से जुड़ी किसी भी समस्या को हल करने के लिए, लॉग की पूरी जानकारी उपलब्ध होती है.

परस्पर निर्भरता:

  • Apigee API Hub for Private Cloud कनेक्टर, NFS के सही तरीके से माउंट होने और खुद के साथ-साथ सभी मैसेज प्रोसेसर के लिए ऐक्सेस किए जा सकने पर निर्भर करता है.
  • डेटा को NFS में दो बार लिखने की सुविधा के लिए, मैसेज प्रोसेसर को कॉन्फ़िगर करना ज़रूरी है. इससे रनटाइम डेटा कलेक्शन की सुविधा चालू हो जाती है.
  • कनेक्टर के प्रमाणीकरण और डेटा पब्लिश करने की सुविधाओं के लिए, Google Cloud सेवा खाते की सही भूमिकाएं और API हब प्लगिन इंस्टेंस की जानकारी ज़रूरी है.

इस इंटिग्रेशन की मदद से, Apigee के ऑन-प्रिमाइसेस एपीआई को API Hub के ज़रिए एक ही जगह पर मैनेज किया जा सकता है. साथ ही, उन्हें देखा जा सकता है. इससे एपीआई को बेहतर तरीके से मैनेज करने और अहम जानकारी पाने में मदद मिलती है.