कमांड लाइन से प्रॉक्सी डिप्लॉय करना

आपको Apigee Edge का दस्तावेज़ दिख रहा है.
Apigee X के दस्तावेज़ पर जाएं. जानकारी

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

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

अगर आपको मुख्य तौर पर मैनेजमेंट यूज़र इंटरफ़ेस (यूआई) में काम करना है, तो यूज़र इंटरफ़ेस (यूआई) में प्रॉक्सी डिप्लॉय करना लेख पढ़ें.

आपको Apigee Edge का दस्तावेज़ दिख रहा है.
Apigee X के दस्तावेज़ पर जाएं. जानकारी

Apigee Edge Python डिप्लॉय टूल को चलाना

Apigee Edge Python डिप्लॉय टूल, Edge Management API के साथ काम करता है. इससे एपीआई प्रॉक्सी इंपोर्ट और डिप्लॉय की जा सकती हैं. यह टूल, GitHub पर एपीआई प्लैटफ़ॉर्म के सैंपल डिस्ट्रिब्यूशन के हिस्से के तौर पर उपलब्ध है. एपीआई प्रॉक्सी के सैंपल का इस्तेमाल करना लेख पढ़ें.

Apigee Edge Python टूल का इस्तेमाल करके, अपने एपीआई को एक आसान प्रोसेस में इंपोर्ट (अपलोड) और डिप्लॉय करें.

डप्लॉय टूल को एपीआई प्लैटफ़ॉर्म के डिस्ट्रिब्यूशन में मौजूद बेस डायरेक्ट्री से चलाना होगा. एपीआई प्लैटफ़ॉर्म के डिस्ट्रिब्यूशन में मौजूद बेस डायरेक्ट्री, setup और tools डायरेक्ट्री की पैरंट डायरेक्ट्री होती है.

नीचे दिए गए निर्देश में, प्रॉक्सी का नाम, Edge का उपयोगकर्ता नाम और पासवर्ड, Edge संगठन और एनवायरमेंट, और उस डायरेक्ट्री का पाथ डालें जिसमें एपीआई प्रॉक्सी की "apiproxy" डायरेक्ट्री शामिल है:

python tools/deploy.py -n proxyname -u name:passW -o org -e env -d proxypath -p /

उदाहरण के लिए:

python tools/deploy.py -n weatherapi -u me@myCo.com:foo -o myCo -e test -d weatherapi -p /

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

डिप्लॉय टूल, आपकी एपीआई प्रॉक्सी के मौजूदा वर्शन का अपने-आप पता लगाता है. साथ ही, मौजूदा वर्शन को अनडिप्लॉय करता है और एपीआई प्रॉक्सी के अपडेट किए गए वर्शन को डिप्लॉय करता है.

सफल होने पर, आपको इस फ़ॉर्म में आउटपुट दिखेगा:

Writing ./<proxybasedir>/apiproxy/weatherapi.xml to apiproxy/weatherapi.xml
Writing ./<proxybasedir>/apiproxy/proxies/default.xml to apiproxy/proxies/default.xml
Writing ./<proxybasedir>/apiproxy/targets/default.xml to apiproxy/targets/default.xml
Imported new proxy version 1
Environment: test
  Revision: 1 BasePath = /
  State: deployed

डिफ़ॉल्ट रूप से, यह टूल एपीआई प्रॉक्सी को https://api.enterprise.apigee.com पर अपलोड करता है. यह क्लाउड में Edge से जुड़ा होता है. इस टूल का इस्तेमाल करके, एपीआई प्रॉक्सी को Edge के ऑन-प्रिमाइसेस वर्शन पर भी अपलोड किया जा सकता है. इसके लिए, -h फ़्लैग तय करें:

python tools/deploy.py -n weatherapi -u me@myCo.com:foo -o myCo -e test -d weatherapi -p / -h https://192.168.11.111:8080

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

https://ms_URL:8080

कमांड के लिए फ़्लैग की पूरी सूची यहां दी गई है:

