কিভাবে এজ কনফিগার করবেন

প্রাইভেট ক্লাউড v4.18.01 এর জন্য এজ

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

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

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

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

1. ক্রেতা
2. ইনস্টলার
3. এপিজি

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

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

উদাহরণস্বরূপ, একটি .properties ফাইল তৈরি করতে:

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

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

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

উদাহরণস্বরূপ, router.properties সম্পাদনা করার পরে, রাউটার পুনরায় চালু করুন:

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

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

.properties ফাইলের অবস্থান

এজ উপাদানগুলির জন্য .properties ফাইলগুলির জন্য তিনটি শীর্ষ-স্তরের ডিরেক্টরি রয়েছে: ইনস্টলেশন মালিক এবং গ্রাহক৷ ডিফল্ট অবস্থানগুলি নিম্নলিখিত টেবিলে দেখানো হয়েছে:

সতর্কতা : এজ গ্রাহকরা শুধুমাত্র /opt/apigee/customer এর অধীনে .properties ফাইলগুলি পরিবর্তন করতে পারবেন। আপনি যখন কম্পোনেন্ট এবং ইনস্টলেশন ডিরেক্টরির অধীনে ফাইল দেখতে পারেন, তখন কোনো ফাইল পরিবর্তন করবেন না।

একটি টোকেনের বর্তমান মান নির্ধারণ করা

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

> /opt/apigee/apigee-service/bin/apigee-service comp configure -search token

যেখানে comp হল কম্পোনেন্টের নাম এবং টোকেন হল পরিদর্শনের টোকেন।

এই কমান্ডটি টোকেনের বর্তমান মান নির্ধারণ করতে .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 এজ-রাউটার পুনরায় চালু করুন
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/*

একটি টোকেন সনাক্তকরণ

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

উদাহরণস্বরূপ, যদি আপনি জানেন যে এজ-এর পূর্ববর্তী রিলিজে আপনি 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 ফাইলে সেট করেছেন৷

একটি টোকেন সেট করা যা বর্তমানে মন্তব্য করা হয়েছে

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

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

conf/file.extension+propertyName=propertyValue

উদাহরণস্বরূপ, আপনি মেসেজ প্রসেসরে HTTPClient.proxy.host নামের প্রপার্টি সেট করতে চান। তারপরে আপনি সম্পত্তির টোকেন নির্ধারণের জন্য গ্রেপ করুন :

> 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

প্রাইভেট ক্লাউড v4.18.01 এর জন্য এজ

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

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

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

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

1. ক্রেতা
2. ইনস্টলার
3. এপিজি

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

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

উদাহরণস্বরূপ, একটি .properties ফাইল তৈরি করতে:

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

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

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

উদাহরণস্বরূপ, router.properties সম্পাদনা করার পরে, রাউটার পুনরায় চালু করুন:

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

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

.properties ফাইলের অবস্থান

এজ উপাদানগুলির জন্য .properties ফাইলগুলির জন্য তিনটি শীর্ষ-স্তরের ডিরেক্টরি রয়েছে: ইনস্টলেশন মালিক এবং গ্রাহক৷ ডিফল্ট অবস্থানগুলি নিম্নলিখিত টেবিলে দেখানো হয়েছে:

সতর্কতা : এজ গ্রাহকরা শুধুমাত্র /opt/apigee/customer এর অধীনে .properties ফাইলগুলি পরিবর্তন করতে পারবেন। আপনি যখন কম্পোনেন্ট এবং ইনস্টলেশন ডিরেক্টরির অধীনে ফাইল দেখতে পারেন, তখন কোনো ফাইল পরিবর্তন করবেন না।

একটি টোকেনের বর্তমান মান নির্ধারণ করা

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

> /opt/apigee/apigee-service/bin/apigee-service comp configure -search token

যেখানে comp হল কম্পোনেন্টের নাম এবং টোকেন হল পরিদর্শনের টোকেন।

এই কমান্ডটি টোকেনের বর্তমান মান নির্ধারণ করতে .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 এজ-রাউটার পুনরায় চালু করুন
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/*

একটি টোকেন সনাক্তকরণ

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

উদাহরণস্বরূপ, যদি আপনি জানেন যে এজ-এর পূর্ববর্তী রিলিজে আপনি 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 ফাইলে সেট করেছেন৷

একটি টোকেন সেট করা যা বর্তমানে মন্তব্য করা হয়েছে

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

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

conf/file.extension+propertyName=propertyValue

উদাহরণস্বরূপ, আপনি মেসেজ প্রসেসরে HTTPClient.proxy.host নামের প্রপার্টি সেট করতে চান। তারপরে আপনি সম্পত্তির টোকেন নির্ধারণের জন্য গ্রেপ করুন :

> 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