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

आपको Apigee Edge दस्तावेज़ दिख रहा है.
Apigee X दस्तावेज़ देखें.

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

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

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

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

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

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

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

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

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

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

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

शेयर किए गए फ़्लो को डेवलप करने के कुछ आसान तरीके:

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

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

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

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

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

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

    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

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

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

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

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

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

    Edge

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

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

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

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

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

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

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

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

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

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

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

एक साथ चेनिंग एपीआई प्रॉक्सी