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

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

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

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

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

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

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

Apigee Edge का Python डिप्लॉयमेंट टूल, एपीआई प्रॉक्सी को इंपोर्ट और डिप्लॉय करने के लिए, Edge मैनेजमेंट एपीआई के साथ काम करता है. यह टूल, 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: उस डायरेक्ट्री का पाथ जिसमें आपकी एपीआई प्रॉक्सी फ़ाइलें हैं. आपकी एपीआई प्रॉक्सी फ़ाइलें, "apiप्रॉक्सी" नाम की डायरेक्ट्री में ही सेव होनी चाहिए. यह वैल्यू उस डायरेक्ट्री का पाथ है जिसमें "apiप्रॉक्सी" डायरेक्ट्री शामिल है, न कि "apiप्रॉक्सी" डायरेक्ट्री के पाथ का.
• -p: यूआरआई पाथ, पैटर्न मैच के तौर पर इस्तेमाल किया जाता है, ताकि आने वाले मैसेज को इस एपीआई प्रॉक्सी डिप्लॉयमेंट पर रूट किया जा सके. ज़्यादातर मामलों में, इस वैल्यू को '/' पर सेट किया जा सकता है. ऐसा तब तक किया जा सकता है, जब तक कि आपके पास डिप्लॉयमेंट और रूटिंग की बेहतर ज़रूरी शर्तें न हों. एपीआई प्रॉक्सी रूटिंग के लिए इस्तेमाल किया जाने वाला मुख्य पाथ, एपीआई प्रॉक्सी की प्रॉक्सीEndpoint कॉन्फ़िगरेशन फ़ाइल में बताया गया है.
• -h: किनारे का यूआरएल. डिफ़ॉल्ट रूप से, यूआरएल https://api.enterprise.apigee.com होता है. यह क्लाउड में Edge से जुड़ा होता है. कंपनी की इमारत में डिप्लॉयमेंट के लिए, Edge मैनेजमेंट सर्वर और पोर्ट 8080 के यूआरएल का इस्तेमाल करें, जैसे कि:

  https://ms_URL:8080

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

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

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

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

$ sh deploy.sh

आपको यह दिखेगा:

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 पर आपके संगठन में इंपोर्ट करता है और फिर, एपीआई प्रॉक्सी को 'टेस्ट' एनवायरमेंट में डिप्लॉय करता है.

आपका एपीआई प्रॉक्सी इंपोर्ट करने के लिए तैयार है.