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

Edge for Private Cloud v4.18.01

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

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

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

ग्रहों के बारे में

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

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

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

क्षेत्र	इस इलाके में पॉड
"dc-1"	"गेटवे", "सेंट्रल", "Analytics"

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

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

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

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

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

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

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

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

पॉड	एज कॉम्पोनेंट	कैसांड्रा डेटास्टोर
"gateway"	राऊटर, मैसेज प्रोसेसर	कैश डेटा स्टोर काउंटर-डेटास्टोर dc-datastore	कीvaluemap-datastore किमी-डेटास्टोर
"central"	मैनेजमेंट सर्वर, ज़ूकीपर, LDAP, यूज़र इंटरफ़ेस (यूआई), Qpid	application-datastore apimodel-datastore audit-datastore auth-datastore	Identityzone-datastore edgenotice-datastore मैनेजमेंट-सर्वर शेड्यूलर-datastore user-settings-datastore
"analytics"	पोस्टग्रेस	analytics-datastore	reportcrud-datastore

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

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

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

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

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

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

आउटपुट आपको इस फ़ॉर्म में दिखता है:

[ {
  "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 एट्रिब्यूट में यह बताया जाता है कि कॉम्पोनेंट किस तरह का है. ध्यान दें कि इसमें पॉड में रजिस्टर किए गए कैसेंद्रा डेटास्टोर मौजूद होते हैं. हालांकि, "गेटवे" पॉड में कैसेंड्रा नोड इंस्टॉल किए गए हैं, लेकिन आपको सभी पॉड के साथ रजिस्टर किए गए कैसेंड्रा डेटास्टोर दिखेंगे.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

कहां:

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

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

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