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

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

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

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

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

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

  1. গ্রাহক
  2. ইনস্টলার
  3. কম্পোনেন্ট

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

.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

টোকেনের ভ্যালু # দিয়ে শুরু হলে, সেটি কমেন্ট আউট করা হয়েছে এবং আপনাকে এটি পরিবর্তন করতে বিশেষ সিনট্যাক্স ব্যবহার করতে হবে। আরও তথ্যের জন্য, বর্তমানে কমেন্ট করা টোকেন সেট করুন দেখুন।

আপনি টোকেনের সম্পূর্ণ নাম না জানলে, প্রপার্টির নাম বা কীওয়ার্ড দিয়ে সার্চ করতে grep-এর মতো টুল ব্যবহার করুন । আরও তথ্যের জন্য, টোকেন লোকেট করুন দেখুন।

প্রপার্টি ফাইল

এডিট করা যায় ও যায় না এমন কম্পোনেন্ট কনফিগারেশন ফাইল আছে। এই বিভাগে এইসব ফাইলের বর্ণনা দেওয়া আছে।

এডিট করা যায় এমন কম্পোনেন্ট কনফিগারেশন ফাইল

নিচের সারণীতে Apigee কম্পোনেন্ট ও প্রপার্টি ফাইলের তালিকা দেওয়া হল, যেগুলি আপনি এডিট করে সেইসব কম্পোনেন্ট কনফিগার করতে পারবেন:

কম্পোনেন্ট কম্পোনেন্টের নাম এডিট করা যায় এমন কনফিগারেশন ফাইল
Cassandra apigee-cassandra /opt/apigee/customer/application/cassandra.properties
Edge UI edge-ui /opt/apigee/customer/application/ui.properties
Edge SSO apigee-sso /opt/apigee/customer/application/sso.properties
ম্যানেজমেন্ট সার্ভার edge-management-server /opt/apigee/customer/application/management-server.properties
মেসেজ প্রসেসর edge-message-processor /opt/apigee/customer/application/message-processor.properties
apigee-monit apigee-monit /opt/apigee/customer/application/monit.properties
নতুন UE apigee-management-ui প্রযোজ্য নয় (ইনস্টলেশন কনফিগারেশন ফাইল ব্যবহার করুন)
OpenLDAP apigee-openldap /opt/apigee/customer/application/openldap.properties
Postgres সার্ভার edge-postgres-server /opt/apigee/customer/application/postgres-server.properties
PostgreSQL ডেটাবেস apigee-postgresql /opt/apigee/customer/application/postgressql.properties
Qpid সার্ভার edge-qpid-server /opt/apigee/customer/application/qpid-server.properties
Qpidd apigee-qpidd /opt/apigee/customer/application/qpidd.properties
রাউটার edge-router /opt/apigee/customer/application/router.properties
চিড়িয়াখানার কর্মী apigee-zookeeper /opt/apigee/customer/application/zookeeper.properties

আপনি যদি এইসব কম্পোনেন্ট কনফিগারেশন ফাইলের মধ্যে কোনও একটিতে কোনও প্রপার্টি সেট করতে চান কিন্তু সেটি বিদ্যমান না থাকে, তাহলে উপরে তালিকাভুক্ত লোকেশনে সেটি তৈরি করতে পারবেন।

এছাড়াও, আপনাকে অবশ্যই নিশ্চিত করতে হবে যে প্রপার্টি ফাইলের মালিক "apigee" ব্যবহারকারী:

chown apigee:apigee /opt/apigee/customer/application/configuration_file.properties

এডিট করা যায় না এমন কম্পোনেন্ট কনফিগারেশন ফাইল

এডিট করা যায় এমন কম্পোনেন্ট কনফিগারেশন ফাইল ছাড়াও, এমন কনফিগারেশন ফাইল থাকে যা আপনি এডিট করতে পারবেন না।

তথ্যমূলক (এডিট করা যায় না) ফাইলের মধ্যে নিম্নলিখিত বিষয়গুলি অন্তর্ভুক্ত:

মালিক ফাইলের নাম বা ডিরেক্টরি
ইনস্টল করা 
/opt/apigee/token
কম্পোনেন্ট 
/opt/apigee/component_name/conf

যেখানে component_name কম্পোনেন্টকে শনাক্ত করে। সম্ভাব্য ভ্যালুর মধ্যে এগুলি অন্তর্ভুক্ত:

  • apigee-cassandra (Cassandra)
  • apigee-openldap (OpenLDAP)
  • apigee-postgresql (PostgreSQL ডেটাবেস)
  • apigee-qpidd (Qpidd)
  • apigee-sso (Edge SSO)
  • apigee-zookeeper (ZooKeeper)
  • edge-management-server (ম্যানেজমেন্ট সার্ভার)
  • edge-management-ui (নতুন Edge UI)
  • edge-message-processor (মেসেজ প্রসেসর)
  • edge-postgres-server (Postgres সার্ভার)
  • edge-qpid-server (Qpid সার্ভার)
  • edge-router (এজ রাউটার)
  • edge-ui (ক্লাসিক UI)

