होस्ट किए गए टारगेट की खास जानकारी

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

होस्ट किए गए टारगेट की मदद से, Apigee के होस्ट किए गए नेटिव रनटाइम एनवायरमेंट में Node.js ऐप्लिकेशन चलाए जा सकते हैं. होस्ट किए गए टारगेट का मकसद आसान है: इनकी मदद से ऐप्लिकेशन को नेटिव, सुरक्षित, बढ़ाने लायक, और अलग किए गए एनवायरमेंट में डिप्लॉय किया जा सकता है, जहां Edge API प्रॉक्सी के ज़रिए इन्हें टारगेट सेवाओं के तौर पर कॉल किया जा सकता है.

जैसा कि नीचे दिए गए डायग्राम में दिखाया गया है, Edge एपीआई प्रॉक्सी एक Node.js ऐप्लिकेशन को कॉल करता है, जिसे होस्ट किए गए टारगेट एनवायरमेंट में डिप्लॉय किया जाता है. ध्यान दें कि होस्ट किए गए टारगेट एनवायरमेंट का दायरा Apigee संगठन:एनवायरमेंट के दायरे में होता है.

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

होस्ट किए गए टारगेट एपीआई किस ऐप्लिकेशन रनटाइम के साथ काम करते हैं?

फ़िलहाल, होस्ट किए गए टारगेट पर सिर्फ़ Node.js ऐप्लिकेशन डिप्लॉय किए जा सकते हैं.

होस्ट किए गए टारगेट इंस्टॉल करना

होस्ट किए गए टारगेट, Edge के सार्वजनिक क्लाउड से जुड़े सभी संगठनों में उपलब्ध है. होस्ट किए गए टारगेट का इस्तेमाल करने के लिए, आपको कुछ भी इंस्टॉल करने की ज़रूरत नहीं होती.

इसकी पुष्टि की जा रही है कि होस्ट किए गए टारगेट चालू हैं या नहीं

अगर आपको यह पुष्टि करनी है कि आपके संगठन के होस्ट किए गए टारगेट की सुविधा चालू है, तो अपने संगठन की जानकारी पाएं. साथ ही, पक्का करें कि features.isEdgeFunctionsEnabled प्रॉपर्टी सही पर सेट हो. प्रॉपर्टी को सिर्फ़ पढ़ा जा सकता है.

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

https://api.enterprise.apigee.com/v1/organizations/myorg

  {
     "createdAt":1507572884047,
     "createdBy":"jdoe@apigee.com",
     "displayName":"myorg",
     "environments":[
        "prod",
        "dev",
        "test",
        "portal"
     ],
     "lastModifiedAt":1507578673194,
     "lastModifiedBy":"jdoe@apigee.com",
     "name":"jdoe",
     "properties":{
        "property":[
           {
              "name":"features.isSmbOrganization",
              "value":"false"
           },
           {
              "name":"self.service.virtual.host.enabled",
              "value":"true"
           },
           {
              "name":"features.isCpsEnabled",
              "value":"true"
           },
           {
              "name":"features.isEdgeFunctionsEnabled",
              "value":"true"
           }
        ]
     },
     "type":"paid"
  }
  

होस्ट किए गए टारगेट के बारे में आपको क्या जानने की ज़रूरत है

होस्ट किए गए टारगेट, Node.js ऐप्लिकेशन को ऐसे नेटिव एनवायरमेंट में चलाने की अनुमति देते हैं जो किसी Apigee की खास रन-टाइम टेक्नोलॉजी पर निर्भर नहीं है. अपने ऐप्लिकेशन को डिप्लॉय करने से पहले, उसे स्थानीय तौर पर डीबग और टेस्ट किया जा सकता है. साथ ही, इस बात का भरोसा रखें कि डिप्लॉय किया गया वर्शन ठीक वैसे ही काम करेगा जैसे स्थानीय तौर पर करता है. डिप्लॉयमेंट के समय, आपके पास होस्ट किए गए टारगेट में अपना ऐप्लिकेशन चलाने के लिए, कोई भी ऐप्लिकेशन रनटाइम वर्शन चुनने का विकल्प होता है. उदाहरण के लिए, आपके पास खास तौर पर v8.10.0 एनवायरमेंट में Node.js ऐप्लिकेशन को चलाने का विकल्प होता है.

