ग्रहों, जगहों, पॉड, संगठनों, वातावरणों, और वर्चुअल होस्ट के बारे में जानकारी

Edge for Private Cloud का वर्शन 4.18.05

Edge Private Cloud या Edge इंस्टेंस को कंपनी की इमारत में इंस्टॉल करने पर, सर्वर नोड के सेट पर कई Edge कॉम्पोनेंट इंस्टॉल होते हैं. यहां दी गई इमेज में, प्लैनेट, रीजन, पॉड, संगठन, एनवायरमेंट, और वर्चुअल होस्ट के बीच संबंध दिखाया गया है. इनसे मिलकर Edge इंस्टेंस बनता है:

यहां दी गई टेबल में, इन संबंधों के बारे में बताया गया है:

कॉम्पोनेंट इसमें शामिल है इससे संबद्ध डिफ़ॉल्ट
Planet एक या इससे ज़्यादा क्षेत्र लागू नहीं
क्षेत्र एक या उससे ज़्यादा पॉड "dc-1"
पॉड एक या उससे ज़्यादा Edge कॉम्पोनेंट "central"
"gateway"
"analytics"
संगठन एक या उससे ज़्यादा एनवायरमेंट एक या इससे ज़्यादा पॉड, जिनमें मैसेज प्रोसेसर शामिल हों. साथ ही, संगठन के एडमिन के तौर पर काम करने वाला कोई उपयोगकर्ता कोई नहीं
परिवेश एक या उससे ज़्यादा वर्चुअल होस्ट पैरंट संगठन से जुड़े पॉड में मौजूद एक या उससे ज़्यादा मैसेज प्रोसेसर कोई नहीं
वर्चुअल होस्ट एक या इससे ज़्यादा होस्ट उपनाम कोई नहीं

Planets के बारे में जानकारी

प्लैनेट, पूरे Edge हार्डवेयर और सॉफ़्टवेयर एनवायरमेंट को दिखाता है. इसमें एक या उससे ज़्यादा इलाके शामिल हो सकते हैं. Edge में, प्लैनेट का मतलब क्षेत्रों के लॉजिकल ग्रुप से है: Edge इंस्टॉल करते समय, आपको साफ़ तौर पर कोई प्लैनेट बनाने या कॉन्फ़िगर करने की ज़रूरत नहीं होती.

क्षेत्रों के बारे में जानकारी

रीजन, एक या उससे ज़्यादा पॉड का ग्रुप होता है. Edge इंस्टॉल करने पर, इंस्टॉलर डिफ़ॉल्ट रूप से "dc-1" नाम का एक रीजन बनाता है. इसमें तीन पॉड होते हैं, जैसा कि इस टेबल में दिखाया गया है:

क्षेत्र क्षेत्र में मौजूद पॉड
"dc-1" "gateway", "central", "analytics"

इस इमेज में डिफ़ॉल्ट क्षेत्र दिखाए गए हैं:

इस इमेज में, लोड बैलेंसर को "गेटवे" पॉड पर ट्रैफ़िक भेजते हुए दिखाया गया है. "गेटवे" पॉड में एज राऊटर और मैसेज प्रोसेसर कॉम्पोनेंट होते हैं. ये एपीआई अनुरोधों को मैनेज करते हैं. जब तक एक से ज़्यादा डेटा सेंटर तय नहीं किए जाते, तब तक आपको अन्य क्षेत्र बनाने की ज़रूरत नहीं है.

अगर इंस्टॉलेशन ज़्यादा मुश्किल है, तो दो या इससे ज़्यादा क्षेत्र बनाए जा सकते हैं. एक से ज़्यादा क्षेत्र बनाने की एक वजह, मशीनों को भौगोलिक तौर पर व्यवस्थित करना है. इससे नेटवर्क ट्रांज़िट समय कम हो जाता है. इस मामले में, एपीआई एंडपॉइंट को इस तरह होस्ट किया जाता है कि वे भौगोलिक तौर पर उन एपीआई के उपभोक्ताओं के करीब हों.

Edge में, हर इलाके को डेटा सेंटर कहा जाता है. इसके बाद, अमेरिका के पूर्वी इलाके में मौजूद डेटा सेंटर, बॉस्टन, मैसाचुसेट्स से आने वाले अनुरोधों को मैनेज कर सकता है. वहीं, सिंगापुर में मौजूद डेटा सेंटर, एशिया में मौजूद डिवाइसों या कंप्यूटर से आने वाले अनुरोधों को मैनेज कर सकता है.

