আপনি Apigee Edge-এর ডকুমেন্টেশন দেখছেন।
Apigee X ডকুমেন্টেশন .info- তে যান।
পূর্বশর্ত
আপনার http: //enterprise.apigee.com- এ একটি অ্যাকাউন্ট লাগবে। আপনি http://accounts.apigee.com/accounts/sign_up- এ গিয়ে একটি ট্রায়াল অ্যাকাউন্টের জন্য সাইন আপ করতে পারেন।
নমুনা ব্যবহার করার জন্য আপনার নিম্নলিখিত জিনিসগুলোও থাকা উচিত:
| সরঞ্জাম | বর্ণনা |
|---|---|
| গিট | স্যাম্পলগুলো গিটহাবে রয়েছে। আপনার যদি গিট ইনস্টল করা না থাকে, তবে অনুগ্রহ করে গিটহাবের গিট সেটআপ নির্দেশাবলী দেখুন। আপনি যদি গিট ইনস্টল করতে না চান, তবে https://github.com/apigee/api-platform-samples থেকে ফাইলগুলো ব্রাউজ করে একটি জিপ (ZIP) ডাউনলোড করতে পারেন। |
| পাইথন | Apigee deploy টুলটি চালানোর জন্য পাইথন প্রয়োজন। বেশিরভাগ লিনাক্স পরিবেশে, XCode ইনস্টল করা ম্যাকে, Cygwin ইনস্টল করা উইন্ডোজ মেশিনে এবং আরও অনেক জায়গায় পাইথন পাওয়া যায়। পাইথন পেতে, অনুগ্রহ করে পাইথন ডাউনলোড পৃষ্ঠাটি দেখুন। |
curl | নমুনা সেটআপ স্ক্রিপ্টগুলোতেও curl ব্যবহার করা হয়েছে। নিশ্চিত করুন যে curl ইনস্টল করা আছে এবং আপনার পাথে (path) উপলব্ধ আছে (আপনার সিস্টেমে এটি আছে কিনা তা দেখতে which curl কমান্ডটি চালান)। |
dos2unix | আপনি যদি উইন্ডোজে সাইগউইন (Cygwin) চালান, তাহলে আপনার dos2unix ইউটিলিটিটিরও প্রয়োজন হতে পারে। (সাইগউইন ইনস্টলার আপনাকে ইউটিলিটিটি ইনস্টল করার সুযোগ দেয়।) |
নমুনাগুলো ডাউনলোড করুন
নমুনা ফাইলগুলো পেতে, নিচের উদাহরণে দেখানো অনুযায়ী git clone ব্যবহার করুন:
git clone https://github.com/apigee/api-platform-samples.git
নমুনা এপিআই প্রক্সিগুলি আমদানি এবং স্থাপন করুন
কমান্ড লাইন থেকে স্যাম্পলগুলো ইম্পোর্ট এবং ডিপ্লয় করুন:
- স্যাম্পলগুলো ডাউনলোড করার পর,
/setupডিরেক্টরিতে যান, যেমনটি নিচের উদাহরণে দেখানো হয়েছে:cd setup
/setupডিরেক্টরিতেsetenv.shফাইলটি খুঁজুন।- আপনার প্রতিষ্ঠান, আপনার ইউজারনেমের সাথে যুক্ত ইমেল ঠিকানা এবং যে পরিবেশে (প্রোডাকশন বা টেস্ট) আপনি এপিআই প্রক্সিগুলো স্থাপন করতে চান, তা সেট করার জন্য এই ফাইলটি সম্পাদনা করুন।
-
setenv.shসম্পাদনা করার পর, নিম্নলিখিতটি চালান:sh deploy_all.sh
এই স্ক্রিপ্টটি আপনার প্রতিষ্ঠানে সমস্ত এপিআই প্রক্সি স্যাম্পল ডেপ্লয় করে। (এই প্রক্রিয়ায় ৩-৪ মিনিট সময় লাগে।) এপিআই প্রোডাক্ট, ডেভেলপার এবং অ্যাপ (যা OAuth-এর জন্য ব্যবহৃত হয়) ডেপ্লয় করতে নির্দেশাবলী অনুসরণ করুন।
- ডিপ্লয় স্ক্রিপ্টটি সম্পন্ন হওয়ার পর, sample-proxies ডিরেক্টরিতে যান।
sample-proxiesডিরেক্টরির ভেতরে আপনি প্রতিটি স্যাম্পল প্রক্সির জন্য একটি করে ডিরেক্টরি পাবেন। প্রতিটি ডিরেক্টরিতে একটি README.md ফাইল রয়েছে, যেখানে স্যাম্পলটি চালানোর বিষয়ে তথ্য দেওয়া আছে। এছাড়াও দুটি স্ক্রিপ্ট রয়েছে যা আপনাকে স্যাম্পলগুলোতে ছোটখাটো পরিবর্তন করতে, ডিপ্লয় করতে এবং তারপর আপনার পরিবর্তনের প্রভাব দেখতে স্যাম্পলটি চালু করতে সাহায্য করবে।-
invoke.sh: এপিআই প্রক্সির ডেপ্লয় করা সংস্করণটি চালু করতে এই স্ক্রিপ্টটি চালান। -
deploy.sh: যেকোনো পরিবর্তন করার পর এপিআই প্রক্সি স্থাপন করতে এই স্ক্রিপ্টটি চালান।
-
নমুনা এপিআই প্রক্সিগুলি আহ্বান করুন
প্রতিটি নমুনা প্রক্সির সাথে একটি শেল স্ক্রিপ্ট যুক্ত থাকে, যা এপিআই প্রক্সিটি স্থাপন করার পর সেটিকে চালু করতে ব্যবহার করা যেতে পারে।
/sample-proxies/ proxy_name ডিরেক্টরি থেকে, নিম্নলিখিতটি চালান:
sh invoke.sh
এটি আপনার প্রতিষ্ঠানের টেস্ট এনভায়রনমেন্টে চলমান প্রক্সিটিকে চালু করে।
সমস্যা সমাধান
সমস্যা সমাধানের তথ্যের জন্য, নিম্নলিখিতগুলি দেখুন:
নমুনা এপিআই প্রক্সিগুলি পরিবর্তন ও পুনরায় ব্যবহার করুন
স্যাম্পল প্রক্সিগুলোর সাধারণ ব্যবহার হলো পরিবর্তন করা, স্থাপন করা এবং আহ্বান করা। এর মাধ্যমে আপনি ছোটখাটো পরিবর্তন করতে পারেন এবং তারপর দেখতে পারেন যে প্রতিক্রিয়া বার্তার উপর সেগুলোর কী প্রভাব পড়ছে।
একটি নমুনা এপিআই প্রক্সিকে অন্য কোনো ব্যাকএন্ড সার্ভিসের দিকে নির্দেশ করার জন্য, নিম্নলিখিত স্থানে থাকা এক্সএমএল কনফিগারেশন ফাইলটি পরিবর্তন করুন:
/apiproxy/targets/target_name.xmlউদাহরণস্বরূপ, আপনার নিজের ব্যাকএন্ড সার্ভিসে এপিআই কী নমুনাটি নির্দেশ করতে, এই ফাইলটি খুঁজুন:
/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>
আপনার পরিবর্তনগুলি সংরক্ষণ করার পরে, নিম্নলিখিত উদাহরণে দেখানো অনুযায়ী এপিআই প্রক্সিটি স্থাপন করুন:
sh deploy.sh
আপনার বিদ্যমান টার্গেট সার্ভিসগুলোর বিরুদ্ধে এপিআই প্রক্সি কার্যকারিতা ব্যবহার করার জন্য অন্যান্য এপিআই প্রক্সিগুলোকেও একইভাবে পরিবর্তন করা যেতে পারে। তবে, কিছু ক্ষেত্রে এপিআই প্রক্সির আচরণ নির্দিষ্ট মেসেজ ফরম্যাটের উপর নির্ভরশীল, তাই প্রক্সিগুলোতে অতিরিক্ত কনফিগারেশন পরিবর্তনের প্রয়োজন হতে পারে।