फिर से इस्तेमाल किए जा सकने वाले शेयर किए गए फ़्लो

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

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

शेयर किए गए फ़्लो की मदद से, एक ही जगह पर ऐसी सुविधाओं को कैप्चर किया जा सकता है जो कई जगहों पर काम की होती हैं. इससे आपको एक जैसी सुविधाएं देने, डेवलपमेंट में लगने वाला समय कम करने, और कोड को ज़्यादा आसानी से मैनेज करने में मदद मिलती है.

यहां दिए गए वीडियो में, Edge के यूज़र इंटरफ़ेस (यूआई) में शेयर किया गया फ़्लो बनाने और उसे ट्रेस करने का तरीका बताया गया है.

यहां दिए गए पांच मिनट के वीडियो में, Classic Edge के यूज़र इंटरफ़ेस (यूआई) (सिर्फ़ Private Cloud के लिए Edge) में शेयर किया गया फ़्लो बनाने और उसे ट्रेस करने का तरीका बताया गया है.

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

FlowCallout नीति के बारे में जानकारी के लिए, FlowCallout नीति देखें. फ़्लो हुक के बारे में ज़्यादा जानने के लिए, फ़्लो हुक का इस्तेमाल करके शेयर किया गया फ़्लो जोड़ना देखें.

उदाहरण के लिए, मान लें कि आपके पास ऐसी सुविधाएं हैं जिनका इस्तेमाल कई जगहों पर किया जाता है या जिन्हें आपके संगठन में एपीआई के लिए स्टैंडर्ड के तौर पर इस्तेमाल किया जाना चाहिए. आपके पास हर कैटगरी के लिए शेयर किया गया फ़्लो हो सकता है. जैसे:

• सुरक्षा, जिसमें OAuth और एपीआई पासकोड की पुष्टि करने के लिए ऑथराइज़ेशन कोड के साथ-साथ, खतरों से सुरक्षा देने वाला कोड भी शामिल है.
• लॉगिंग, जिसमें गड़बड़ी के स्टैंडर्ड मैसेज जनरेट किए जाते हैं.
• मीडिएशन, जिसमें XML और JSON मैसेज फ़ॉर्मैट के बीच बदलाव किया जाता है.

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

शेयर किया गया फ़्लो डेवलप करना

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

शेयर किया गया फ़्लो डेवलप करने के लिए, यहां सामान्य तरीका बताया गया है:

1. तय करें कि शेयर की जाने वाली सुविधाओं का सेट क्या होना चाहिए.

   उदाहरण के लिए, आपके पास ट्रैफ़िक मैनेजमेंट की सुविधाओं को एक साथ इस्तेमाल करने का विकल्प होता है. इनमें ट्रैफ़िक स्पाइक को दबाना भी शामिल है. इस तरह, कारोबार की लाइन वाली लॉजिक को लागू करने वाले लोगों के वर्कफ़्लो से बाहर, इनके कॉन्फ़िगरेशन को मैनेज किया जा सकता है.

