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

Edge for Private Cloud v. 4.17.01

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ज़्यादा जानकारी के लिए, http://apigee.com/docs/api-services/content/virtual-hosts पर जाएं.

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

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

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

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

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

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

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

http://<router-ip>:9001/{proxy-base-path}/{resource-name}

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

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