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

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

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

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

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

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

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

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

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

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

यहां दिए गए उदाहरण में, आने वाले उपयोगकर्ता के अनुरोधों की पुष्टि करने के लिए, दो एपीआई प्रॉक्सी एक शेयर फ़्लो पर कॉल (फ़्लोकॉल आउट नीति के साथ) की गई हैं. 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 के यूज़र इंटरफ़ेस (यूआई) में शेयर किया जाने वाला फ़्लो बनाना लेख पढ़ें.

    एपीआई प्रॉक्सी की तरह ही, अपने शेयर किए गए फ़्लो सोर्स आर्टफ़ैक्ट वाली 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

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

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

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

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

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

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

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

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

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

    Edge

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

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

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

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

    क्लासिक एज (प्राइवेट क्लाउड)

    क्लासिक 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. इंपोर्ट किए जा रहे सोर्स से नया फ़्लो बनाने के लिए, बिल्ड पर क्लिक करें.

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

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

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

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

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