كيفية ضبط Edge

الإصدار 4.18.05 من Edge الخاص بخدمة Private Cloud

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

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

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

على سبيل المثال، إذا كنت تعلم أنّك ضبطت السمة session.maxAge في إصدار سابق من Edge وتريد معرفة قيمة الرمز المميّز المستخدَم لضبطها، يمكنك استخدام 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