• -n: आपकी एपीआई प्रॉक्सी का नाम.
• -u: Apigee Edge में किसी संगठन के लिए आपके खाते का उपयोगकर्ता नाम और पासवर्ड.
• -o: उस संगठन का नाम जिसमें आपका खाता है.
• -e: वह एनवायरमेंट जिसमें एपीआई प्रॉक्सी को डिप्लॉय किया जाना चाहिए (test या prod).
• -d: यह उस डायरेक्ट्री का पाथ होता है जिसमें आपकी एपीआई प्रॉक्सी फ़ाइलें मौजूद होती हैं. आपकी एपीआई प्रॉक्सी फ़ाइलें, "apiproxy" नाम की डायरेक्ट्री में सेव होनी चाहिए. यह वैल्यू, उस डायरेक्ट्री का पाथ होती है जिसमें "apiproxy" डायरेक्ट्री होती है. यह "apiproxy" डायरेक्ट्री का पाथ नहीं होती.
• -p: यह यूआरआई पाथ, पैटर्न मैच के तौर पर इस्तेमाल किया जाता है. इससे इस एपीआई प्रॉक्सी डिप्लॉयमेंट पर आने वाले मैसेज को रूट किया जाता है. ज़्यादातर मामलों में, इस वैल्यू को '/' पर सेट किया जा सकता है. हालांकि, अगर आपको ऐडवांस डिप्लॉयमेंट और राउटिंग की ज़रूरत है, तो ऐसा न करें. एपीआई प्रॉक्सी राउटिंग के लिए इस्तेमाल किया जाने वाला प्राइमरी पाथ, एपीआई प्रॉक्सी की ProxyEndpoint कॉन्फ़िगरेशन फ़ाइल में तय किया जाता है.
• -h: Edge का यूआरएल. डिफ़ॉल्ट रूप से, यूआरएल https://api.enterprise.apigee.com होता है, जो क्लाउड में Edge से मेल खाता है. कंपनी की इमारत में डिप्लॉयमेंट के लिए, Edge मैनेजमेंट सर्वर के यूआरएल और पोर्ट 8080 का इस्तेमाल करें. जैसे:

  https://ms_URL:8080

  इसके अलावा, मैनेजमेंट सर्वर के आईपी पते का इस्तेमाल करें. जैसे, https://192.168.11.111:8080 में दिखाया गया है.

डिप्लॉय शेल स्क्रिप्ट को कॉन्फ़िगर करना और उसे चलाना

सबसे आसान तरीका यह है कि सैंपल एपीआई प्रॉक्सी के साथ दी गई डिप्लॉय स्क्रिप्ट को चलाएं. शेल स्क्रिप्ट, Apigee Edge Python डिप्लॉय टूल को रैप करती हैं.

/simplyProxy डायरेक्ट्री रन से:

आपको यह दिखना चाहिए:

Enter your password for user {myname} in the Apigee Enterprise organization {org_name}, followed by [ENTER]: 

अपना पासवर्ड डालें और ENTER दबाएं.

इसके बाद, आपको यह दिखेगा:

Deploying to test on https://api.enterprise.apigee.com using {myname} on enterprise.apigee.com and {org_name} on enterprise.apigee.com

अगर आपको यह दिखता है:

Enter your password for user Your USERNAME on enterprise.apigee.com in the Apigee Enterprise organization Your ORG on enterprise.apigee.com, followed by [ENTER]: 

इसका मतलब है कि आपको प्लैटफ़ॉर्म के सैंपल डिस्ट्रिब्यूशन में मौजूद /setup/setenv.sh फ़ाइल में बदलाव करना होगा. निर्देशों के लिए, README या Apigee Edge API देखें.

सफल होने पर, डिप्लॉय टूल /apiproxy, में मौजूद फ़ाइलों को ZIP करता है. इसके बाद, Apigee Edge पर आपके संगठन के लिए पैकेज इंपोर्ट करता है. इसके बाद, एपीआई प्रॉक्सी को 'test' एनवायरमेंट में डिप्लॉय करता है.

आपकी एपीआई प्रॉक्सी को शुरू किया जा सकता है.