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

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

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

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

আপনি যদি এটিকে একটি শ্রেণিবিন্যাস হিসাবে মনে করেন, তাহলে সেটিংসগুলি নিম্নরূপ সাজানো হয়েছে, গ্রাহক সেটিংসের সাথে ইনস্টলার টিম বা 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 উপাদান এবং বৈশিষ্ট্য ফাইলগুলি তালিকাভুক্ত করে যা আপনি এই উপাদানগুলি কনফিগার করতে সম্পাদনা করতে পারেন:

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

উপরন্তু, আপনাকে অবশ্যই নিশ্চিত করতে হবে যে বৈশিষ্ট্য ফাইলটি "apigee" ব্যবহারকারীর মালিকানাধীন:

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

অ-সম্পাদনাযোগ্য কম্পোনেন্ট কনফিগারেশন ফাইল

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

তথ্যগত (অ-সম্পাদনাযোগ্য) ফাইলগুলির মধ্যে নিম্নলিখিতগুলি অন্তর্ভুক্ত রয়েছে:

/opt/apigee/token

/opt/apigee/component_name/conf

একটি টোকেন মান সেট করুন

আপনি শুধুমাত্র /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" ব্যবহারকারী থেকে এজ পরিষেবা চালান এমন ব্যবহারকারীকে পরিবর্তন করেন, তাহলে এজ পরিষেবাটি চালাচ্ছে এমন ব্যবহারকারীর মালিকানা পরিবর্তন করতে chown ব্যবহার করুন।

আপনি যখন এজ আপগ্রেড করেন, /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 (ক্যাসান্দ্রা)
   • apigee-openldap (OpenLDAP)
   • apigee-postgresql (PostgreSQL ডাটাবেস)
   • apigee-qpidd (Qpidd)
   • apigee-sso (এজ এসএসও)
   • apigee-zookeeper (চিড়িয়াখানা)
   • edge-management-server (ম্যানেজমেন্ট সার্ভার)
   • edge-management-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 ব্যবহার করুন।

উদাহরণস্বরূপ, যদি আপনি জানেন যে এজ-এর পূর্ববর্তী রিলিজে আপনি 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 মান দেখায়। maxAge টোকেন:

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

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

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

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

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

conf/filename+propertyName=propertyValue

উদাহরণ স্বরূপ, মেসেজ প্রসেসরে 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+ এর সাথে সম্পত্তির নাম উপসর্গ করতে হবে। এটি হল কনফিগারেশন ফাইলের অবস্থান এবং নাম যেখানে "+" দ্বারা অনুসরণ করা সম্পত্তি রয়েছে।

আপনি মেসেজ প্রসেসর পুনরায় চালু করার পরে, ফাইলটি পরীক্ষা করুন /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

ট্রেস UI এর অনুরোধ পাঠান বিভাগ থেকে অনুরোধের জন্য ফরোয়ার্ড প্রক্সি কনফিগার করুন

এই বিভাগটি ব্যাখ্যা করে কিভাবে ঐচ্ছিক প্রক্সি শংসাপত্র সহ ট্রেস UI এর অনুরোধ পাঠান বিভাগ থেকে অনুরোধের জন্য ফরোয়ার্ড প্রক্সি কনফিগার করতে হয়। ফরোয়ার্ড প্রক্সি কনফিগার করতে:

1. /opt/apigee/customer/application/ui.properties সম্পাদনা করুন এবং নিশ্চিত করুন যে ফাইলটি apigee:apigee এর মালিকানাধীন।
2. নিম্নলিখিত ওভাররাইডগুলি যোগ করুন (আপনার নির্দিষ্ট প্রক্সি কনফিগারেশনে মান পরিবর্তন করা):

   conf_application_http.proxyhost=proxy.example.com
   conf_application_http.proxyport=8080
   conf_application_http.proxyuser=apigee
   conf_application_http.proxypassword=Apigee123!

