প্রাইভেট ক্লাউডের জন্য Edge v. 4.17.09
ইনস্টলেশনের পরে Edge কনফিগার করতে, আপনি .properties ফাইল এবং Edge ইউটিলিটি ব্যবহার করেন। যেমন, Edge UI-তে TLS/SSL কনফিগার করতে, প্রয়োজনীয় প্রপার্টি সেট করতে আপনি .properties ফাইল এডিট করেন। .properties ফাইলে পরিবর্তন করলে, প্রভাবিত Edge কম্পোনেন্ট রিস্টার্ট করতে হবে।
Apigee, .properties ফাইল এডিট করার টেকনিককে কোড উইথ কনফিগারেশন হিসেবে উল্লেখ করে। মূলত, কনফিগারেশন সহ কোড হল একটি কী/ভ্যালু লুক-আপ টুল যা .properties ফাইলের সেটিংসের উপর ভিত্তি করে কাজ করে। code with config-এ, কীগুলিকে টোকেন হিসেবে উল্লেখ করা হয়। তাই, Edge কনফিগার করতে, আপনাকে .properties ফাইলে টোকেন সেট করতে হবে।
কনফিগারেশন সহ কোড, Edge কম্পোনেন্টকে ডিফল্ট ভ্যালু সেট করতে দেয় যা প্রোডাক্টের সাথে শিপ করা হয়, ইনস্টলেশন টিমকে ইনস্টলেশন টপোলজি অনুযায়ী সেইসব সেটিংস ওভাররাইড করতে দেয়, এবং তারপর গ্রাহকদের তাদের বেছে নেওয়া যেকোনও প্রপার্টি ওভাররাইড করতে দেয়।
আপনি যদি এটিকে একটি হায়ারার্কি হিসেবে দেখেন, তাহলে সেটিংসগুলি নিম্নলিখিতভাবে সাজানো হয়, যেখানে গ্রাহকের সেটিংসের সর্বোচ্চ অগ্রাধিকার থাকে যাতে ইনস্টলার টিম বা Apigee-এর যেকোনও সেটিংস ওভাররাইড করা যায়:
- গ্রাহক
- ইনস্টলার
- Apigee
.properties ফাইল কীভাবে ব্যবহার করতে হয়
গ্রাহক হিসেবে, আপনি শুধুমাত্র /opt/apigee/customer/application ডিরেক্টরিতে .properties ফাইল পরিবর্তন করতে পারবেন। প্রতিটি কম্পোনেন্টের নিজস্ব .properties ফাইল সেই ডিরেক্টরিতে থাকে। যেমন, router.properties এবং management-server.properties.
যেমন, .properties ফাইল তৈরি করতে:
- যেকোনও ব্যবহারকারী হিসেবে এডিটরে ফাইল তৈরি করুন।
- apigee:apigee-এর মালিকানাধীন ফাইলটি পরিবর্তন করুন অথবা আপনি যদি apigee ব্যবহারকারীর থেকে Edge পরিষেবা পরিচালিত ব্যবহারকারীকে পরিবর্তন করে থাকেন, তাহলে Edge পরিষেবা পরিচালিত ব্যবহারকারীর মালিকানাধীন ফাইলটি পরিবর্তন করুন।
কোনও কম্পোনেন্টের প্রপার্টি সেট করতে, টোকেন সেট করার জন্য সংশ্লিষ্ট .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 ফাইলের তিনটি টপ-লেভেল ডিরেক্টরি আছে: ইনস্টলেশন মালিক এবং গ্রাহক। নিচে দেওয়া সারণীতে ডিফল্ট লোকেশন দেখানো হয়েছে:
সতর্কতা: Edge গ্রাহকরা শুধুমাত্র /opt/apigee/customer-এর অধীনে .properties ফাইল পরিবর্তন করতে পারবেন। আপনি কম্পোনেন্ট ও ইনস্টলেশন ডিরেক্টরির অধীনে ফাইল দেখতে পেলেও, কোনও ফাইল পরিবর্তন করবেন না।
|
মালিক |
ডিফল্ট টোকেন রুট ডিরেক্টরি |
|---|---|
|
কম্পোনেন্ট |
/opt/apigee/<prefix>-<component>/conf যেখানে /<prefix>-<component> কম্পোনেন্টকে শনাক্ত করে, যেমন edge-router বা apigee-cassandra. |
|
ইনস্টল করা |
/opt/apigee/token |
|
গ্রাহক |
/opt/apigee/customer |
টোকেনের বর্তমান ভ্যালু নির্ধারণ করা
কম্পোনেন্টের জন্য .properties ফাইলে টোকেন সেট করার আগে, আপনি নিম্নলিখিত কমান্ড ব্যবহার করে প্রথমে এর বর্তমান ভ্যালু নির্ধারণ করতে পারেন:
> /opt/apigee/apigee-service/bin/apigee-service comp configure -search token
যেখানে comp হল কম্পোনেন্টের নাম এবং 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 ফাইলে টোকেন সেট করা
টোকেনের ভ্যালু ওভাররাইড করতে:
- টোকেন ভ্যালু সেট করতে, কম্পোনেন্টের জন্য .properties ফাইল এডিট করুন। ফাইলটি না থাকলে, এটি তৈরি করুন।
- কম্পোনেন্ট রিস্টার্ট করুন।
- টোকেনের ভ্যালু চেক করুন।
যেমন, Edge রাউটারের জন্য অনুরোধ লাইনের সীমা সেট করতে:
- conf_http_HTTPRequest.line.limit টোকেন সেট করতে /opt/apigee/customer/application/router.properties
ফাইল এডিট করুন:
conf_http_HTTPRequest.line.limit=8k - Edge রাউটার রিস্টার্ট করুন:
> /opt/apigee/apigee-service/bin/apigee-service edge-router restart - টোকেনের ভ্যালু চেক করুন:
> /opt/apigee/apigee-service/bin/apigee-service edge-router configure -search conf_http_HTTPRequest.line.limit
একাধিক ভ্যালু নেয় এমন টোকেন সেট করা
কিছু টোকেন কমা দিয়ে আলাদা করা ভ্যালুর তালিকা নেয়। যেমন, conf_security_rbac.restricted.resources টোকেন সীমাবদ্ধ URI-এর একটি তালিকা নেয় যাতে শুধুমাত্র সিস্টেম অ্যাডমিন সেগুলি কল করতে পারেন। 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/*
টোকেন খুঁজে পাওয়া
বেশিরভাগ ক্ষেত্রে, আপনাকে যেসব টোকেন সেট করতে হবে সেগুলি এই নির্দেশিকায় শনাক্ত করা হয়েছে। তবে, কোনও প্রপার্টি ওভাররাইড করার জন্য ব্যবহৃত টোকেন নির্ধারণ করতে চাইলে, কম্পোনেন্টের সোর্স ফোল্ডারে 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
যেমন, আপনি Message Processor-এ 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