Apigee Edge पर Node.js के साथ शुरुआत करना

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

इस विषय में, मैनेजमेंट यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करके, Node.js ऐप्लिकेशन को एपीआई प्रॉक्सी में रैप करने का सबसे आसान तरीका बताया गया है.

परिचय

ज़्यादातर मामलों में, आपने जो पहला Node.js ऐप्लिकेशन बनाया होगा वह एक एचटीटीपी सर्वर होगा. यह सर्वर, "Hello World!" के साथ अनुरोधों का जवाब देता है. Apigee Edge पर Node.js को आज़माने का सबसे आसान तरीका यह है कि आप ऐसा ही कुछ करें. माउस से कुछ क्लिक करके, Edge पर Node.js का एक प्रॉक्सी वाला एचटीटीपी सर्वर चलाया जा सकता है. इसके बाद, यूज़र इंटरफ़ेस (यूआई) में मौजूद कोड एडिटर का इस्तेमाल करके, Node.js ऐप्लिकेशन में बदलाव किया जा सकता है. साथ ही, Node.js की अन्य फ़ाइलें, नीतियां वगैरह जोड़ी जा सकती हैं.

Hello World! का सैंपल बनाना एपीआई प्रॉक्सी

इस सेक्शन में, Edge एपीआई प्रॉक्सी बनाने का तरीका बताया गया है. यह प्रॉक्सी, Node.js एचटीटीपी सर्वर के साथ इंटरैक्ट करती है. Node.js एचटीटीपी सर्वर का कोड आपके लिए पहले से लिखा गया है. इन आसान चरणों को पूरा करने पर, यह कोड Edge पर अपने-आप डिप्लॉय हो जाता है.
  1. प्रॉक्सी बनाने के विज़र्ड में, Node.js ऐप्लिकेशन चुनें.
  2. आगे बढ़ें पर क्लिक करें.
  3. प्रॉक्सी बनाने के विज़र्ड के निर्देशों का पालन करें और ये विकल्प चुनें.
    फ़ील्ड चुनें
    जानकारी
    प्रॉक्सी का नाम Nodejs-Hello डालें. यह आपके एपीआई के लिए दिखने वाला नाम है.
    प्रॉक्सी का बेस पाथ nodejs-hello डालें
    स्रोत "Hello World" का सैंपल चुनें. (हम इस विषय में, अन्य विकल्पों के बारे में बाद में चर्चा करेंगे.)
    ब्यौरा एपीआई का ब्यौरा डालें.
    सुरक्षा
    पास थ्रू (कोई नहीं) पास थ्रू (कोई नहीं) चुनें. इससे, पास थ्रू की एक सामान्य प्रॉक्सी बनती है.
    वर्चुअल होस्ट
    डिफ़ॉल्ट, सुरक्षित डिफ़ॉल्ट सेटिंग में कोई बदलाव न करें. वर्चुअल होस्ट के बारे में जानने के लिए, वर्चुअल होस्ट के बारे में जानकारी (बीटा) देखें.
    बनाएं
    एनवायरमेंट डिप्लॉय करें टेस्ट चुनें.
  4. बनाएं और डिप्लॉय करें
    पर क्लिक करें. इसके जवाब में, आपको एक पुष्टि दिखनी चाहिए. इसमें बताया गया हो कि आपकी नई एपीआई प्रॉक्सी, 'टेस्ट' एनवायरमेंट में सफलतापूर्वक बनाई और डिप्लॉय की गई है.
  5. एपीआई प्रॉक्सी का ज़्यादा जानकारी वाला पेज देखने के लिए, एडिटर में <proxy name> प्रॉक्सी देखें पर क्लिक करें.

hello प्रॉक्सी को कॉल करना

hello प्रॉक्सी को कॉल करने पर, Node.js ऐप्लिकेशन अपने-आप चलता है और "Hello, World!" के साथ जवाब देता है. ध्यान दें कि अगर आपने कोई और एनवायरमेंट तय नहीं किया है, तो Node.js ऐप्लिकेशन, टेस्ट नाम के एनवायरमेंट में डिप्लॉय किया जाता है. test. यहां Curl का इस्तेमाल करके, बुनियादी कॉल दिया गया है. इसमें अपने संगठन के नाम की जगह myorg डालें. 
$ curl http://myorg-test.apigee.net/nodejs-hello
Hello, World!