2. शेयर किया गया फ़्लो डेवलप करें नीतियों और काम के संसाधनों को लागू करके. ठीक वैसे ही जैसे एपीआई प्रॉक्सी डेवलप करते समय किया जाता है.

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

   उदाहरण के लिए, ट्रैफ़िक मैनेजमेंट की सुविधा के तहत, Spike Arrest नीति लागू की जा सकती है, ताकि हर सेकंड सिर्फ़ 30 अनुरोधों की अनुमति दी जा सके. जैसे, यहां दिए गए उदाहरण में:

   <SpikeArrest async="false" continueOnError="false" enabled="true" name="Spike-Arrest">
       <DisplayName>Spike Arrest</DisplayName>
       <Properties/>
       <Identifier ref="request.header.some-header-name"/>
       <MessageWeight ref="request.header.weight"/>
       <Rate>30ps</Rate>
   </SpikeArrest>

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

   <SharedFlow name="default">
       <Step>
           <Name>Spike-Arrest</Name>
       </Step>
   </SharedFlow>

   मैनेजमेंट कंसोल में शेयर किया गया फ़्लो शुरू करने के तरीके के बारे में जानने के लिए, Edge के यूज़र इंटरफ़ेस (यूआई) में शेयर किया गया फ़्लो बनाना देखें.

   एपीआई प्रॉक्सी की तरह, शेयर किए गए फ़्लो के सोर्स आर्टफ़ैक्ट वाली zip फ़ाइल इंपोर्ट की जा सकती है. प्रॉक्सी इंपोर्ट करने के बारे में ज़्यादा जानने के लिए, नया एपीआई प्रॉक्सी इंपोर्ट करना देखें. यहां बताया गया है कि मैनेजमेंट एपीआई की मदद से, शेयर किया गया फ़्लो कैसे इंपोर्ट किया जाता है:

   curl -X POST -F "file=@/path/to/zip/file.zip" \ 'https://api.enterprise.apigee.com/v1/o/{org_name}/sharedflows?action=import&name=shared-flow-name' \
   -u email:password

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

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

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

   curl -X POST --header "Content-Type: application/octet-stream" \
   https://api.enterprise.apigee.com/v1/o/{org_name}/e/{env_name}/sharedflows/{shared_flow_name}/revisions/{revision_number}/deployments \
   -u email:password

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

   curl -X POST --header "Content-Type:application/x-www-form-urlencoded" \
   https://api.enterprise.apigee.com/v1/o/{org_name}/e/{env_name}/sharedflows/{shared_flow_name}/revisions/{revision_number}/deployments?"override=true" \
   -u email:password

4. इस्तेमाल करने वाली एपीआई प्रॉक्सी डेवलप करें, ताकि यह अपने फ़्लो के हिस्से के तौर पर, शेयर किए गए फ़्लो को कॉल कर सके.

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

   शेयर किए गए फ़्लो का इस्तेमाल करने के लिए, उस प्रॉक्सी या शेयर किए गए फ़्लो में FlowCallout नीति जोड़ें जो इसका इस्तेमाल करेगी. Service Callout नीति की तरह, जिससे किसी दूसरी सेवा को कॉल किया जाता है, a FlowCallout नीति से शेयर किए गए फ़्लो को कॉल किया जाता है. इस्तेमाल करने वाली एपीआई प्रॉक्सी को, शेयर किए गए फ़्लो के बाद और उसी एनवायरमेंट में डिप्लॉय किया जाना चाहिए जिसमें शेयर किया गया फ़्लो डिप्लॉय किया गया है. FlowCallout नीति का इस्तेमाल करके, शेयर किए गए फ़्लो को कॉल करने की जांच करने के लिए, शेयर किया गया फ़्लो डिप्लॉय किया जाना चाहिए.

   यहां दिए गए कोड में, FlowCallout नीति, शेयर किए गए फ़्लो को कॉल करती है जिसे traffic-management-shared कहा जाता है.

   <FlowCallout async="false" continueOnError="false" enabled="true" name="Traffic-Management-Flow-Callout">
       <DisplayName>Traffic Management FlowCallout</DisplayName>
       <Properties/>
       <SharedFlowBundle>traffic-management-shared</SharedFlowBundle>
   </FlowCallout>

   ज़्यादा जानकारी के लिए, एपीआई प्रॉक्सी या शेयर किए गए फ़्लो से शेयर किया गया फ़्लो कॉल करना देखें

