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

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

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

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

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

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

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

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

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

  • security है.
  • लॉगिंग, ताकि गड़बड़ी के स्टैंडर्ड मैसेज जनरेट किए जा सकें.
  • मीडिएशन की प्रोसेस का इस्तेमाल करती है.

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

शेयर किया जाने वाला फ़्लो बनाना

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

शेयर किया गया फ़्लो बनाने के लिए, यहां बताया गया तरीका अपनाएं:

  1. यह तय करें कि सुविधाओं का शेयर किया गया सेट कैसा होना चाहिए.

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

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

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

    उदाहरण के लिए, ट्रैफ़िक मैनेजमेंट की सहायता के तौर पर, आपके पास स्पाइक को रोकने के लिए नीति लागू करने का विकल्प होता है. इससे हर सेकंड सिर्फ़ 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>

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

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

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

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

    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, शेयर किए गए फ़्लो को कॉलआउट करता है. डेटा का इस्तेमाल करने वाली एपीआई प्रॉक्सी को शेयर किए गए फ़्लो के बाद और शेयर किए गए फ़्लो के उसी एनवायरमेंट में डिप्लॉय किया जाना चाहिए. अगर आपको 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. ट्रैक करें टैब में, एपीआई प्रॉक्सी से शेयर किए गए फ़्लो तक के फ़्लो की जांच करें.

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

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

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

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

    Edge

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

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

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

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

    क्लासिक Edge (निजी क्लाउड)

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

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

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

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

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

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

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

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

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

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

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

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

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

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