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

Edge for Private Cloud v. 4.16.05

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

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

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

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

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

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

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

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

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

> /<inst_root>/apigee/apigee-service/bin/apigee-service component restart

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

> /<inst_root>/apigee/apigee-service/bin/apigee-service edge-router restart

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

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

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

সতর্কতা: Edge গ্রাহকরা শুধুমাত্র .properties ফাইলগুলি /<inst_root>/apigee/customer-এর অধীনে পরিবর্তন করতে পারবেন। আপনি কম্পোনেন্ট ও ইনস্টলেশন ডিরেক্টরির অধীনে ফাইল দেখতে পেলেও, কোনও ফাইল পরিবর্তন করবেন না।

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

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

> /<inst_dir>/apigee/apigee-service/bin/apigee-service comp configure -search token

যেখানে comp হল কম্পোনেন্টের নাম এবং token হল টোকেন যা পরীক্ষা করতে হবে।

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

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

> /<inst_dir>/apigee/apigee-service/bin/apigee-service edge-router configure -search conf_router_HTTP.request.line.limit

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

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

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

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

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

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

1. conf_router_HTTP.request.line.limit টোকেন সেট করতে /<inst_root>/apigee/customer/application/router.properties ফাইল এডিট করুন:
   
   conf_router_HTTP.request.line.limit=8k
2. এজ রাউটার রিস্টার্ট করুন:
   
   > /<inst_root>/apigee/apigee-service/bin/apigee-service edge-router restart
3. টোকেনের ভ্যালু চেক করুন:
   
   > /<inst_dir>/apigee/apigee-service/bin/apigee-service edge-router configure -search conf_router_HTTP.request.line.limit

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

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

> cd /<inst_root>/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/* যোগ করতে, /<inst_root>/apigee/customer/application/management-server.properties ফাইলটি নিচে দেখানো পদ্ধতিতে এডিট করুন:

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

টোকেন লোকেট করা হচ্ছে

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

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

> grep -ri "session.maxAge" /<inst_root>/apigee/edge-ui/source

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

/<inst_root>/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=yhost.name.com