Edge for Private Cloud v. 4.17.05
कंपनी की इमारत में, Edge Private Cloud या Edge इंस्टेंस में कई चीज़ों का इस्तेमाल किया जाता है सर्वर नोड के सेट पर इंस्टॉल किए गए Edge कॉम्पोनेंट. कारोबार के बारे में नीचे दी गई इमेज में, ग्रुप, पर्यावरण, और वर्चुअल होस्ट की मदद से Edge इंस्टेंस:
नीचे दी गई टेबल में, इन संबंधों के बारे में बताया गया है:
इसमें शामिल हैं |
इनसे जुड़ा है |
डिफ़ॉल्ट |
|
---|---|---|---|
ग्रह |
एक या एक से ज़्यादा क्षेत्र |
लागू नहीं |
|
क्षेत्र |
एक या उससे ज़्यादा पॉड |
"dc-1" |
|
पॉड |
एक या एक से ज़्यादा Edge कॉम्पोनेंट |
"सेंट्रल" |
|
संगठन |
एक या उससे ज़्यादा एनवायरमेंट |
एक या एक से ज़्यादा पॉड जिनमें मैसेज प्रोसेसर हों और संगठन के एडमिन के तौर पर काम करने वाला उपयोगकर्ता |
कोई नहीं |
परिवेश |
एक या उससे ज़्यादा वर्चुअल होस्ट |
पैरंट संगठन से जुड़े पॉड में एक या एक से ज़्यादा मैसेज प्रोसेसर |
कोई नहीं |
वर्चुअल होस्ट |
एक या उससे ज़्यादा होस्ट उपनाम |
कोई नहीं |
ग्रहों के बारे में जानकारी
प्लैनेट, एज हार्डवेयर और सॉफ़्टवेयर एनवायरमेंट के बारे में बताता है. इनमें ये चीज़ें शामिल हो सकती हैं एक या एक से ज़्यादा क्षेत्रों के लिए. एज में, ग्रह क्षेत्रों का तार्किक समूह होता है — आप नहीं Edge इंस्टॉल करने के लिए साफ़ तौर पर कोई ग्रह बनाएं या उसे कॉन्फ़िगर करें.
क्षेत्रों के बारे में जानकारी
क्षेत्र एक या उससे ज़्यादा पॉड का ग्रुप होता है. डिफ़ॉल्ट रूप से, जब आप Edge इंस्टॉल करते हैं, इंस्टॉलर "dc-1" नाम से एक क्षेत्र बनाता है इसमें तीन पॉड शामिल हैं, जैसा कि नीचे दी गई टेबल में बताया गया है दिखाता है:
क्षेत्र |
आपके इलाके में मौजूद पॉड |
---|---|
"dc-1" |
"गेटवे", "सेंट्रल", "ऐनलिटिक्स" |
नीचे दी गई इमेज में डिफ़ॉल्ट क्षेत्र दिखाए गए हैं:
इस इमेज में दिखाया गया है कि लोड बैलेंसर, ट्रैफ़िक को "गेटवे" पर ले जा रहा है पॉड. "गेटवे" पॉड इसमें Edge राऊटर और मैसेज प्रोसेसर के कॉम्पोनेंट होते हैं जो एपीआई अनुरोधों को हैंडल करते हैं. जब तक कि कई डेटा सेंटर को तय करने के लिए, आपको अतिरिक्त क्षेत्र बनाने की ज़रूरत नहीं होगी.
अधिक जटिल इंस्टॉलेशन में, आप दो या अधिक क्षेत्र बना सकते हैं. कॉन्टेंट बनाने की एक वजह कई क्षेत्रों में, मशीनों को भौगोलिक रूप से व्यवस्थित करना है. इस वजह से, नेटवर्क का ट्रांज़िट समय कम हो जाता है. तय सीमा में इस स्थिति में, एपीआई एंडपॉइंट को होस्ट किया जाता है, ताकि वे भौगोलिक रूप से के उपभोक्ताओं के लिए है.
Edge में, हर क्षेत्र को डेटा सेंटर कहा जाता है. दिल्ली में मौजूद डेटा सेंटर इसके बाद, पूर्वी अमेरिका, बोस्टन, मेसाचुसेट्स से आने वाले अनुरोधों को मैनेज कर सकता है. वहीं, एक डेटा सेंटर सिंगापुर, एशिया में डिवाइसों या कंप्यूटर से आने वाले अनुरोधों को मैनेज कर सकता है.
उदाहरण के लिए, नीचे दी गई इमेज में दो डेटा सेंटर के दो इलाके दिखाए गए हैं:
पॉड के बारे में जानकारी
पॉड, एक या उससे ज़्यादा एज कॉम्पोनेंट और कैसंड्रा डेटास्टोर का ग्रुप होता है. द एज कॉम्पोनेंट को एक ही नोड पर इंस्टॉल किया जा सकता है, लेकिन आम तौर पर, अलग-अलग नोड पर इंस्टॉल किए जाते हैं. कैसंड्रा डेटास्टोर एक डेटा रिपॉज़िटरी है. इसका इस्तेमाल पॉड में Edge कॉम्पोनेंट करते हैं.
डिफ़ॉल्ट रूप से, जब Edge इंस्टॉल किया जाता है, तो इंस्टॉलर तीन पॉड बनाता है और इसके बाद, Edge कॉम्पोनेंट और कैसंड्रा डेटास्टोर हर पॉड के साथ:
पॉड |
एज कॉम्पोनेंट |
कैसांद्रा के डेटास्टोर |
|
---|---|---|---|
"गेटवे" |
राऊटर, मैसेज प्रोसेसर |
कैश मेमोरी-डेटा स्टोर |
keyvaluemap-datastore |
"सेंट्रल" |
मैनेजमेंट सर्वर, ज़ूकीपर, LDAP, यूज़र इंटरफ़ेस (यूआई), Qpid |
application-datastore |
identityzone-datastore |
"आंकड़े" |
Postgres |
analytics-datastore |
reportcrud-datastore |
"गेटवे" में Edge कॉम्पोनेंट और कैसेंड्रा डेटास्टोर हैं एपीआई के लिए पॉड ज़रूरी हैं प्रोसेस चल रही है. एपीआई अनुरोधों को प्रोसेस करने के लिए, ये कॉम्पोनेंट और डेटास्टोर चालू होने चाहिए और चालू होने चाहिए. कॉन्टेंट बनाने "सेंट्रल" में कॉम्पोनेंट और डेटास्टोर और "Analytics" एपीआई को प्रोसेस करने के लिए, पॉड की ज़रूरत नहीं होती. लेकिन Edge में अतिरिक्त फ़ंक्शन जोड़ें.
नीचे दी गई इमेज में, हर पॉड के कॉम्पोनेंट दिखाए गए हैं:
इसकी मदद से, मैसेज प्रोसेसर और राऊटर पॉड को अतिरिक्त मैसेज प्रोसेसर और राऊटर पॉड के साथ जोड़ा जा सकता है. डिफ़ॉल्ट. इसके अलावा, किसी मौजूदा पॉड में अतिरिक्त Edge कॉम्पोनेंट जोड़े जा सकते हैं. उदाहरण के लिए, तो "गेटवे" में अतिरिक्त राऊटर और मैसेज प्रोसेसर जोड़े जा सकते हैं बढ़ोतरी को हैंडल करने के लिए पॉड ट्रैफ़िक लोड होता है.
ध्यान दें कि "गेटवे" पॉड में एज राऊटर और मैसेज प्रोसेसर के कॉम्पोनेंट होते हैं. राऊटर सिर्फ़ एक ही पॉड में मैसेज प्रोसेसर को अनुरोध भेजते हैं, न कि अन्य पॉड.
इसके आखिर में सर्वर रजिस्ट्रेशन की जानकारी देखने के लिए, इस एपीआई कॉल का इस्तेमाल किया जा सकता है हर पॉड को इंस्टॉल करें. यह निगरानी करने के लिए काम का एक टूल है.
curl -u adminEmail:pword http://<ms_IP>:8080/v1/servers?pod=podName
जहां ms_IP, मैनेजमेंट सर्वर का आईपी पता या डीएनएस नाम है, और podName इनमें से कोई एक है:
- गेटवे
- सेंट्रल
- 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 डेटास्टोर दिखाई देंगे.
संगठनों के बारे में जानकारी
संगठन किसी Apigee खाते के सभी ऑब्जेक्ट के लिए एक कंटेनर होता है, जिसमें ये शामिल हैं API, API प्रॉडक्ट, ऐप्लिकेशन, और डेवलपर. कोई संगठन एक या उससे ज़्यादा पॉड से जुड़ा होता है, जहां हर पॉड में एक या ज़्यादा मैसेज प्रोसेसर होने चाहिए.
Edge Private Cloud के ऑन-प्रिमाइस इंस्टॉलेशन में, डिफ़ॉल्ट रूप से कोई संगठन नहीं होता है. कोई संगठन बनाते समय, आपको दो तरह की जानकारी देनी होती है:
- वह उपयोगकर्ता जो संगठन के एडमिन के तौर पर काम करता है. इसके बाद, वह उपयोगकर्ता अतिरिक्त आईडी जोड़ सकता है उपयोगकर्ताओं को संगठन में जोड़ा जा सकता है और हर उपयोगकर्ता की भूमिका तय की जा सकती है.
- "गेटवे" पॉड, मैसेज प्रोसेसर वाला पॉड.
किसी संगठन में एक या उससे ज़्यादा एनवायरमेंट हो सकते हैं. Edge इंस्टॉल करने की डिफ़ॉल्ट प्रक्रिया आपको दो एनवायरमेंट बनाने का प्रॉम्प्ट देता है: "test" और "प्रॉडक्ट" शामिल हैं. हालांकि, आपको और लंबे समय तक ज़रूरत के मुताबिक, जैसे कि "स्टेजिंग", "एक्सपेरिमेंट" वगैरह.
संगठन, Apigee की कुछ सुविधाओं के लिए स्कोप उपलब्ध कराता है. उदाहरण के लिए, key-value-map (KVM) संगठन के लेवल पर डेटा उपलब्ध होता है. इसका मतलब है कि यह सभी एनवायरमेंट से लिया जा सकता है. अन्य सुविधाएं, जैसे, कैश मेमोरी में सेव किए जाने वाले डेटा का दायरा एक खास एनवायरमेंट तक सीमित होता है. Apigee Analytics के डेटा को मिलकर काम करने की प्रेरणा मिलती है.
यहां किसी संगठन के मुख्य ऑब्जेक्ट दिखाए गए हैं. इनमें दुनिया भर में तय किए गए ऑब्जेक्ट भी शामिल हैं संगठन और वे हैं जो ख़ास तौर पर एक एनवायरमेंट के लिए तय किए गए हैं:
एनवायरमेंट के बारे में जानकारी
एनवायरमेंट, किसी संगठन में एपीआई प्रॉक्सी के लिए रनटाइम को लागू करने का संदर्भ होता है. किसी एनवायरमेंट में एपीआई प्रॉक्सी को ऐक्सेस करने से पहले, आपको उसे डिप्लॉय करना होगा. आपके पास एपीआई को डिप्लॉय करने का विकल्प होता है किसी एक एनवायरमेंट या कई एनवायरमेंट के लिए प्रॉक्सी करना.
एक संगठन में कई एनवायरमेंट हो सकते हैं. उदाहरण के लिए, आपके पास "डेवलपर", "test" और "prod" संगठन में पर्यावरण को नुकसान पहुंचाता है.
जब कोई एनवायरमेंट बनाया जाता है, तो उसे एक या उससे ज़्यादा मैसेज प्रोसेसर के साथ जोड़ा जाता है. आप एनवायरमेंट की कल्पना मैसेज प्रोसेसर के नाम वाले सेट के तौर पर करें, जिस पर एपीआई प्रॉक्सी चलते हैं. कई परिवेश एक ही संदेश प्रोसेसर के साथ या किसी अन्य व्यक्ति के साथ संबद्ध हो सकता है.
एनवायरमेंट बनाने के लिए, दो तरह की जानकारी दें:
- एनवायरमेंट वाला संगठन.
- मैसेज प्रोसेसर, जो एनवायरमेंट में एपीआई प्रॉक्सी अनुरोधों को हैंडल करते हैं. ये मैसेज
प्रोसेसर, एनवायरमेंट के पैरंट संगठन से जुड़े पॉड में होने चाहिए.
अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है डिफ़ॉल्ट रूप से, जब कोई एनवायरमेंट बनाया जाता है, तो Edge सभी उपलब्ध मैसेज प्रोसेसर को "गेटवे" पॉड. वैकल्पिक रूप से, आप उपलब्ध मैसेज प्रोसेसर, ताकि अलग-अलग मैसेज प्रोसेसर अलग-अलग का इस्तेमाल करें.
मैसेज प्रोसेसर को कई एनवायरमेंट से जोड़ा जा सकता है. उदाहरण के लिए, आपका Edge इंस्टॉलेशन में दो मैसेज प्रोसेसर होते हैं: A और B. इसके बाद, तीन एनवायरमेंट बनाए जाते हैं संगठन: "dev", "test", और "prod":
- "डेवलपर" के लिए नहीं है, तो आप संदेश प्रोसेसर A को असोसिएट करते हैं, क्योंकि आपको बड़ी संख्या में ट्रैफ़िक आता है.
- "टेस्ट" के लिए एनवायरमेंट के तहत, आप मैसेज प्रोसेसर B को जोड़ते हैं, क्योंकि आपको बड़ी संख्या में ट्रैफ़िक आता है.
- "प्रोडक्शन" के लिए वातावरण में, आप संदेश प्रोसेसर A और B दोनों को प्रोडक्शन-लेवल वॉल्यूम.
किसी एनवायरमेंट के लिए असाइन किए गए मैसेज प्रोसेसर, एक ही पॉड के हो सकते हैं या इनमें से किसी भी हो सकते हैं कई पॉड, जो कई क्षेत्रों और डेटा सेंटर में फैले हुए हैं. उदाहरण के लिए, आप एनवायरमेंट "ग्लोबल" जिसमें तीन क्षेत्रों के मैसेज प्रोसेसर शामिल हैं, तीन अलग-अलग डेटा सेंटर का मतलब है: अमेरिका, जापान, और जर्मनी.
"ग्लोबल" में एपीआई प्रॉक्सी डिप्लॉय करना एनवायरमेंट की वजह से मैसेज पर एपीआई प्रॉक्सी काम करती है सभी तीन डेटा सेंटर में प्रोसेसर. एपीआई ट्रैफ़िक, इनमें से किसी भी एक राऊटर पर पहुंच रहा है इस डेटा सेंटर में मौजूद डेटा सेंटर को सिर्फ़ मैसेज प्रोसेसर पर भेजा जाएगा, क्योंकि राऊटर सिर्फ़ ट्रैफ़िक को एक ही पॉड में मैसेज प्रोसेसर पर डायरेक्ट करता है.
वर्चुअल होस्ट के बारे में जानकारी
वर्चुअल होस्ट, 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.
ज़्यादा जानकारी के लिए, http://apigee.com/docs/api-services/content/virtual-hosts पर जाएं.
अपना पहला संगठन बनाना, एनवायरमेंट, और वर्चुअल होस्ट
Edge इंस्टॉल करने की प्रोसेस पूरी होने के बाद, आपकी पहली कार्रवाई आम तौर पर "ऑनबोर्डिंग" के ज़रिए संगठन, वातावरण, और वर्चुअल होस्ट प्रोसेस. परफ़ॉर्म करने के लिए एज मैनेजमेंट सर्वर नोड पर नीचे दिया गया कमांड चलाएं:
/opt/apigee/apigee-service/bin/apigee-service apigee-provision setup-org -f configFile
यह निर्देश एक कॉन्फ़िगरेशन फ़ाइल के तौर पर इनपुट करता है, जो उपयोगकर्ता, संगठन, एनवायरमेंट, और वर्चुअल होस्ट.
उदाहरण के लिए, आपने:
- आपके संगठन के एडमिन के तौर पर काम करने वाला उपयोगकर्ता
- example नाम का संगठन
- संगठन में prod नाम का एक एनवायरमेंट, जो सभी मैसेज से जुड़ा होता है "गेटवे" में प्रोसेसर पॉड
- default एनवायरमेंट में मौजूद वर्चुअल होस्ट, जो पोर्ट पर एचटीटीपी ऐक्सेस करने की अनुमति देता है 9,001
- वर्चुअल होस्ट के लिए होस्ट का अन्य नाम
उस स्क्रिप्ट को चलाने के बाद, आप फ़ॉर्म में URL का उपयोग करके अपने API तक पहुंच सकते हैं:
http://<router-ip>:9001/{proxy-base-path}/{resource-name}
बाद में इतने संगठनों, एनवायरमेंट, और वर्चुअल होस्ट को जोड़ा जा सकता है.
शामिल होने के बारे में ज़्यादा जानकारी के लिए, यह देखें संगठन के मालिक हैं.