Node.js कोड देखना और उसमें बदलाव करना

आइए, एपीआई प्रॉक्सी में जोड़े गए Node.js कोड को देखें. Hello World प्रॉक्सी के खास जानकारी वाले पेज पर जाएं और 'डेवलप करें' पर क्लिक करें.



इससे, 'डेवलप करें' व्यू खुलता है. इसमें एक कोड एडिटर शामिल होता है. यहां सीधे कोड में बदलाव किया जा सकता है.

उदाहरण के लिए, जवाब को Hello, World! से बदलकर कुछ और करें, जैसे कि Hello, Node!. इसके बाद, सेव करें पर क्लिक करें. प्रॉक्सी सेव हो जाती है और फिर से डिप्लॉय हो जाती है.

आखिर में, बदलाव की पुष्टि करने के लिए, प्रॉक्सी को फिर से कॉल करें:

$ curl http://myorg-test.apigee.net/nodejs-hello
Hello, Node!

Apigee Edge पर Node.js ऐप्लिकेशन चलाने के बारे में ज़्यादा जानकारी

Apigee Edge पर चलने वाले Node.js ऐप्लिकेशन, अन्य Node.js ऐप्लिकेशन की तरह ही कंट्रोल के एक थ्रेड में चलते हैं. किसी दूसरे थ्रेड को शुरू करने या थ्रेड के बीच वैरिएबल को सिंक करने की ज़रूरत नहीं होती. साथ ही, ऐसा किया भी नहीं जा सकता. Node.js, नॉन-ब्लॉकिंग प्रोग्रामिंग लागू करता है. इसलिए, एक स्क्रिप्ट एक साथ हज़ारों अनुरोधों को प्रोसेस कर सकती है. इसकी वजह यह है कि स्क्रिप्ट को किसी चीज़ के लिए इंतज़ार करना पड़ता है, तो वह सीपीयू को छोड़ देती है. इसके बाद, जब वह चीज़ उपलब्ध हो जाती है, तो स्क्रिप्ट को सूचना मिलती है.

Apigee Edge पर Node.js का इस्तेमाल करने के लिए, आपको Node.js की मुख्य स्क्रिप्ट वाली फ़ाइल तय करनी होगी. इस स्क्रिप्ट को, आने वाले अनुरोधों को हैंडल करने के लिए कॉन्फ़िगर करना होगा. आम तौर पर, इसके लिए http या https मॉड्यूल का इस्तेमाल किया जाता है. साथ ही, एक क्लाइंट बनाया जाता है वगैरह. (अगर मुख्य स्क्रिप्ट को इस तरह कॉन्फ़िगर नहीं किया जाता है, तो वह डिप्लॉय होने के बाद, बस चलेगी और बंद हो जाएगी.) Apigee Edge में, हर Node.js ऐप्लिकेशन स्क्रिप्ट, प्रॉक्सी के डिप्लॉय होने पर शुरू से चलती है. वहीं, प्रॉक्सी के अनडिप्लॉय होने पर बंद हो जाती है. इसके बीच, यह नए अनुरोधों का इंतज़ार करेगी और उन्हें प्रोसेस करेगी. ज़्यादा जानकारी के लिए, स्टैंडअलोन Node.js ऐप्लिकेशन डिप्लॉय करना में "इंपोर्ट की गई Node.js फ़ाइल को कॉल करना" देखें.

अगले चरण

फ़ाइल सिस्टम से सीधे, स्टैंडअलोन Node.js ऐप्लिकेशन भी बनाए और डिप्लॉय किए जा सकते हैं. अगले विषय, स्टैंडअलोन Node.js ऐप्लिकेशन डिप्लॉय करना में, कमांड लाइन से Node.js ऐप्लिकेशन डिप्लॉय करने के लिए, apigeetool कमांड का इस्तेमाल करने का तरीका बताया गया है.