নমুনা API প্রক্সি ব্যবহার করে

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

পূর্বশর্ত

আপনার http://enterprise.apigee.com- এ একটি অ্যাকাউন্টের প্রয়োজন হবে। আপনি http://accounts.apigee.com/accounts/sign_up- এ একটি ট্রায়াল অ্যাকাউন্টের জন্য সাইন আপ করতে পারেন।

নমুনাগুলি ব্যবহার করতে, আপনার নিম্নলিখিতগুলিও থাকা উচিত:

টুল বর্ণনা
গিট নমুনাগুলি গিটহাবে অবস্থিত। আপনার যদি গিট ইনস্টল না থাকে তবে অনুগ্রহ করে গিটহাবের গিট সেটআপ নির্দেশাবলী পড়ুন। আপনি যদি গিট ইনস্টল করতে না চান তবে আপনি ফাইলগুলি ব্রাউজ করতে পারেন এবং https://github.com/apigee/api-platform-samples থেকে একটি জিপ ডাউনলোড করতে পারেন।
পাইথন

Apigee ডিপ্লয় টুল চালানোর জন্য Python প্রয়োজন। পাইথন বেশিরভাগ লিনাক্স পরিবেশে, এক্সকোড ইনস্টল করা ম্যাকে, সাইগউইন ইনস্টল করা উইন্ডোজ মেশিনে এবং অন্যান্য অনেক জায়গায় উপস্থিত রয়েছে।

পাইথন পেতে, অনুগ্রহ করে পাইথন ডাউনলোড পৃষ্ঠা দেখুন।

curl নমুনা সেটআপ স্ক্রিপ্টগুলিও curl ব্যবহার করে। নিশ্চিত করুন যে curl ইনস্টল করা আছে এবং আপনার পাথে উপলব্ধ রয়েছে (আপনার সিস্টেমে এটি উপলব্ধ কিনা তা দেখতে which curl কমান্ডটি চালান)।
dos2unix আপনি যদি Windows এ Cygwin চালাচ্ছেন, তাহলে আপনার dos2unix ইউটিলিটিও প্রয়োজন হতে পারে। (সাইগউইন ইনস্টলার আপনাকে ইউটিলিটি ইনস্টল করতে দেয়।)

নমুনা ডাউনলোড করুন

নমুনা ফাইলগুলি পেতে, git clone ব্যবহার করুন যেমন নিম্নলিখিত উদাহরণটি দেখায়:

git clone https://github.com/apigee/api-platform-samples.git

নমুনা API প্রক্সিগুলি আমদানি এবং স্থাপন করুন

কমান্ড লাইন থেকে নমুনাগুলি আমদানি এবং স্থাপন করুন:

  1. আপনি নমুনাগুলি ডাউনলোড করার পরে, /setup ডিরেক্টরিতে যান, নিম্নলিখিত উদাহরণটি দেখায়:
    cd setup
  2. /setup ডিরেক্টরিতে, setenv.sh ফাইলটি সনাক্ত করুন।
  3. আপনার সংস্থা, আপনার ব্যবহারকারীর নামের সাথে যুক্ত ইমেল ঠিকানা এবং পরিবেশ (প্রোড বা পরীক্ষা) সেট করতে এই ফাইলটি সম্পাদনা করুন যেখানে আপনি API প্রক্সিগুলি স্থাপন করতে চান৷
  4. আপনি setenv.sh সম্পাদনা করার পরে, নিম্নলিখিতটি চালান:
    sh deploy_all.sh

    এই স্ক্রিপ্টটি আপনার প্রতিষ্ঠানে সমস্ত API প্রক্সি নমুনা স্থাপন করে। (প্রক্রিয়াটি 3-4 মিনিট সময় নেয়।) API পণ্য, বিকাশকারী এবং অ্যাপস (যা OAuth-এর জন্য ব্যবহৃত হয়) স্থাপন করতে প্রম্পট অনুসরণ করুন।

  5. ডিপ্লোয় স্ক্রিপ্ট সম্পূর্ণ হওয়ার পরে, নমুনা-প্রক্সি ডিরেক্টরিতে নেভিগেট করুন। sample-proxies ডিরেক্টরিতে, আপনি প্রতি নমুনা প্রক্সিতে একটি ডিরেক্টরি পাবেন। প্রতিটি ডিরেক্টরিতে নমুনা চালানোর তথ্য সহ একটি README.md ফাইল রয়েছে, এবং দুটি স্ক্রিপ্ট যা আপনাকে সাহায্য করে যখন আপনি নমুনাগুলিতে ছোট পরিবর্তন করেন, স্থাপন করেন এবং তারপরে আপনি পরিবর্তন করলে কী প্রভাব পড়েছিল তা দেখতে নমুনাটি আহ্বান করুন:
    • invoke.sh : এপিআই প্রক্সির নিয়োজিত সংস্করণটি চালু করতে এই স্ক্রিপ্টটি চালান।
    • deploy.sh : আপনি কোনো পরিবর্তন করার পরে API প্রক্সি স্থাপন করতে এই স্ক্রিপ্টটি চালান।

