كيفية ضبط Edge

Edge for Private Cloud ‏v4.18.05

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

تشير Apigee إلى أسلوب تعديل ملفات .properties باسم الرمز البرمجي مع الإعداد. في الأساس، رمز الإعدادات هو أداة للبحث عن المفاتيح/القيم استنادًا إلى الإعدادات فيملفَي .properties. في الرمز البرمجي الذي يتضمّن config، يُشار إلى المفاتيح باسم الرموز المميّزة. لذلك، لضبط 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

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

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

  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 Router: 
    /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. لذلك، لإضافة معرّف الموارد المنتظم /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 property وتريد معرفة قيمة الرمز المميّز المستخدَمة لضبطه، ثم 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 على Message Processor. بعد ذلك، يمكنك 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