টোকেন ভ্যালু সেট করা

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

.properties ফাইল তৈরি করতে:

  1. এডিটরে নতুন টেক্সট ফাইল তৈরি করুন। গ্রাহকের ফাইলের জন্য উপরে দেখানো টেবিলে দেখানো তালিকার সাথে ফাইলের নাম অবশ্যই মিলতে হবে।
  2. নিচের উদাহরণে দেখানো হয়েছে সেইভাবে ফাইলের মালিককে "apigee:apigee" হিসেবে পরিবর্তন করুন: 
    chown apigee:apigee /opt/apigee/customer/application/router.properties

    আপনি যদি "apigee" ব্যবহারকারী থেকে Edge পরিষেবা চালানো ব্যবহারকারীকে পরিবর্তন করে থাকেন, তাহলে Edge পরিষেবা চালানো ব্যবহারকারীর মালিকানা পরিবর্তন করতে chown ব্যবহার করুন।

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

টোকেনের ভ্যালু সেট করতে:

  1. কম্পোনেন্টের .properties ফাইল এডিট করুন।
  2. টোকেনের ভ্যালু যোগ বা পরিবর্তন করুন। নিচে দেওয়া উদাহরণটি conf_http_HTTPRequest.line.limit প্রপার্টির ভ্যালু "10k" হিসেবে সেট করে: 
    conf_http_HTTPRequest.line.limit=10k

    টোকেন একাধিক মান নিলে, প্রতিটি মান কমা দিয়ে আলাদা করুন, যেমনটি নিম্নলিখিত উদাহরণে দেখানো হয়েছে:

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

    এই ধরনের তালিকায় নতুন ভ্যালু যোগ করতে, সাধারণত তালিকার শেষে নতুন ভ্যালু যোগ করা হয়।

  3. কম্পোনেন্ট রিস্টার্ট করুন: 
    /opt/apigee/apigee-service/bin/apigee-service component_name restart

    যেখানে component_name হল নিম্নলিখিতগুলির মধ্যে একটি:

    • apigee-cassandra (Cassandra)
    • apigee-openldap (OpenLDAP)
    • apigee-postgresql (PostgreSQL ডেটাবেস)
    • apigee-qpidd (Qpidd)
    • apigee-sso (Edge SSO)
    • apigee-zookeeper (ZooKeeper)
    • edge-management-server (ম্যানেজমেন্ট সার্ভার)
    • edge-management-ui (নতুন Edge UI)
    • edge-message-processor (মেসেজ প্রসেসর)
    • edge-postgres-server (Postgres সার্ভার)
    • edge-qpid-server (Qpid সার্ভার)
    • edge-router (এজ রাউটার)
    • edge-ui (ক্লাসিক UI)

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

    /opt/apigee/apigee-service/bin/apigee-service edge-router restart
  4. (ঐচ্ছিক) configure -search বিকল্প ব্যবহার করে টোকেন ভ্যালু আপনার নতুন ভ্যালুতে সেট করা হয়েছে কিনা তা চেক করুন। যেমন: 
    /opt/apigee/apigee-service/bin/apigee-service edge-router configure -search conf_http_HTTPRequest.line.limit

    configure -search সম্পর্কে আরও তথ্যের জন্য, এখানে দেখুন: টোকেনের বর্তমান ভ্যালু নির্ধারণ করুন।

টোকেন খুঁজে পাওয়া

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

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

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

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

/opt/apigee/component_name/source/conf/application.conf:property_name={T}token_name{/T}

নিম্নলিখিত উদাহরণে UI-এর session.maxAge টোকেনের ভ্যালু দেখানো হয়েছে:

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

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

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

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

Edge কনফিগারেশন ফাইলে কমেন্ট করা টোকেনের ভ্যালু সেট করতে, নিম্নলিখিত ফর্ম্যাটে বিশেষ সিনট্যাক্স ব্যবহার করুন:

conf/filename+propertyName=propertyValue

যেমন, Message Processor-এ HTTPClient.proxy.host নামের প্রপার্টি সেট করতে, প্রথমে প্রপার্টির টোকেন নির্ধারণ করতে grep:

grep -ri /opt/apigee/edge-message-processor/ -e "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+ যোগ করতে হবে। এটি হল প্রপার্টি সহ কনফিগারেশন ফাইলের লোকেশন ও নাম, এর পরে "+" চিহ্নটি রয়েছে।

Message Processor রিস্টার্ট করার পরে, ফাইলটি পরীক্ষা করে দেখুন /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