उदाहरण के लिए, इस इमेज में दो डेटा सेंटर के हिसाब से दो इलाके दिखाए गए हैं:

पॉड के बारे में जानकारी

पॉड, एक या उससे ज़्यादा Edge कॉम्पोनेंट और Cassandra डेटास्टोर का ग्रुप होता है. Edge के कॉम्पोनेंट को एक ही नोड पर इंस्टॉल किया जा सकता है. हालांकि, आम तौर पर इन्हें अलग-अलग नोड पर इंस्टॉल किया जाता है. Cassandra डेटास्टोर, एक डेटा रिपॉज़िटरी है. इसका इस्तेमाल पॉड में मौजूद Edge कॉम्पोनेंट करते हैं.

डिफ़ॉल्ट रूप से, Edge इंस्टॉल करने पर, इंस्टॉलर तीन पॉड बनाता है. साथ ही, हर पॉड के साथ Edge के ये कॉम्पोनेंट और Cassandra डेटास्टोर असोसिएट करता है:

पॉड Edge के कॉम्पोनेंट

Cassandra डेटास्टोर
"गेटवे" राऊटर, मैसेज प्रोसेसर cache-datastore
counter-datastore
dc-datastore 		keyvaluemap-datastore
kms-datastore
"सेंट्रल" मैनेजमेंट सर्वर, Zookeeper, LDAP, यूज़र इंटरफ़ेस (यूआई), Qpid application-datastore
apimodel-datastore
audit-datastore
auth-datastore		 identityzone-datastore
edgenotification-datastore
management-server
scheduler-datastore
user-settings-datastore
"analytics" Postgres analytics-datastore reportcrud-datastore

एपीआई प्रोसेसिंग के लिए, "गेटवे" पॉड में Edge कॉम्पोनेंट और Cassandra डेटास्टोर ज़रूरी हैं. एपीआई अनुरोधों को प्रोसेस करने के लिए, इन कॉम्पोनेंट और डेटास्टोर का चालू होना ज़रूरी है. एपीआई को प्रोसेस करने के लिए, "सेंट्रल" और "ऐनलिटिक्स" पॉड में मौजूद कॉम्पोनेंट और डेटास्टोर की ज़रूरत नहीं होती. हालांकि, ये Edge में अतिरिक्त सुविधाएं जोड़ते हैं.

इस इमेज में, हर पॉड के कॉम्पोनेंट दिखाए गए हैं:

डिफ़ॉल्ट रूप से बनाए गए तीन मैसेज प्रोसेसर और राऊटर पॉड के अलावा, अन्य मैसेज प्रोसेसर और राऊटर पॉड भी जोड़े जा सकते हैं. इसके अलावा, किसी मौजूदा पॉड में अतिरिक्त Edge कॉम्पोनेंट जोड़े जा सकते हैं. उदाहरण के लिए, बढ़ते ट्रैफ़िक लोड को मैनेज करने के लिए, "गेटवे" पॉड में अतिरिक्त राऊटर और मैसेज प्रोसेसर जोड़े जा सकते हैं.

ध्यान दें कि "गेटवे" पॉड में Edge राऊटर और मैसेज प्रोसेसर कॉम्पोनेंट शामिल हैं. राउटर, सिर्फ़ एक ही पॉड में मौजूद मैसेज प्रोसेसर को अनुरोध भेजते हैं. वे दूसरे पॉड में मौजूद मैसेज प्रोसेसर को अनुरोध नहीं भेजते.

हर पॉड के लिए इंस्टॉलेशन के आखिर में, सर्वर रजिस्ट्रेशन की जानकारी देखने के लिए, यहां दिए गए एपीआई कॉल का इस्तेमाल किया जा सकता है. यह मॉनिटर करने के लिए एक काम का टूल है.

curl -u adminEmail:pword http://ms_IP:8080/v1/servers?pod=podName

जहां ms_IP, मैनेजमेंट सर्वर का आईपी पता या डीएनएस नाम है, और podName इनमें से कोई एक है:

  • gateway
  • central
  • analytics

उदाहरण के लिए, "गेटवे" पॉड के लिए:

curl -u adminEmail:pword http://ms_IP:8080/v1/servers?pod=gateway

Apigee, यहां दिए गए आउटपुट जैसा आउटपुट दिखाता है:

