পুনঃব্যবহারযোগ্য শেয়ার্ড ফ্লো

আপনি Apigee Edge ডকুমেন্টেশন দেখছেন।
Apigee X ডকুমেন্টেশনে যান । তথ্য

আপনি নীতি এবং সংস্থানগুলিকে একটি ভাগ করা প্রবাহে একত্রিত করতে পারেন যা আপনি একাধিক API প্রক্সি থেকে এমনকি অন্যান্য ভাগ করা প্রবাহ থেকেও ব্যবহার করতে পারেন৷ যদিও এটি একটি প্রক্সির মত, একটি ভাগ করা প্রবাহের কোন শেষ বিন্দু নেই। এটি শুধুমাত্র একটি API প্রক্সি বা শেয়ার্ড ফ্লো থেকে ব্যবহার করা যেতে পারে যেটি শেয়ার্ড ফ্লো হিসাবে একই সংস্থায় রয়েছে৷

একাধিক জায়গায় উপযোগী এক জায়গায় কার্যকারিতা ক্যাপচার করার মাধ্যমে, একটি ভাগ করা প্রবাহ আপনাকে ধারাবাহিকতা নিশ্চিত করতে, বিকাশের সময়কে ছোট করতে এবং আরও সহজে কোড পরিচালনা করতে সহায়তা করে৷

নিচের ভিডিওটি প্রদর্শন করে কিভাবে এজ UI-তে একটি শেয়ার্ড ফ্লো তৈরি এবং ট্রেস করতে হয়।

নিম্নলিখিত 5-মিনিটের ভিডিওটি ক্লাসিক এজ UI (শুধুমাত্র প্রাইভেট ক্লাউডের জন্য এজ) তে একটি শেয়ার্ড ফ্লো তৈরি এবং ট্রেস করতে দেখায়৷

আপনি FlowCallout নীতি ব্যবহার করে একটি শেয়ার্ড ফ্লো কল করতে পারেন৷ এছাড়াও, একটি ফ্লো হুকে একটি শেয়ার্ড ফ্লো সংযুক্ত করে, আপনি একটি প্রক্সি বা টার্গেট রিকোয়েস্টের আগে বা প্রক্সি বা টার্গেট রেসপন্সের পরে শেয়ার্ড ফ্লো এক্সিকিউট করতে পারেন৷

FlowCallout নীতির রেফারেন্সের জন্য, FlowCallout নীতি দেখুন। ফ্লো হুক সম্পর্কে আরও জানতে, ফ্লো হুক ব্যবহার করে শেয়ার্ড ফ্লো সংযুক্ত করা দেখুন।

উদাহরণস্বরূপ, কল্পনা করুন যে আপনার কার্যকারিতার ক্ষেত্র রয়েছে যা হয় একাধিক জায়গায় ব্যবহার করা হয় বা আপনার প্রতিষ্ঠানের API গুলি জুড়ে মানসম্মত হতে হবে। প্রতিটি বিভাগের জন্য আপনার একটি ভাগ করা প্রবাহ থাকতে পারে, যার মধ্যে রয়েছে:

  • নিরাপত্তা , OAuth এবং API কী যাচাইকরণ ব্যবহার করে অনুমোদন কোড সহ হুমকি সুরক্ষা কোড।
  • লগিং , স্ট্যান্ডার্ড ত্রুটি বার্তা তৈরি করার জন্য।
  • মধ্যস্থতা , XML এবং JSON বার্তা বিন্যাসের মধ্যে রূপান্তরের জন্য।

নিম্নলিখিত উদাহরণে, দুটি API প্রক্সি আগত ব্যবহারকারীর অনুরোধগুলিকে প্রমাণীকরণের জন্য একটি শেয়ার্ড ফ্লোতে (একটি ফ্লোকলআউট নীতি সহ) কল করে৷ AuthSharedFlow প্রক্সির আগে org-এ আলাদাভাবে স্থাপন করা হয়েছে যাতে এটি প্রক্সির অনুরোধ সমর্থন করার জন্য উপলব্ধ থাকে। একটি শেয়ার্ড ফ্লো বিকশিত এবং পরিচালনা করা যেতে পারে বিস্তৃত কোম্পানির নীতিগুলির জন্য দায়ী একটি দল দ্বারা, তারপরে আরও বিশেষায়িত অ্যাপ তৈরির লাইন-অফ-বিজনেস টিম দ্বারা প্রক্সিতে ব্যবহার করা যেতে পারে।

