كيفية ضبط Edge

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

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

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

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

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

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

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

بصفتك عميلاً، يمكنك فقط تعديل ملفات .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 Router:

  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 قائمة بمعرّفات الموارد المنتظمة (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. لذلك، لإضافة معرّف الموارد المنتظم (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

في نهاية الملف، ستظهر لك مجموعة السمات بالشكل التالي:

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