[ {
  "externalHostName" : "localhost",
  "externalIP" : "192.168.1.11",
  "internalHostName" : "localhost",
  "internalIP" : "192.168.1.11",
  "isUp" : true,
  "pod" : "gateway",
  "reachable" : true,
  "region" : "dc-1",
  "tags" : {
    "property" : [ {
      "name" : "jmx.rmi.port",
      "value" : "1101"
    }, ... ]
  },
  "type" : [ "message-processor" ],
  "uUID" : "276bc250-7dd0-46a5-a583-fd11eba786f8"
}, 
{
  "internalIP" : "192.168.1.11",
  "isUp" : true,
  "pod" : "gateway",
  "reachable" : true,
  "region" : "dc-1",
  "tags" : {
    "property" : [ ]
  },
  "type" : [ "dc-datastore", "management-server", "cache-datastore", "keyvaluemap-datastore", "counter-datastore", "kms-datastore" ],
  "uUID" : "13cee956-d3a7-4577-8f0f-1694564179e4"
},
{
  "externalHostName" : "localhost",
  "externalIP" : "192.168.1.11",
  "internalHostName" : "localhost",
  "internalIP" : "192.168.1.11",
  "isUp" : true,
  "pod" : "gateway",
  "reachable" : true,
  "region" : "dc-1",
  "tags" : {
    "property" : [ {
      "name" : "jmx.rmi.port",
      "value" : "1100"
    }, ... ]
  },
  "type" : [ "router" ],
  "uUID" : "de8a0200-e405-43a3-a5f9-eabafdd990e2"
} ]

type एट्रिब्यूट, कॉम्पोनेंट टाइप की सूची दिखाता है. ध्यान दें कि इसमें पॉड में रजिस्टर किए गए Cassandra डेटास्टोर की सूची होती है. Cassandra नोड, "गेटवे" पॉड में इंस्टॉल होते हैं. हालांकि, आपको Cassandra डेटास्टोर, सभी पॉड के साथ रजिस्टर किए हुए दिखेंगे.

संगठनों के बारे में जानकारी

संगठन, Apigee खाते में मौजूद सभी ऑब्जेक्ट के लिए एक कंटेनर होता है. इसमें एपीआई, एपीआई प्रॉडक्ट, ऐप्लिकेशन, और डेवलपर शामिल होते हैं. कोई संगठन, एक या उससे ज़्यादा पॉड से जुड़ा होता है. हर पॉड में एक या उससे ज़्यादा मैसेज प्रोसेसर होने चाहिए.

Edge Private Cloud के ऑन-प्राइमिस इंस्टॉलेशन में, डिफ़ॉल्ट रूप से कोई संगठन नहीं होता. संगठन बनाते समय, आपको दो तरह की जानकारी देनी होती है:

  1. ऐसा उपयोगकर्ता जो संगठन के एडमिन के तौर पर काम करता है. इसके बाद, वह उपयोगकर्ता संगठन में अन्य उपयोगकर्ताओं को जोड़ सकता है. साथ ही, हर उपयोगकर्ता की भूमिका सेट कर सकता है.
  2. "गेटवे" पॉड, जिसमें मैसेज प्रोसेसर होते हैं.

किसी संगठन में एक या उससे ज़्यादा एनवायरमेंट हो सकते हैं. Edge को इंस्टॉल करने की डिफ़ॉल्ट प्रोसेस में, आपको दो एनवायरमेंट बनाने के लिए कहा जाता है: "test" और "prod". हालांकि, ज़रूरत के हिसाब से ज़्यादा एनवायरमेंट बनाए जा सकते हैं. जैसे, "स्टेजिंग", "एक्सपेरिमेंट" वगैरह.

संगठन, Apigee की कुछ सुविधाओं के लिए स्कोप उपलब्ध कराता है. उदाहरण के लिए, की-वैल्यू-मैप (केवीएम) डेटा, संगठन के लेवल पर उपलब्ध होता है. इसका मतलब है कि यह सभी एनवायरमेंट से उपलब्ध होता है. कैश मेमोरी जैसी अन्य सुविधाएं, किसी खास एनवायरमेंट के लिए उपलब्ध होती हैं. Apigee के आंकड़ों के डेटा को संगठन और एनवायरमेंट के कॉम्बिनेशन के हिसाब से बांटा जाता है.

यहां किसी संगठन के मुख्य ऑब्जेक्ट दिखाए गए हैं. इनमें संगठन में ग्लोबल तौर पर तय किए गए ऑब्जेक्ट और किसी खास एनवायरमेंट के लिए तय किए गए ऑब्जेक्ट शामिल हैं:

एनवायरमेंट के बारे में जानकारी