একটি ভাগ করা প্রবাহ বিকাশ

একটি শেয়ার্ড ফ্লো ডেভেলপ করার সময়, আপনাকে অবশ্যই একটি API প্রক্সিতে পাঠানো কলের মাধ্যমে এটি পরীক্ষা করতে হবে। অন্য কথায়, আপনি একটি এপিআই প্রক্সির মতো শেয়ার্ড ফ্লোতে সরাসরি অনুরোধ পাঠাতে পারবেন না। পরিবর্তে, আপনি একটি এপিআই প্রক্সিতে অনুরোধ পাঠান যা, ভাগ করে নেওয়া প্রবাহকে কল করে।

এখানে একটি ভাগ করা প্রবাহ বিকাশের জন্য উচ্চ-স্তরের পদক্ষেপ রয়েছে:

  1. বৈশিষ্ট্যগুলির ভাগ করা সেটটি কী হওয়া উচিত তা খুঁজে বের করুন৷

    উদাহরণস্বরূপ, আপনি ট্রাফিক স্পাইক দমন সহ ট্রাফিক ব্যবস্থাপনা বৈশিষ্ট্য একত্রিত করতে চাইতে পারেন। এইভাবে, আপনি লাইন-অফ-বিজনেস লজিক বাস্তবায়নকারীর কর্মপ্রবাহের বাইরে তাদের কনফিগারেশন পরিচালনা করতে পারেন।

  2. একটি API প্রক্সি তৈরি করার সময় আপনি যেমনটি করতেন ঠিক তেমনই নীতিগুলি এবং সমর্থন সংস্থানগুলি বাস্তবায়ন করে একটি ভাগ করা প্রবাহ বিকাশ করুন ৷

    একটি ভাগ করা প্রবাহ শর্তাধীন পদক্ষেপের একটি ক্রম। তাই একটি উন্নয়নশীল একটি 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>

    তারপরে, ট্রাফিক ব্যবস্থাপনার জন্য একটি ভাগ করা প্রবাহে, আপনি একটি পদক্ষেপ হিসাবে স্পাইক অ্যারেস্ট নীতি সংযুক্ত করতে পারেন। শেয়ার্ড ফ্লো কল করে এমন যেকোনো API প্রক্সির জন্য নীতিটি কার্যকর হবে।

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

    ম্যানেজমেন্ট কনসোলে কীভাবে একটি ভাগ করা প্রবাহ শুরু করা যায় সে সম্পর্কে তথ্যের জন্য, এজ UI-তে একটি ভাগ করা প্রবাহ তৈরি করা দেখুন।

    API প্রক্সিগুলির মতো, আপনি আপনার শেয়ার্ড ফ্লো সোর্স আর্টিফ্যাক্ট সমন্বিত একটি জিপ ফাইল আমদানি করতে পারেন (প্রক্সি আমদানি সম্পর্কে আরও জানতে একটি নতুন 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. প্রক্সি বা শেয়ার্ড ফ্লো মোতায়েন করার আগে পরিবেশে শেয়ার্ড ফ্লো স্থাপন করুন যা এটি গ্রাস করবে। আপনি একটি শেয়ার্ড ফ্লো স্থাপন করেন যেভাবে আপনি একটি API প্রক্সি স্থাপন করেন। (আরো জন্য, স্থাপনার ওভারভিউ দেখুন।)

    একটি শেয়ার্ড ফ্লো অবশ্যই একই org-এ হতে হবে এবং API প্রক্সি এবং অন্যান্য শেয়ার্ড ফ্লো যেগুলি এটিকে গ্রাস করে সেই পরিবেশে স্থাপন করতে হবে৷ প্রক্সির আগে শেয়ার্ড ফ্লো মোতায়েন করা হলে ডিপ্লোয় টাইমে শেয়ার্ড ফ্লোতে প্রক্সির নির্ভরতা সমাধান করা সম্ভব হয়।

    আপনি একটি ব্যবস্থাপনা API কলের সাথে একটি ভাগ করা প্রবাহ স্থাপন করতে পারেন যেমন নিম্নলিখিত:

    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

    আপনি কোনো ডাউনটাইম ছাড়াই বর্তমানে স্থাপন করা শেয়ার্ড ফ্লো প্রতিস্থাপন করতে পারেন। (এটি অনেকটা এপিআই প্রক্সির মতো। আরও জানতে ব্যবস্থাপনা API ব্যবহার করে এপিআই প্রক্সি স্থাপন দেখুন)। ব্যবস্থাপনা 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. কনজিউমিং API প্রক্সি ডেভেলপ করুন যাতে এটি শেয়ার্ড ফ্লোকে নিজের প্রবাহের অংশ হিসেবে কল করতে পারে।

    একটি API প্রক্সি থেকে, আপনি একটি FlowCallout নীতির সাথে একটি ভাগ করা প্রবাহে কল করেন৷ (এছাড়াও আপনি একটি ফ্লো হুক ব্যবহার করে শেয়ার্ড ফ্লোকে প্রক্সিতে সংযুক্ত করতে পারেন, যেমন একটি ফ্লো হুক ব্যবহার করে একটি শেয়ার্ড ফ্লো সংযুক্ত করা হয়েছে।) একটি API প্রক্সি তৈরির প্রাথমিক টিউটোরিয়ালের জন্য, আপনার প্রথম API প্রক্সি তৈরি করুন দেখুন।

    একটি শেয়ার্ড ফ্লো গ্রাস করতে, আপনি প্রক্সি বা শেয়ার্ড ফ্লোতে একটি FlowCallout নীতি যোগ করুন যা এটিকে গ্রাস করবে৷ একটি পরিষেবা কলআউট নীতির মতো, যার সাহায্যে আপনি অন্য পরিষেবাতে কল করেন, একটি ফ্লোকলআউট ভাগ করা প্রবাহকে কল করে। কনজিউমিং API প্রক্সি শেয়ার করা ফ্লো এবং শেয়ার্ড প্রবাহের মতো একই পরিবেশে স্থাপন করা আবশ্যক৷ যখন আপনি ফ্লোকলআউট নীতি ব্যবহার করে এটিতে একটি কল পরীক্ষা করতে চান তখন শেয়ার্ড ফ্লোটি থাকতে হবে।

    নিম্নলিখিত কোডে, একটি ফ্লোকলআউট নীতি 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>

    আরও তথ্যের জন্য, API প্রক্সি বা শেয়ার্ড ফ্লো থেকে শেয়ার্ড ফ্লো কল করা দেখুন

  5. শেয়ার্ড ফ্লো ব্যবহার শুরু করতে কনজিউমিং API প্রক্সি স্থাপন করুন । (সাধারণভাবে স্থাপনার বিষয়ে আরও জানতে, ডিপ্লয়মেন্ট বোঝার বিষয়টি দেখুন।)
  6. আপনি একটি API প্রক্সির সাথে যেমন ট্রেসিং করে পুনরাবৃত্তিমূলকভাবে বিকাশ করুন।

    এপিআই প্রক্সির মতো, আপনি যেভাবে চান সেইভাবে যুক্তি না পাওয়া পর্যন্ত আপনি পুনরাবৃত্তভাবে আহ্বান এবং ট্রেসিংয়ের মাধ্যমে একটি ভাগ করা প্রবাহ বিকাশ করেন। এই ক্ষেত্রে, যেহেতু শেয়ার্ড ফ্লো নিজে থেকে চলে না, আপনি একটি প্রক্সি এন্ডপয়েন্ট আনুন এবং প্রক্সিটি ট্রেস করুন৷

    এখানে পদক্ষেপগুলি রয়েছে:

    1. নিশ্চিত করুন যে শেয়ার্ড ফ্লো এবং ফ্লোকলআউট নীতির সাথে কল করা API প্রক্সি উভয়ই একই সংস্থায় এবং একই পরিবেশে স্থাপন করা হয়েছে৷
    2. API প্রক্সির ট্রেস ট্যাবে, API প্রক্সি ট্রেস করা শুরু করুন৷
    3. API প্রক্সিতে একটি প্রক্সি এন্ডপয়েন্টে একটি অনুরোধ পাঠান। এন্ডপয়েন্ট থেকে ফ্লোতে অবশ্যই FlowCallout নীতি অন্তর্ভুক্ত থাকতে হবে যা শেয়ার করা ফ্লোকে কল করে।
    4. ট্রেস ট্যাবে, API প্রক্সি থেকে শেয়ার্ড ফ্লোতে প্রবাহ পরীক্ষা করুন।

      লক্ষ্য করুন যে ট্রেসিং-এ, ভাগ করা প্রবাহকে একটি ধূসর বাক্সে আবদ্ধ পদক্ষেপ বা নীতিগুলির একটি সেট হিসাবে উপস্থাপন করা হয়। ফ্লোকলআউট নীতির প্রতিনিধিত্বকারী আইকনগুলি ভাগ করা ফ্লোগুলির আগে থাকে৷ (ট্রেসিং সম্পর্কে আরও জানতে, ট্রেস টুল ব্যবহার করা দেখুন।)

এজ UI এ একটি ভাগ করা প্রবাহ তৈরি করা হচ্ছে

যখন আপনি একটি শেয়ার্ড ফ্লো তৈরি করতে Apigee Edge UI ব্যবহার করেন, আপনি হয় স্ক্র্যাচ থেকে একটি তৈরি করতে পারেন অথবা একটি ফ্লো বান্ডেল .zip ফাইল হিসাবে বিদ্যমান ফ্লো উত্সগুলি আমদানি করে৷

  1. শেয়ার্ড ফ্লোস পৃষ্ঠা অ্যাক্সেস করুন, নীচে বর্ণিত হিসাবে। শেয়ার্ড ফ্লোস পৃষ্ঠায়, আপনি সংস্থার শেয়ার্ড ফ্লোগুলির একটি তালিকা দেখতে পারেন এবং তালিকায় প্রবাহগুলি সম্পাদনা করতে বা মুছতে পারেন৷

    প্রান্ত

    এজ UI ব্যবহার করে শেয়ার্ড ফ্লো পৃষ্ঠা অ্যাক্সেস করতে:

    1. apigee.com/edge এ সাইন ইন করুন।
    2. আপনার ভাগ করা প্রবাহ ধারণকারী সংস্থা নির্বাচন করুন। আপনার প্রতিষ্ঠানের মধ্যে পরিবর্তন দেখুন।

      শেয়ার্ড ফ্লো যেকোন এপিআই প্রক্সির জন্য উপলব্ধ হবে এবং এই সংস্থার পরিবেশে মোতায়েন করা শেয়ার্ড ফ্লো। এটি এই সংস্থার বাইরে থেকে পাওয়া যাবে না।

    3. বাম নেভিগেশন বারে বিকাশ > ভাগ করা প্রবাহ নির্বাচন করুন।

    ক্লাসিক এজ (ব্যক্তিগত ক্লাউড)

    ক্লাসিক এজ UI ব্যবহার করে শেয়ার্ড ফ্লো পৃষ্ঠা অ্যাক্সেস করতে:

    1. http:// ms-ip :9000 এ সাইন ইন করুন, যেখানে ms-ip হল ম্যানেজমেন্ট সার্ভার নোডের IP ঠিকানা বা DNS নাম।
    2. আপনার ভাগ করা প্রবাহ ধারণকারী সংস্থা নির্বাচন করুন। আপনার প্রতিষ্ঠানের মধ্যে পরিবর্তন দেখুন।

      শেয়ার্ড ফ্লো যেকোন এপিআই প্রক্সির জন্য উপলব্ধ হবে এবং এই সংস্থার পরিবেশে মোতায়েন করা শেয়ার্ড ফ্লো। এটি এই সংস্থার বাইরে থেকে পাওয়া যাবে না।

    3. শীর্ষ নেভিগেশন বারে APIs > শেয়ার্ড ফ্লো নির্বাচন করুন।
  2. একটি নতুন শেয়ার্ড ফ্লো যোগ করা শুরু করতে + শেয়ার করা ফ্লো বোতামে ক্লিক করুন।
  3. একটি শেয়ার্ড ফ্লো তৈরি করুন পৃষ্ঠায়, আপনি কীভাবে নতুন প্রবাহ তৈরি করতে চান তা চয়ন করুন:
    • স্ক্র্যাচ থেকে একটি নতুন প্রবাহ তৈরি করুন. আপনি প্রবাহের ধাপ হিসাবে নীতি এবং সংস্থানগুলি কনফিগার করতে সক্ষম হবেন৷
      1. খালি শেয়ার্ড ফ্লো নির্বাচন করুন।
      2. একটি নামের মান লিখুন। এটি সেই নাম হবে যা API প্রক্সি এবং অন্যান্য শেয়ার্ড ফ্লো এই শেয়ার্ড ফ্লোকে রেফারেন্স করতে ব্যবহার করে৷ নামটি ডেভেলপারদের কাছে বর্ণনামূলক হওয়া উচিত যারা ফ্লো ব্যবহার করছেন।
      3. প্রবাহটি কী করে সে সম্পর্কে আরও তথ্য প্রদান করতে একটি বিবরণ লিখুন।
      4. পরবর্তী ক্লিক করুন.
      5. ঐচ্ছিকভাবে, আপনি যে পরিবেশে নতুন প্রবাহ স্থাপন করতে চান তা নির্বাচন করুন।

        উদাহরণস্বরূপ, যদি আপনি পরীক্ষার পরিবেশে স্থাপন করা API প্রক্সিগুলি থেকে ভাগ করা প্রবাহটি পরীক্ষা করে থাকেন, তাহলে ভাগ করা প্রবাহটিকে পরীক্ষায় স্থাপন করুন।

      6. আপনার নির্বাচিত পরিবেশে নতুন শেয়ার্ড ফ্লো তৈরি এবং স্থাপন করতে বিল্ড এবং ডিপ্লোয় ক্লিক করুন। যদি আপনি কোনো পরিবেশ নির্বাচন না করেন, ভাগ করা প্রবাহ তৈরি হবে, কিন্তু স্থাপন করা হবে না।

    • একটি ফ্লো বান্ডেল আপলোড করে বিদ্যমান উত্স থেকে একটি ভাগ করা প্রবাহ তৈরি করুন৷
      1. শেয়ার্ড ফ্লো বান্ডেল নির্বাচন করুন একটি .zip ফাইল যাতে আপনি নতুন ফ্লোতে চান সেই শিল্পকর্মগুলিকে নির্দিষ্ট করতে।

        একটি শেয়ার্ড ফ্লো বান্ডেলে একটি শেয়ার্ড ফ্লো এর উৎস আর্টিফ্যাক্ট থাকে। উদাহরণস্বরূপ, যদি আপনি এজ UI থেকে একটি শেয়ার্ড ফ্লো ডাউনলোড করতে চান, তাহলে আপনার কাছে ফ্লো বান্ডেল সহ একটি .zip ফাইল থাকবে৷

      2. পরবর্তী ক্লিক করুন.
      3. আপনি আমদানি করতে চান এমন শেয়ার্ড ফ্লো সোর্স ধারণকারী .zip ফাইলটি ব্রাউজ করতে ফাইল চয়ন করুন ক্লিক করুন৷
      4. শেয়ার্ড ফ্লো নেম বক্সে, আমদানি করা প্রবাহের জন্য একটি নাম লিখুন। এটি সেই নাম হবে যা API প্রক্সি এবং অন্যান্য শেয়ার্ড ফ্লো এই শেয়ার্ড ফ্লোকে রেফারেন্স করতে ব্যবহার করে৷ নামটি ডেভেলপারদের কাছে বর্ণনামূলক হওয়া উচিত যারা ফ্লো ব্যবহার করছেন।
      5. পরবর্তী ক্লিক করুন.
      6. আপনি যে উত্সগুলি আমদানি করছেন তা থেকে নতুন প্রবাহ তৈরি করতে বিল্ড এ ক্লিক করুন৷

একটি API প্রক্সি বা শেয়ার্ড ফ্লো থেকে শেয়ার্ড ফ্লো কল করা

আপনি FlowCallout নীতি ব্যবহার করে একটি প্রক্সি থেকে অথবা অন্য একটি শেয়ার্ড ফ্লো থেকে একটি শেয়ার্ড ফ্লো কল করতে পারেন৷

  1. এজ UI-তে, প্রক্সি বা শেয়ার্ড ফ্লো সনাক্ত করুন যেখান থেকে আপনি অন্য শেয়ার্ড ফ্লো কল করতে চান।
  2. নেভিগেটরে , নীতিগুলির পাশে, + বোতামে ক্লিক করুন।
  3. নীতির তালিকায়, এক্সটেনশনের অধীনে, FlowCallout-এ ক্লিক করুন।
  4. প্রদর্শনের নাম এবং নাম (অনন্য শনাক্তকারী) লিখুন, তারপরে এই নীতিতে কল করা শেয়ার্ড ফ্লো নির্বাচন করুন।
  5. যোগ করুন ক্লিক করুন.
  6. আপনি যে প্রক্সিতে কল করতে চান সেখানে নতুন FlowCallout নীতি যোগ করুন।

এছাড়াও দেখুন

API প্রক্সি একসাথে চেইন করা