3. ক্লাসিক UI সংরক্ষণ করুন এবং পুনরায় চালু করুন।

Apigee রাউটার/Nginx-এ একটি কাস্টম লগ বিন্যাস যোগ করুন

কিছু ক্ষেত্রে, আপনাকে হয় ডিফল্ট Apigee রাউটার/Nginx লগ ফরম্যাট পরিবর্তন করতে হবে অথবা ভেরিয়েবল যোগ করতে হবে। ডিফল্ট Apigee রাউটার/Nginx লগ ফরম্যাট কনফিগারেশন আপডেট করতে:

1. একটি router.properties ফাইল তৈরি করুন, যদি এটি বিদ্যমান না থাকে, নীচে দেখানো পথ দিয়ে:

   /opt/apigee/customer/application/router.properties

2. router_new নামের একটি নতুন log_format কনফিগারেশন তৈরি করতে router.properties ফাইলে নিম্নলিখিত বিষয়বস্তু যোগ করুন:

   conf_load_balancing_load.balancing.driver.nginx.global.http.parameters.template.extra=log_format router_new 'time_iso8601\\\\thostname\\\\tremote_addr:remote_port\\\\t'\\\\n\\n 'upstream_addr\\\\trequest_time\\\\t-\\\\t-\\\\t'\\\\n\\n 'status\\\\tupstream_status\\\\trequest_length\\\\t'\\\\n\\n 'body_bytes_sent\\\\t'\\\\n\\n 'request\\\\tupstream_http_x_apigee_message_id\\\\t'\\\\n\\n 'http_user_agent\\\\thost\\thostname-pid-connection-connection_requests\\\\tmy_nginx_var_xff\\t'\\\\n\\n 'upstream_http_x_apigee_fault_flag\\\\tupstream_http_x_apigee_fault_source\\\\tupstream_http_x_apigee_fault_code\\\\t'\\\\n\\n 'upstream_http_x_apigee_fault_policy\\tupstream_http_x_apigee_fault_flow\\tupstream_http_x_apigee_fault_revision\\t'\\\\n\\n 'upstream_http_x_apigee_dp_color\\\\tmy_x_apigee_target_latency\\\\t'\\\\n\\n 'upstream_http_x_apigee_proxy\\\\tupstream_http_x_apigee_proxy_basepath\\\\t'\\\\n\\n 'self_region\\\\tself_pod\\\\tself_color\\\\tssl_protocol\\\\tssl_client_verify\\\\tssl_session_id\\\\tssl_session_reused\\\\tupstream_pod\\\\tupstream_region';\\\\n\\n\n
   conf_load_balancing_load.balancing.driver.nginx.access.log={conf_load_balancing_load.balancing.driver.nginx.log.dir}/{org}~{env}.{port}_access_log router_new

   উপযুক্ত হিসাবে উপরের কমান্ডগুলিতে ভেরিয়েবলগুলি আপডেট করুন। আপনি নীচের ফাইলটিতে log_format এর জন্য ডিফল্ট কনফিগারেশন মানগুলি খুঁজে পেতে পারেন:

   /opt/apigee/edge-router/conf/load_balancing.properties

   Nginx ভেরিয়েবলের একটি তালিকা http://nginx.org/en/docs/varindex.html এ প্রদর্শিত হয়।

3. নতুন কনফিগারেশন প্রয়োগ করতে রাউটারটি পুনরায় চালু করুন:

   apigee-service edge-router restart

4. /opt/nginx/conf.d/0-default.conf ফাইলে নতুন log_format কনফিগারেশন ( router_new ) যোগ করা হয়েছে কিনা তা পরীক্ষা করুন :

       
   cat /opt/nginx/conf.d/0-default.conf | grep router_new -A 10

5. একটি API প্রক্সিতে কিছু API অনুরোধ পাঠান এবং ফাইলটিতে নতুন লগ বিন্যাস যাচাই করুন

   /opt/apigee/var/log/edge-router/nginx/${org}~${env}.${port}_access_log file