एनवायरमेंट, किसी संगठन में एपीआई प्रॉक्सी के लिए रनटाइम एक्ज़ीक्यूशन कॉन्टेक्स्ट होता है. किसी एपीआई प्रॉक्सी को ऐक्सेस करने से पहले, आपको उसे किसी एनवायरमेंट में डिप्लॉय करना होगा. एपीआई प्रॉक्सी को एक या कई एनवायरमेंट में डिप्लॉय किया जा सकता है.

किसी संगठन में कई एनवायरमेंट हो सकते हैं. उदाहरण के लिए, किसी संगठन में "dev", "test", और "prod" एनवायरमेंट तय किया जा सकता है.

कोई एनवायरमेंट बनाते समय, उसे एक या उससे ज़्यादा मैसेज प्रोसेसर से जोड़ा जाता है. एनवायरमेंट को मैसेज प्रोसेसर के सेट के तौर पर समझा जा सकता है. इस सेट में मौजूद मैसेज प्रोसेसर पर एपीआई प्रॉक्सी चलती हैं. हर एनवायरमेंट को एक ही मैसेज प्रोसेसर या अलग-अलग मैसेज प्रोसेसर से जोड़ा जा सकता है.

एनवायरमेंट बनाने के लिए, ये दो जानकारी दें:

  1. वह संगठन जिसमें एनवायरमेंट मौजूद है.
  2. ऐसे मैसेज प्रोसेसर जो एनवायरमेंट के लिए, एपीआई प्रॉक्सी के अनुरोधों को मैनेज करते हैं. ये मैसेज प्रोसेसर, एनवायरमेंट के पैरंट संगठन से जुड़े पॉड में होने चाहिए.
    डिफ़ॉल्ट रूप से, जब कोई एनवायरमेंट बनाया जाता है, तो Edge "गेटवे" पॉड में मौजूद सभी मैसेज प्रोसेसर को उस एनवायरमेंट से जोड़ देता है. इसके अलावा, उपलब्ध मैसेज प्रोसेसर के सबसेट को तय किया जा सकता है, ताकि अलग-अलग मैसेज प्रोसेसर, अलग-अलग एनवायरमेंट के अनुरोधों को मैनेज कर सकें.

मैसेज प्रोसेसर को कई एनवायरमेंट से जोड़ा जा सकता है. उदाहरण के लिए, आपके Edge इंस्टॉलेशन में दो मैसेज प्रोसेसर हैं: A और B. इसके बाद, अपने संगठन में तीन एनवायरमेंट बनाए जाते हैं: "dev", "test", और "prod":

  • "dev" एनवायरमेंट के लिए, मैसेज प्रोसेसर A को असोसिएट किया जाता है, क्योंकि आपको ज़्यादा ट्रैफ़िक की उम्मीद नहीं है.
  • "टेस्ट" एनवायरमेंट के लिए, मैसेज प्रोसेसर B को जोड़ा जाता है, क्योंकि आपको ज़्यादा ट्रैफ़िक की उम्मीद नहीं होती.
  • "prod" एनवायरमेंट के लिए, मैसेज प्रोसेसर A और B, दोनों को असोसिएट किया जाता है, ताकि प्रोडक्शन-लेवल वॉल्यूम को मैनेज किया जा सके.

किसी एनवायरमेंट को असाइन किए गए मैसेज प्रोसेसर, एक ही पॉड या कई पॉड से हो सकते हैं. ये पॉड, कई इलाकों और डेटा सेंटर में फैले हो सकते हैं. उदाहरण के लिए, आपने अपने संगठन में "ग्लोबल" एनवायरमेंट तय किया है. इसमें तीन इलाकों के मैसेज प्रोसेसर शामिल हैं. इसका मतलब है कि तीन अलग-अलग डेटा सेंटर: अमेरिका, जापान, और जर्मनी.

"ग्लोबल" एनवायरमेंट में एपीआई प्रॉक्सी को डिप्लॉय करने से, एपीआई प्रॉक्सी तीनों डेटा सेंटर में मैसेज प्रोसेसर पर चलता है. इनमें से किसी भी डेटा सेंटर में मौजूद राऊटर पर आने वाले एपीआई ट्रैफ़िक को, सिर्फ़ उस डेटा सेंटर में मौजूद मैसेज प्रोसेसर पर भेजा जाएगा. ऐसा इसलिए, क्योंकि राऊटर सिर्फ़ उसी पॉड में मौजूद मैसेज प्रोसेसर पर ट्रैफ़िक भेजते हैं.

वर्चुअल होस्ट के बारे में जानकारी

