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

Edge for Private Cloud v4.18.05

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

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

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

ग्रहों के बारे में जानकारी

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

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

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

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

नीचे दी गई इमेज में, डिफ़ॉल्ट तौर पर लागू होने वाले क्षेत्र दिखाए गए हैं:

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

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

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

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

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

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

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

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

एपीआई प्रोसेसिंग के लिए, "गेटवे" पॉड में Edge कॉम्पोनेंट और Cassandra डेटास्टोर ज़रूरी हैं. एपीआई अनुरोधों को प्रोसेस करने के लिए, ये कॉम्पोनेंट और डेटास्टोर चालू होने चाहिए. "सेंट्रल" और "Analytics" पॉड में मौजूद कॉम्पोनेंट और डेटास्टोर, एपीआई को प्रोसेस करने के लिए ज़रूरी नहीं हैं. हालांकि, ये 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 को डिफ़ॉल्ट रूप से इंस्टॉल करने की प्रोसेस के दौरान, आपसे दो एनवायरमेंट बनाने के लिए कहा जाता है: "टेस्ट" और "प्रोडक्शन". हालांकि, ज़रूरत के हिसाब से ज़्यादा एनवायरमेंट बनाए जा सकते हैं. जैसे, "स्टैजिंग", "प्रयोग" वगैरह.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

कहां:

• http या https: अगर वर्चुअल होस्ट को TLS/एसएसएल के साथ काम करने के लिए कॉन्फ़िगर किया गया है, तो एचटीटीपीएस का इस्तेमाल करें. अगर वर्चुअल होस्ट, TLS/SSL के साथ काम नहीं करता है, तो एचटीटीपी का इस्तेमाल करें.
• 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 Management Server नोड पर यह कमांड चलाएं:

/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

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

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