كيفية ضبط Edge

Edge for Private Cloud، الإصدار 4.16.05

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

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

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

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

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

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

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

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

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

> /<inst_root>/apigee/apigee-service/bin/apigee-service component restart

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

> /<inst_root>/apigee/apigee-service/bin/apigee-service edge-router restart

عند ترقية Edge، ستظهر الملفات .properties في /<inst_root>/apigee/customer/application الدليل. وهذا يعني أنّ الترقية ستحتفظ بأيّ مواقع حدّدتها على المكون.

موقع ملفات .properties

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

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

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

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

> /<inst_dir>/apigee/apigee-service/bin/apigee-service comp configure -search token

حيث comp هي اسم المكوِّن الرمز المميّز هو الرمز المميّز الذي يجب فحصه.

يبحث هذا الأمر في التسلسل الهرمي لملفات .properties لتحديد القيمة الحالية للرمز المميّز.

على سبيل المثال، للتحقّق من القيمة الحالية للرمز المميّز conf_router_HTTP.request.line.limit من أجل جهاز التوجيه:

> /<inst_dir>/apigee/apigee-service/bin/apigee-service edge-router configure -search conf_router_HTTP.request.line.limit

من المفترض أن يظهر لك الناتج في النموذج:

Found key conf_router_HTTP.request.line.limit, with value, 4k, in /opt/apigee/edge-router/token/default.properties

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

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

1. عدِّل الملف .properties لتعيين قيمة الرمز. إذا لم يكن الملف موجودًا، عليك إنشاؤه.
2. أعِد تشغيل المكوِّن.
3. تحقَّق من قيمة الرمز المميّز.

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

1. عدِّل /<inst_root>/apigee/customer/application/router.properties لضبط conf_router_HTTP.request.line.limit الرمز المميّز:
   
   conf_router_HTTP.request.line.limit=8k
2. أعِد تشغيل جهاز توجيه Edge:
   .
   &gt; /<inst_root>/apigee/apigee-service/bin/apigee-service Edge-router إعادة تشغيل
3. التحقّق من قيمة الرمز المميّز:
   
   &gt; /<inst_dir>/apigee/apigee-service/bin/apigee-service Edge-router Configuration -search conf_router_HTTP.request.line.limit

إعداد رمز مميز يستخدم قيمًا متعددة

تأخذ بعض الرموز المميزة قائمة قيم مفصولة بفواصل. على سبيل المثال، الرمز المميّز conf_security_rbac.restricted.resources. قائمة بعناوين URI المقيدة بحيث لا يتمكن أحد من الاتصال بها سوى مسؤول إدارة النظم. للاطلاع على قيمة conf_security_rbac.restricted.resources:

> cd /<inst_root>/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، تعديل /&lt;inst_root&gt;/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 للسمة في /<inst_root>/apigee/edge-ui/source الدليل:

> grep -ri "session.maxAge" /<inst_root>/apigee/edge-ui/source

من المفترض أن تظهر لك نتيجة في النموذج:

/<inst_root>/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=yhost.name.com