Edge কীভাবে কনফিগার করতে হয়

Edge for Private Cloud v4.18.05

ইনস্টলেশনের পরে Edge কনফিগার করতে, আপনি .properties ফাইল এবং Edge ইউটিলিটির একটি কম্বিনেশন ব্যবহার করেন। যেমন, Edge UI-তে TLS/SSL কনফিগার করতে, প্রয়োজনীয় প্রপার্টি সেট করতে আপনি .properties ফাইল এডিট করেন। .propertiesটি ফাইলে পরিবর্তন করার জন্য আপনাকে প্রভাবিত Edge কম্পোনেন্ট রিস্টার্ট করতে হবে।

Apigee বলতে .properties ফাইলকে কনফিগারেশন সহ কোড হিসেবে এডিট করার টেকনিককে বোঝায়। মূলত, কনফিগারেশন সহ কোড হল .properties ফাইলের সেটিংসের উপর ভিত্তি করে একটি কী/ভ্যালু লুকআপ টুল। কনফিগারেশন সহ কোডে, কীগুলিকে টোকেন হিসেবে উল্লেখ করা হয়। তাই, Edge কনফিগার করতে, আপনি .properties ফাইলে টোকেন সেট করেন।

কনফিগারেশন সহ কোড এজ কম্পোনেন্টকে প্রোডাক্টের সাথে পাঠানো ডিফল্ট ভ্যালু সেট করতে দেয়, ইনস্টলেশন টিমকে ইনস্টলেশন টপোলজির উপর ভিত্তি করে সেই সেটিংস ওভাররাইড করতে দেয়, এবং তারপর গ্রাহকদের তাদের বেছে নেওয়া যেকোনও প্রপার্টি ওভাররাইড করতে দেয়।

আপনি যদি এটিকে একটি হায়ারার্কি হিসাবে ভাবেন, তাহলে সেটিংসগুলি নিম্নরূপ সাজানো হয়েছে যেখানে গ্রাহকের সেটিংসের সর্বোচ্চ অগ্রাধিকার রয়েছে যা ইনস্টলার টিম বা Apigee-এর যেকোনো সেটিংসকে ওভাররাইড করে:

1. গ্রাহক
2. ইনস্টলার
3. Apigee

.properties ফাইল কীভাবে ব্যবহার করবেন

গ্রাহক হিসেবে, আপনি শুধুমাত্র /opt/apigee/customer/application ডিরেক্টরিতে .properties ফাইলগুলি পরিবর্তন করতে পারবেন। প্রতিটি কম্পোনেন্টের নিজস্ব .properties ফাইল সেই ডিরেক্টরিতে আছে। যেমন, router.properties এবং management-server.properties।

যেমন, .properties ফাইল তৈরি করতে:

1. যেকোনও ব্যবহারকারী হিসেবে এডিটরে ফাইল তৈরি করুন।
2. ফাইলের মালিককে "apigee:apigee"-তে পরিবর্তন করতে chown ব্যবহার করুন অথবা আপনি যদি "apigee" ব্যবহারকারী থেকে Edge পরিষেবা চালানো ব্যবহারকারীকে পরিবর্তন করে থাকেন, তাহলে Edge পরিষেবা চালানো ব্যবহারকারীর নামে ফাইলটি chown করুন।

কোনও কম্পোনেন্টের জন্য প্রপার্টি সেট করতে, টোকেন সেট করার জন্য সংশ্লিষ্ট .properties ফাইল এডিট করুন এবং তারপর কম্পোনেন্ট রিস্টার্ট করুন:

/opt/apigee/apigee-service/bin/apigee-service component restart

যেমন, router.properties এডিট করার পরে, রাউটার রিস্টার্ট করুন:

/opt/apigee/apigee-service/bin/apigee-service edge-router restart

আপনি Edge আপগ্রেড করলে, /opt/apigee/customer/application ডিরেক্টরিতে .properties ফাইলগুলি পড়া হয়। এর অর্থ হল, আপগ্রেড করার পরেও কম্পোনেন্টে আপনার সেট করা প্রপার্টি বজায় থাকবে।

