كيفية ضبط Edge

الإصدار 4.18.05 من Edge for Private Cloud

لإعداد Edge بعد التثبيت، عليك استخدام مجموعة من ملفات .properties. وEdge. على سبيل المثال، لتهيئة TLS/SSL على واجهة مستخدم Edge، يمكنك تعديل .properties ملف لضبط الخصائص اللازمة. التغييرات على يجب إعادة تشغيل مكوّن Edge المتأثر بالمشكلة في .properties ملف.

تشير Apigee إلى أسلوب تعديل ملفات .properties باعتبارها رمز برمجي باستخدام . بشكل أساسي، يعد الكود مع التكوين أداة بحث عن المفتاح/القيمة بناءً على الإعدادات في ملفات .properties. في التعليمات البرمجية مع الإعداد، يُشار إلى المفاتيح باسم الرموز المميزة. لذلك، لإعداد Edge، يمكنك ضبط الرموز المميّزة في .properties. الملفات.

يسمح التعليمة البرمجية ذات التهيئة لمكونات Edge بتعيين القيم الافتراضية التي يتم شحنها باستخدام يتيح لفريق التثبيت إلغاء هذه الإعدادات بناءً على طوبولوجيا التثبيت، وبعد ذلك، يسمح للعملاء بإلغاء أي خصائص يختارونها.

إذا كنت تفكر في الأمر على أنه تسلسل هرمي، فإن الإعدادات يتم ترتيبها على النحو التالي مع العميل الإعدادات التي لها الأولوية القصوى لإلغاء أي إعدادات من فريق التثبيت أو Apigee:

  1. العميل
  2. أداة تثبيت
  3. Apigee

كيفية استخدام ملفات .property

بصفتك عميلاً، يمكنك تعديل ملفات .properties فقط في دليل /opt/apigee/customer/application. لكل مكون دوره الخاص ملف .properties في هذا الدليل. على سبيل المثال: router.properties وmanagement-server.properties.

على سبيل المثال، لإنشاء ملف .properties:

  1. أنشئ الملف في أحد المحرّرين مثل أي مستخدم.
  2. استخدم chown لتغيير مالك الملف إلى "apigee:apigee" أو، إذا قمت بتغيير المستخدم الذي يشغِّل خدمة Edge من "apigee" للمستخدم، يمكن اختيار الملف للمستخدم الذي يقوم بتشغيل خدمة Edge.

لضبط سمة لأحد المكوّنات، يجب تعديل ملف .properties المقابل لإعداده. رمز مميز، ثم أعِد تشغيل المكون:

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

على سبيل المثال، بعد تعديل router.properties، أعِد تشغيل جهاز التوجيه:

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

عند ترقية Edge، سيتم حفظ الملفات البالغ عددها .properties في تمت قراءة الدليل /opt/apigee/customer/application. وهذا يعني أن الترقية الاحتفاظ بأي خصائص قمت بتعيينها على المكون.

موقع ملفات .properties

هناك ثلاثة أدلة من المستوى الأعلى لملفات .properties في Edge. المكونات: التثبيت والمالك والعملاء. تظهر المواقع الجغرافية التلقائية في ما يلي :

المالك الدليل الجذري التلقائي للرمز المميّز
المكوّن 
/opt/apigee/component_name/conf

حيث تحدِّد component_name المكوِّن. القيم المحتملة تشمل:

  • apigee-cassandra (كاساندرا)
  • apigee-openldap (OpenLDAP)
  • apigee-postgresql (قاعدة بيانات PostgreSQL)
  • apigee-qpidd (Qbidd)
  • apigee-sso (الدخول الموحّد في Edge)
  • apigee-zookeeper (ZooKeeper)
  • edge-management-server (خادم الإدارة)
  • edge-management-ui (واجهة مستخدم Edge الجديدة)
  • edge-message-processor (معالج الرسائل)
  • edge-postgres-server (خادم Postgres)
  • edge-qpid-server (خادم Qbid)
  • edge-router (جهاز توجيه الحواف)
  • edge-ui (واجهة المستخدم الكلاسيكية)
تثبيت 
/opt/apigee/token
العميل 
/opt/apigee/customer

تحديد القيمة الحالية للرمز المميّز

قبل ضبط رمز مميّز في ملف .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

ضبط الرموز المميّزة في ملفات .properties

لإلغاء قيمة رمز مميّز:

  1. عدِّل ملف .properties الخاص بالمكوّن لضبط قيمة الرمز المميّز. إذا كان الملف غير موجود، ثم قم بإنشائه.
  2. أعِد تشغيل المكوِّن.
  3. تحقَّق من قيمة الرمز المميّز.

على سبيل المثال، لضبط حد سطر الطلب لجهاز توجيه Edge:

  1. عدِّل ملف /opt/apigee/customer/application/router.properties لضبط الرمز المميز من conf_http_HTTPRequest.line.limit: 
    conf_http_HTTPRequest.line.limit=8k
  2. أعِد تشغيل جهاز توجيه Edge: 
    /opt/apigee/apigee-service/bin/apigee-service edge-router restart
  3. التحقّق من قيمة الرمز المميّز: 
    /opt/apigee/apigee-service/bin/apigee-service edge-router configure -search conf_http_HTTPRequest.line.limit

تحديد رمز مميّز يتضمّن قيمًا متعدّدة

تأخذ بعض الرموز المميزة قائمة قيم مفصولة بفواصل. على سبيل المثال، يأخذ الرمز المميّز conf_security_rbac.restricted.resources قائمة بعناوين URL المحظورة لكي لا يمكن لأحد سوى مسؤول إدارة النظم الاتصال بها. لمعرفة قيمة 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. لذلك، لإضافة عنوان URI /myuri/* إلى conf_security_rbac.restricted.resources، قم بتعديل ملف /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 في source من المكوِّن.

على سبيل المثال، إذا كنت تعلم أنه في إصدار سابق من Edge، قمت بتعيين session.maxAge ويريدون معرفة قيمة الرمز المميّز المستخدَم لضبطه، ثم grep للسمة في دليل /opt/apigee/edge-ui/source:

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

على سبيل المثال، إذا أردت ضبط السمة المسماة 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

في نهاية الملف، سترى السمة set (مجموعة الخصائص) على النحو التالي:

conf/http.properties:HTTPClient.proxy.host=myhost.name.com