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

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

পূর্বশর্ত

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

Samples ব্যবহার করতে, আপনার এগুলিও থাকতে হবে:

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

Apigee ডিপ্লয় টুল চালানোর জন্য Python প্রয়োজন। Python বেশিরভাগ Linux এনভায়রনমেন্টে, XCode ইনস্টল করা Mac-এ, Cygwin ইনস্টল করা Windows মেশিনে এবং আরও অনেক জায়গায় থাকে।

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

স্যাম্পেল ডাউনলোড করুন

স্যাম্পেল ফাইল পেতে, 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 প্রক্সি স্যাম্পেল ডেপ্লয় করে। (এই প্রসেসটি সম্পূর্ণ হতে ৩-৪ মিনিট সময় লাগে।) API প্রোডাক্ট, ডেভেলপার ও অ্যাপ (যা OAuth-এর জন্য ব্যবহার করা হয়) ডেপ্লয় করতে প্রম্পট অনুসরণ করুন।

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

স্যাম্পেল API প্রক্সি ইনভোক করা

প্রতিটি স্যাম্পেল প্রক্সির সাথে একটি সংশ্লিষ্ট শেল স্ক্রিপ্ট থাকে যা আপনি ডিপ্লয় করার পরে API প্রক্সি ইনভোক করতে ব্যবহার করা যেতে পারে।

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

sh invoke.sh

এটি আপনার সংস্থার টেস্ট এনভায়রনমেন্টে চলছে এমন প্রক্সি চালু করে।

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

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

Sample 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 প্রক্সি আচরণ নির্দিষ্ট মেসেজ ফর্ম্যাটের উপর নির্ভর করে, তাই প্রক্সিতে অতিরিক্ত কনফিগারেশন পরিবর্তন করতে হতে পারে।