सीमाएं

होस्ट किए गए टारगेट के लिए इस्तेमाल की सीमाओं के बारे में जानने के लिए, Apigee प्रॉडक्ट की सीमाएं देखें.

फ़ॉलो करने के बुनियादी तरीके

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

होस्ट किए गए टारगेट का इस्तेमाल करने के लिए, आपको नीचे दिए गए टास्क पूरे करने होंगे. ट्यूटोरियल में इनमें से हर काम के बारे में विस्तार से बताया गया है.

  • अपने Node.js ऐप्लिकेशन को स्थानीय तौर पर डेवलप और टेस्ट करें.
  • अपने ऐप्लिकेशन प्रोजेक्ट की रूट डायरेक्ट्री में, मेनिफ़ेस्ट फ़ाइल बनाएं. मेनिफ़ेस्ट एक YAML फ़ाइल है, जो ऐप्लिकेशन बनाने और डिप्लॉय करने के लिए ज़रूरी जानकारी के बारे में बताती है.
  • अपने ऐप्लिकेशन को EDGE प्रॉक्सी में होस्ट किए गए रिसॉर्स टाइप के तौर पर जोड़ें.
  • प्रॉक्सी के टारगेट एंडपॉइंट में, एक खाली <HostedTarget/> टैग जोड़ें. यह टैग Edge को होस्ट किए गए टारगेट एनवायरमेंट में Node.js ऐप्लिकेशन को डिप्लॉय करने का निर्देश देता है. उदाहरण के लिए:
  • <?xml version="1.0" encoding="UTF-8"?>
    <TargetEndpoint name="default">
       <PreFlow name="PreFlow">
          <Request />
          <Response />
       </PreFlow>
       <PostFlow name="PostFlow">
          <Request />
          <Response />
       </PostFlow>
       <Flows />
       <HostedTarget />
    </TargetEndpoint>

होस्ट किए गए टारगेट ऐप्लिकेशन का स्कोप

होस्ट किए गए टारगेट ऐप्लिकेशन का दायरा, एज संगठन के एनवायरमेंट के हिसाब से होता है. यह स्कोपिंग किसी भी Edge प्रॉक्सी के समान होती है.

क्या होस्ट किए गए टारगेट ऐप्लिकेशन, प्रॉक्सी डेटा को ऐक्सेस कर सकते हैं?

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

एम्बेड किए गए Node.js (यह Edge में आम तौर पर Trireme पर आधारित Node.js के साथ काम करता है) के साथ, फ़्लो वैरिएबल और दूसरी इकाइयों को ऐक्सेस करने के लिए, apigee-access का इस्तेमाल किया जा सकता है. हालांकि, होस्ट किए गए टारगेट, Node.js डिप्लॉयमेंट के लिए apigee-access मॉड्यूल के साथ काम नहीं करते. यह भी देखें क्या apigee-access की कमी को दूर किया जा सकता है?

मौजूदा ऐप्लिकेशन कोड को होस्ट किए गए टारगेट में माइग्रेट करना

फ़िलहाल, परंपरागत Trireme पर आधारित एम्बेड किए गए Node.js ऐप्लिकेशन से, होस्ट किए गए टारगेट तक अपने-आप माइग्रेट होने का कोई पाथ मौजूद नहीं है. हालांकि, मौजूदा ऐप्लिकेशन कोड को मैन्युअल तौर पर होस्ट किए गए टारगेट में बदला जा सकता है. उदाहरण के लिए, मौजूदा Node.js प्रॉक्सी को होस्ट किए गए टारगेट प्रॉक्सी पर माइग्रेट करना देखें.