5. शेयर किए गए फ़्लो का इस्तेमाल शुरू करने के लिए, इस्तेमाल करने वाली एपीआई प्रॉक्सी को डिप्लॉय करें. (डिप्लॉयमेंट के बारे में ज़्यादा जानने के लिए, डिप्लॉयमेंट के बारे में जानकारी देखें.)
6. ट्रेस करके, बार-बार डेवलप करें. ठीक वैसे ही जैसे एपीआई प्रॉक्सी के साथ किया जाता है.

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

   इसका तरीका यहां बताया गया है:

   1. पक्का करें कि शेयर किया गया फ़्लो और FlowCallout नीति का इस्तेमाल करके इसे कॉल करने वाली एपीआई प्रॉक्सी, दोनों एक ही संगठन में हों और एक ही एनवायरमेंट में डिप्लॉय की गई हों.
   2. एपीआई प्रॉक्सी के ट्रेस टैब पर, एपीआई प्रॉक्सी को ट्रेस करना शुरू करें.
   3. एपीआई प्रॉक्सी में, प्रॉक्सी एंडपॉइंट को अनुरोध भेजें. एंडपॉइंट से मिलने वाले फ़्लो में, FlowCallout नीति शामिल होनी चाहिए. यह नीति, शेयर किए गए फ़्लो को कॉल करती है.
   4. ट्रेस टैब पर, एपीआई प्रॉक्सी से शेयर किए गए फ़्लो तक के फ़्लो की जांच करें.

      ध्यान दें कि ट्रेसिंग में, शेयर किए गए फ़्लो को चरणों या नीतियों के सेट के तौर पर दिखाया जाता है. यह सेट, ग्रे बॉक्स में बंद होता है. शेयर किए गए फ़्लो से पहले, FlowCallout नीतियों को दिखाने वाले आइकॉन दिखते हैं. ट्रेसिंग के बारे में ज़्यादा जानने के लिए, ट्रेस टूल का इस्तेमाल करना देखें.)

      

Edge के यूज़र इंटरफ़ेस (यूआई) में शेयर किया गया फ़्लो बनाना

Apigee Edge के यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करके, शेयर किया गया फ़्लो बनाया जा सकता है. इसके लिए, शुरुआत से फ़्लो बनाया जा सकता है या मौजूदा फ़्लो सोर्स को फ़्लो बंडल .zip फ़ाइल के तौर पर इंपोर्ट किया जा सकता है.

1. शेयर किए गए फ़्लो वाले पेज को ऐक्सेस करें. इसके लिए, यहां दिया गया तरीका अपनाएं. शेयर किए गए फ़्लो वाले पेज पर, संगठन में शेयर किए गए फ़्लो की सूची देखी जा सकती है. साथ ही, सूची में मौजूद फ़्लो में बदलाव किया जा सकता है या उन्हें मिटाया जा सकता है.

   Edge

   Edge के यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करके, शेयर किए गए फ़्लो वाले पेज को ऐक्सेस करने के लिए:

   1. apigee.com/edge में साइन इन करें.
   2. वह संगठन चुनें जिसमें शेयर किया गया फ़्लो मौजूद है. अपने संगठनों के बीच स्विच करना देखें.

      शेयर किया गया फ़्लो, इस संगठन से किसी एनवायरमेंट में डिप्लॉय की गई किसी भी एपीआई प्रॉक्सी और शेयर किए गए फ़्लो के लिए उपलब्ध होगा. यह इस संगठन से बाहर के लोगों के लिए उपलब्ध नहीं होगा.

   3. बाईं ओर मौजूद नेविगेशन बार में, डेवलप करें > शेयर किए गए फ़्लो चुनें.

   Classic Edge (Private Cloud)

   Classic Edge के यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करके, शेयर किए गए फ़्लो वाले पेज को ऐक्सेस करने के लिए:

   1. http://ms-ip:9000 में साइन इन करें. यहां ms-ip, मैनेजमेंट सर्वर नोड का आईपी पता या डीएनएस नाम है.
   2. वह संगठन चुनें जिसमें शेयर किया गया फ़्लो मौजूद है. अपने संगठनों के बीच स्विच करना देखें.

      शेयर किया गया फ़्लो, इस संगठन से किसी एनवायरमेंट में डिप्लॉय की गई किसी भी एपीआई प्रॉक्सी और शेयर किए गए फ़्लो के लिए उपलब्ध होगा. यह इस संगठन से बाहर के लोगों के लिए उपलब्ध नहीं होगा.

   3. सबसे ऊपर मौजूद नेविगेशन बार में, एपीआई > शेयर किए गए फ़्लो चुनें.