.properties ফাইলের লোকেশন

Edge কম্পোনেন্টের জন্য .properties ফাইলের তিনটি টপ-লেভেল ডিরেক্টরি আছে: ইনস্টলেশন, মালিক ও গ্রাহক। ডিফল্ট লোকেশন নিম্নলিখিত টেবিলে দেখানো হয়েছে:

/opt/apigee/component_name/conf

/opt/apigee/token

/opt/apigee/customer

টোকেনের বর্তমান ভ্যালু নির্ধারণ করুন

কম্পোনেন্টের জন্য .properties ফাইলে টোকেন সেট করার আগে, আপনি নিম্নলিখিত কমান্ড ব্যবহার করে প্রথমে এটির বর্তমান মান নির্ধারণ করতে পারেন:

/opt/apigee/apigee-service/bin/apigee-service component_name configure -search token

যেখানে component_name হল কম্পোনেন্টের নাম এবং token হল ইন্সপেক্ট করার টোকেন।

এই কমান্ড .properties ফাইলের হায়ারার্কি সার্চ করে টোকেনের বর্তমান ভ্যালু নির্ধারণ করে।

যেমন, রাউটারের জন্য conf_http_HTTPRequest.line.limit টোকেনের বর্তমান ভ্যালু চেক করতে:

/opt/apigee/apigee-service/bin/apigee-service edge-router configure -search conf_http_HTTPRequest.line.limit

আপনি এই ফর্ম্যাটে আউটপুট দেখতে পাবেন:

Found key conf_http_HTTPRequest.line.limit, with value, 4k, in /opt/apigee/edge-router/token/default.properties

.properties ফাইলে টোকেন সেট করুন

কোনও টোকেনের ভ্যালু ওভাররাইড করতে:

1. টোকেন ভ্যালু সেট করার জন্য কম্পোনেন্টের .properties ফাইল এডিট করুন। ফাইলটি না থাকলে, এটি তৈরি করুন।
2. কম্পোনেন্ট রিস্টার্ট করুন।
3. টোকেন ভ্যালু চেক করুন।

যেমন, এজ রাউটারের জন্য অনুরোধের লাইন সীমা সেট করতে:

1. conf_http_HTTPRequest.line.limit টোকেন সেট করতে /opt/apigee/customer/application/router.properties ফাইল এডিট করুন:

   conf_http_HTTPRequest.line.limit=8k

2. এজ রাউটার রিস্টার্ট করুন:

   /opt/apigee/apigee-service/bin/apigee-service edge-router restart

3. টোকেনের ভ্যালু চেক করুন:

   /opt/apigee/apigee-service/bin/apigee-service edge-router configure -search conf_http_HTTPRequest.line.limit

একাধিক ভ্যালু নেয় এমন টোকেন সেট করুন

কিছু টোকেন কমা দিয়ে আলাদা করা ভ্যালুর তালিকা নেয়। যেমন, conf_security_rbac.restricted.resources টোকেন URI-এর একটি তালিকা নেয় যা সীমাবদ্ধ করা থাকে যাতে শুধুমাত্র sysadmin সেগুলিকে কল করতে পারে। conf_security_rbac.restricted.resources-এর ভ্যালু দেখতে:

cd /opt/apigee/edge-management-server
grep -ri "conf_security_rbac.restricted.resources" *

আউটপুটে নিম্নলিখিত তথ্য থাকে:

