كيفية ضبط Edge

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

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

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

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

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

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

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

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

1. أنشئ الملف في محرِّر بصفتك أي مستخدم.
2. غيِّر مالك الملف إلى 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: مالك التثبيت والعملاء. يتم عرض المواقع الجغرافية التلقائية في الجدول التالي:

تحذير: يمكن لعملاء Edge تعديل ملفات .properties فقط ضمن /opt/apigee/customer. ومع أنّه يمكنك عرض الملفات ضمن أدلة المكوّنات والتثبيت، لا تعدِّل أي ملفات.

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

قبل ضبط رمز مميّز في ملف .properties للمكوّن، يمكنك أولاً تحديد قيمته الحالية باستخدام الأمر التالي:

> /opt/apigee/apigee-service/bin/apigee-service comp configure -search token

حيث comp هو اسم المكوّن، و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 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. لذلك، لإضافة معرّف الموارد المنتظم (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 في مجلد المصدر الخاص بالمكوّن.

على سبيل المثال، إذا كنت تعلم أنّه في إصدار سابق من 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