2. शेयर किया गया नया फ़्लो जोड़ने के लिए, + शेयर किया गया फ़्लो बटन पर क्लिक करें.
3. शेयर किया गया फ़्लो बनाएं पेज पर, नया फ़्लो बनाने का तरीका चुनें:
   • शुरुआत से नया फ़्लो बनाएं. आपके पास फ़्लो में चरणों के तौर पर, नीतियां और संसाधन कॉन्फ़िगर करने का विकल्प होगा.
     1. शेयर किया गया खाली फ़्लो चुनें.
     2. नाम की वैल्यू डालें. एपीआई प्रॉक्सी और अन्य शेयर किए गए फ़्लो इस शेयर किए गए फ़्लो को रेफ़र करने के लिए इस नाम का इस्तेमाल करेंगे. नाम ऐसा होना चाहिए जिससे फ़्लो का इस्तेमाल करने वाले डेवलपर को इसके बारे में पता चल सके.
     3. फ़्लो के काम के बारे में ज़्यादा जानकारी देने के लिए, ब्यौरा डालें.
     4. आगे बढ़ें पर क्लिक करें.
     5. ज़रूरी नहीं: वे एनवायरमेंट चुनें जिनमें आपको नया फ़्लो डिप्लॉय करना है.

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

     6. चुने गए एनवायरमेंट में, शेयर किया गया नया फ़्लो बनाने और उसे डिप्लॉय करने के लिए, बनाएं और डिप्लॉय करें पर क्लिक करें. अगर आपने कोई एनवायरमेंट नहीं चुना है, तो शेयर किया गया फ़्लो बन जाएगा, लेकिन डिप्लॉय नहीं होगा.

   • मौजूदा सोर्स से शेयर किया गया फ़्लो बनाने के लिए, फ़्लो बंडल अपलोड करें.
     1. शेयर किया गया फ़्लो बंडल चुनें, ताकि .zip फ़ाइल तय की जा सके. इसमें वे आर्टफ़ैक्ट शामिल होते हैं जो आपको नए फ़्लो में चाहिए.

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

     2. आगे बढ़ें पर क्लिक करें.
     3. इंपोर्ट करने के लिए, शेयर किए गए फ़्लो के सोर्स वाली .zip फ़ाइल ब्राउज़ करने के लिए, फ़ाइल चुनें पर क्लिक करें.
     4. शेयर किए गए फ़्लो का नाम बॉक्स में, इंपोर्ट किए गए फ़्लो के लिए कोई नाम डालें. एपीआई प्रॉक्सी और अन्य शेयर किए गए फ़्लो, इस शेयर किए गए फ़्लो को रेफ़र करने के लिए इस नाम का इस्तेमाल करेंगे. नाम ऐसा होना चाहिए जिससे फ़्लो का इस्तेमाल करने वाले डेवलपर को इसके बारे में पता चल सके.
     5. आगे बढ़ें पर क्लिक करें.
     6. इंपोर्ट किए जा रहे सोर्स से नया फ़्लो बनाने के लिए, बनाएं पर क्लिक करें.

एपीआई प्रॉक्सी या शेयर किए गए फ़्लो से शेयर किया गया फ़्लो कॉल करना

FlowCallout नीति का इस्तेमाल करके, प्रॉक्सी या किसी अन्य शेयर किए गए फ़्लो से, शेयर किए गए फ़्लो को कॉल किया जा सकता है.

1. Edge के यूज़र इंटरफ़ेस (यूआई) में, वह प्रॉक्सी या शेयर किया गया फ़्लो ढूंढें जिससे आपको किसी अन्य शेयर किए गए फ़्लो को कॉल करना है.
2. नेविगेटर में, नीतियां के बगल में मौजूद, + बटन पर क्लिक करें.
3. नीतियों की सूची में, एक्सटेंशन में जाकर, FlowCallout पर क्लिक करें.
4. दिखाने के लिए नाम और नाम (यूनीक आइडेंटिफ़ायर) डालें. इसके बाद, वह शेयर किया गया फ़्लो चुनें जिसे यह नीति कॉल करेगी.
5. जोड़ें पर क्लिक करें.
6. नई FlowCallout नीति को उस प्रॉक्सी में जोड़ें जहां आपको कॉल करना है.

इन्हें भी देखें

एपीआई प्रॉक्सी को एक साथ चेन करना