token/default.properties:conf_security_rbac.restricted.resources=/environments,/environments/*,/environments/*/virtualhosts,/environments/*/virtualhosts/*,/pods,/environments/*/servers,/rebuildindex,/users/*/status

ভ্যালুর তালিকা নেয় এমন টোকেন সেট করতে, .properties ফাইলে টোকেনের বর্তমান ভ্যালুর সাথে যেকোনও নতুন ভ্যালু যোগ করুন। তাই, conf_security_rbac.restricted.resources-এ URI /myuri/* যোগ করতে, নিচে দেখানো পদ্ধতি অনুযায়ী /opt/apigee/customer/application/management-server.properties ফাইল এডিট করুন:

conf_security_rbac.restricted.resources=/environments,/environments/*,/environments/*/virtualhosts,/environments/*/virtualhosts/*,/pods,/environments/*/servers,/rebuildindex,/users/*/status,/myuri/*

টোকেন খুঁজে বের করা

বেশিরভাগ ক্ষেত্রে, আপনাকে যেসব টোকেন সেট করতে হবে সেগুলি এই নির্দেশিকায় শনাক্ত করা হয়েছে। তবে, কোনও প্রপার্টি ওভাররাইড করার জন্য ব্যবহৃত টোকেন নির্ধারণ করতে হলে, কম্পোনেন্টের source ফোল্ডারে grep করুন।

যেমন, আপনি যদি জানেন যে Edge-এর আগের রিলিজে আপনি session.maxAge প্রপার্টি সেট করেছেন এবং এটি সেট করার জন্য ব্যবহৃত টোকেন ভ্যালু জানতে চান, তাহলে /opt/apigee/edge-ui/source ডিরেক্টরিতে প্রপার্টির জন্য grep:

grep -ri "session.maxAge" /opt/apigee/edge-ui/source

আপনি এই ফর্ম্যাটে ফলাফল দেখতে পাবেন:

/opt/apigee/edge-ui/source/conf/application.conf:session.maxAge={T}conf_application_session.maxage{/T}

{T}{/T} ট্যাগের মধ্যে থাকা স্ট্রিং হল সেই টোকেন যা আপনি .properties ফাইলে সেট করেছেন।

বর্তমানে কমেন্ট হিসেবে চিহ্নিত করা আছে এমন টোকেন সেট করুন

Edge কনফিগারেশন ফাইলে কিছু টোকেন কমেন্ট হিসেবে চিহ্নিত করা আছে। আপনি যদি এমন কোনও টোকেন সেট করার চেষ্টা করেন যা কমেন্ট হিসেবে চিহ্নিত করা হয়েছে, তাহলে সেটিংটি উপেক্ষা করা হবে।

কমেন্ট হিসেবে চিহ্নিত করা টোকেন সেট করতে, আপনি এই ফর্ম্যাটে একটি বিশেষ সিনট্যাক্স ব্যবহার করেন:

conf/file.extension+propertyName=propertyValue

যেমন, আপনি মেসেজ প্রসেসরে HTTPClient.proxy.host নামের প্রপার্টি সেট করতে চান। তারপর আপনি প্রপার্টির টোকেন নির্ধারণ করতে grep:

cd /opt/apigee/edge-message-processor
grep -ri "HTTPClient.proxy.host" *

grep কমান্ড টোকেন ভ্যালু সহ ফর্মে ফলাফল দেখায়। লক্ষ্য করুন কীভাবে প্রপার্টির নাম কমেন্ট হিসেবে চিহ্নিত করা হয়েছে, যেমন প্রপার্টির নামের আগে # প্রিফিক্স দিয়ে দেখানো হয়েছে:

source/conf/http.properties:#HTTPClient.proxy.host={T}conf_http_HTTPClient.proxy.host{/T}
token/default.properties:conf_http_HTTPClient.proxy.host=
conf/http.properties:#HTTPClient.proxy.host=

প্রপার্টি সেট করতে, /opt/apigee/customer/application/message-processor.properties এডিট করুন যাতে প্রপার্টি এইভাবে সেট করা যায়:

conf/http.properties+HTTPClient.proxy.host=myhost.name.com

লক্ষ্য করুন যে কীভাবে প্রপার্টির নামের আগে conf/http.properties+, লোকেশন এবং কনফিগারেশন ফাইলের নাম থাকে, যার মধ্যে প্রপার্টি থাকে এবং তারপরে "+" থাকে।

মেসেজ প্রসেসর রিস্টার্ট করার পরে, ফাইলটি পরীক্ষা করুন /opt/apigee/edge-message-processor/conf/http.properties:

cat /opt/apigee/edge-message-processor/conf/http.properties

ফাইলের শেষে, আপনি প্রপার্টি সেট দেখতে পাবেন, এই ফর্ম্যাটে:

conf/http.properties:HTTPClient.proxy.host=myhost.name.com