वर्चुअल होस्ट, Edge राऊटर पर उस पोर्ट को तय करता है जिस पर एपीआई प्रॉक्सी को एक्सपोज़ किया जाता है. साथ ही, एक्सटेंशन के ज़रिए वह यूआरएल तय करता है जिसका इस्तेमाल ऐप्लिकेशन, एपीआई प्रॉक्सी को ऐक्सेस करने के लिए करते हैं. हर एनवायरमेंट में कम से कम एक वर्चुअल होस्ट तय करना ज़रूरी है.

पक्का करें कि वर्चुअल होस्ट ने जो पोर्ट नंबर बताया है वह राऊटर नोड पर खुला हो. इसके बाद, यहां दिए गए यूआरएल पर अनुरोध करके, एपीआई प्रॉक्सी को ऐक्सेस किया जा सकता है:

http://routerIP:port/proxy-base-path/resource-name
https://routerIP:port/proxy-base-path/resource-name

कहां:

  • http या https: अगर वर्चुअल होस्ट को टीएलएस/एसएसएल के साथ काम करने के लिए कॉन्फ़िगर किया गया है, तो एचटीटीपीएस का इस्तेमाल करें. अगर वर्चुअल होस्ट, टीएलएस/एसएसएल के साथ काम नहीं करता है, तो एचटीटीपी का इस्तेमाल करें.
  • routerIP:port, वर्चुअल होस्ट का आईपी पता और पोर्ट नंबर है.
  • proxy-base-path और resource-name को एपीआई प्रॉक्सी बनाते समय तय किया जाता है.

आम तौर पर, आईपी पते और पोर्ट नंबर वाले ग्राहकों के लिए एपीआई पब्लिश नहीं किए जाते. इसके बजाय, आपको राऊटर और पोर्ट के लिए डीएनएस एंट्री तय करनी होगी. उदाहरण के लिए:

http://myAPI.myCo.com/proxy-base-path/resource-name
https://myAPI.myCo.com/proxy-base-path/resource-name

आपको वर्चुअल होस्ट के लिए एक होस्ट उपनाम भी बनाना होगा, जो डीएनएस एंट्री के डोमेन नेम से मेल खाता हो. ऊपर दिए गए उदाहरण के मुताबिक, आपको myAPI.myCo.com का होस्ट उपनाम तय करना होगा. अगर आपके पास डीएनएस एंट्री नहीं है, तो होस्ट उपनाम को राऊटर के आईपी पते और वर्चुअल होस्ट के पोर्ट पर सेट करें, जैसे कि routerIP:port.

ज़्यादा जानकारी के लिए, वर्चुअल होस्ट के बारे में जानकारी देखें.

अपना पहला संगठन, एनवायरमेंट, और वर्चुअल होस्ट बनाना

Edge को इंस्टॉल करने की प्रोसेस पूरी करने के बाद, आम तौर पर आपको "शामिल होने" की प्रोसेस के ज़रिए संगठन, एनवायरमेंट, और वर्चुअल होस्ट बनाना होता है. ऑनबोर्डिंग की प्रोसेस पूरी करने के लिए, Edge मैनेजमेंट सर्वर नोड पर यह कमांड चलाएं:

/opt/apigee/apigee-service/bin/apigee-service apigee-provision setup-org -f configFile

यह कमांड, इनपुट के तौर पर एक कॉन्फ़िगरेशन फ़ाइल लेता है. इसमें उपयोगकर्ता, संगठन, एनवायरमेंट, और वर्चुअल होस्ट की जानकारी होती है.

उदाहरण के लिए, आपने ये बनाए हैं:

  • आपकी पसंद का कोई उपयोगकर्ता, जो संगठन के एडमिन के तौर पर काम करेगा
  • example नाम का संगठन
  • संगठन में prod नाम का एक एनवायरमेंट, जो "गेटवे" पॉड में मौजूद सभी मैसेज प्रोसेसर से जुड़ा है
  • default नाम के एनवायरमेंट में एक वर्चुअल होस्ट, जो पोर्ट 9001 पर एचटीटीपी ऐक्सेस की अनुमति देता है
  • वर्चुअल होस्ट के लिए होस्ट का उपनाम

स्क्रिप्ट चलाने के बाद, इस फ़ॉर्मैट में यूआरएल का इस्तेमाल करके अपने एपीआई ऐक्सेस किए जा सकते हैं:

http://routerIP:9001/proxy-base-path/resource-name

बाद में, जितने चाहें उतने संगठन, एनवायरमेंट, और वर्चुअल होस्ट जोड़े जा सकते हैं.

ज़्यादा जानकारी के लिए, किसी संगठन को शामिल करना लेख पढ़ें.