নমুনা API প্রক্সি আহ্বান করুন

প্রতিটি নমুনা প্রক্সিতে একটি সংশ্লিষ্ট শেল স্ক্রিপ্ট থাকে যা আপনি এটি স্থাপন করার পরে API প্রক্সি চালু করতে ব্যবহার করা যেতে পারে।

/sample-proxies/ proxy_name ডিরেক্টরি থেকে, নিম্নলিখিতগুলি চালান:

sh invoke.sh

এটি আপনার প্রতিষ্ঠানের পরীক্ষার পরিবেশে চলমান প্রক্সিকে আহ্বান করে।

সমস্যা সমাধান

সমস্যা সমাধানের তথ্যের জন্য, নিম্নলিখিতগুলি দেখুন:

নমুনা API প্রক্সিগুলি সংশোধন এবং পুনরায় ব্যবহার করুন

নমুনা প্রক্সিগুলির সাধারণ ব্যবহার হল সংশোধন করা, স্থাপন করা এবং আহ্বান করা। এটি আপনাকে ছোট পরিবর্তন করতে সক্ষম করে, এবং তারপরে প্রতিক্রিয়া বার্তায় তাদের কী প্রভাব রয়েছে তা দেখতে।

একটি ভিন্ন ব্যাকএন্ড পরিষেবার দিকে নির্দেশ করার জন্য একটি নমুনা API প্রক্সি পরিবর্তন করতে, নিম্নলিখিত অবস্থানে XML কনফিগারেশন ফাইলটি পরিবর্তন করুন:

/apiproxy/targets/target_name.xml

উদাহরণস্বরূপ, আপনার নিজস্ব ব্যাকএন্ড পরিষেবাতে API কী নমুনা নির্দেশ করতে, এই ফাইলটি সনাক্ত করুন:

/apikey/apiproxy/targets/default.xml

যদি ডিফল্ট কনফিগারেশন http://mocktarget.apigee.net এর দিকে নির্দেশ করে, যেমন:

<TargetEndpoint name="default">
  <HTTPTargetConnection>
    <!-- This is where we define the target. For this sample we just use a simple URL. -->
    <URL>http://mocktarget.apigee.net</URL>
  </HTTPTargetConnection>
</TargetEndpoint>

এবং আপনার ব্যাকএন্ড পরিষেবা http://api.myproject.com/ এ উপলব্ধ, তারপর আপনি নিম্নলিখিত মত দেখতে কনফিগারেশন পরিবর্তন করুন:

<TargetEndpoint name="default">
  <HTTPTargetConnection>
    <!-- This is where we define the target. For this sample we just use a simple URL. -->
    <URL>http://api.myproject.com/</URL>
  </HTTPTargetConnection>
</TargetEndpoint>

আপনি আপনার পরিবর্তনগুলি সংরক্ষণ করার পরে, নিম্নলিখিত উদাহরণটি দেখায় হিসাবে API প্রক্সি স্থাপন করুন:

sh deploy.sh

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