Edge for Private Cloud، الإصدار 4.17.01
لإعداد Edge بعد التثبيت، عليك استخدام مجموعة من ملفات .properties وأدوات مساعدة Edge. بالنسبة على سبيل المثال، لإعداد بروتوكول أمان طبقة النقل (TLS)/طبقة المقابس الآمنة (SSL) على واجهة مستخدم Edge، يمكنك تعديل ملفات .properties لتحديد الملفات المواقع. تتطلب منك التغييرات التي طرأت على ملفات .properties إعادة تشغيل مكون Edge المتأثر.
تشير Apigee إلى أسلوب تعديل ملفات .properties على هيئة رمز برمجي باستخدام الإعداد. بشكل أساسي، يعد الكود مع التكوين أداة بحث عن المفتاح/القيمة بناءً على الإعدادات في ملفات .properties. في رمز مع ، يُشار إلى المفاتيح باسم الرموز المميزة. لذلك، لإعداد Edge، يمكنك إعداد الرموز المميّزة في ملفات .properties.
يسمح التعليمة البرمجية ذات التهيئة لمكونات Edge بتعيين القيم الافتراضية التي يتم شحنها باستخدام يتيح لفريق التثبيت إلغاء هذه الإعدادات بناءً على طوبولوجيا التثبيت، وبعد ذلك، يسمح للعملاء بإلغاء أي خصائص يختارونها.
إذا كنت تفكر في الأمر على أنه تسلسل هرمي، فإن الإعدادات يتم ترتيبها على النحو التالي مع العميل الإعدادات التي لها الأولوية القصوى لإلغاء أي إعدادات من فريق التثبيت أو Apigee:
- العميل
- أداة تثبيت
- Apigee
كيفية استخدام ملفات .property
بصفتك عميلاً، لا يمكنك تعديل ملفات .properties فقط في /opt/apigee/customer/application الدليل. ويحتوي كل مكوّن على ملف .properties الخاص به في هذا الدليل. على سبيل المثال، router.properties وmanagement-server.properties.
- أنشئ الملف في أحد المحرّرين مثل أي مستخدم.
- قطع مالك الملف إلى 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. أثناء عرض الملفات ضمن أدلة المكوّنات والتثبيت، ولا تعدِّل أي ملفات.
|
المالك |
الدليل الجذر للرمز المميّز التلقائي |
|---|---|
|
المكوّن |
/opt/apigee/<prefix>-<component>/conf أين /<prefix>-<component> يحدد العنصر، مثل جهاز توجيه الحافة أو واجهة برمجة التطبيقات apigee-cassandra. |
|
تثبيت |
/opt/apigee/token |
|
العميل |
/opt/apigee/customer |
تحديد القيمة الحالية للرمز المميّز
قبل إعداد رمز مميّز في الملف .properties للمكوّن، يمكنك أولاً تحديد قيمتها الحالية باستخدام الأمر التالي:
> /opt/apigee/apigee-service/bin/apigee-service comp configure -search token
حيث comp هي اسم المكوِّن الرمز المميّز هو الرمز المميّز الذي يجب فحصه.
يبحث هذا الأمر في التسلسل الهرمي لملفات .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
لإلغاء قيمة رمز مميّز:
- عدِّل الملف .properties لتعيين قيمة الرمز. إذا لم يكن الملف موجودًا، عليك إنشاؤه.
- أعِد تشغيل المكوِّن.
- تحقَّق من قيمة الرمز المميّز.
على سبيل المثال، لضبط حد سطر الطلب لجهاز توجيه Edge:
- عدِّل /opt/apigee/customer/application/router.properties
لضبط الرمز المميّز conf_http_HTTPRequest.line.limit:
conf_http_HTTPRequest.line.limit=8k - أعِد تشغيل جهاز توجيه Edge:
.
> /opt/apigee/apigee-service/bin/apigee-service Edge-router - التحقّق من قيمة الرمز المميّز:
> /opt/apigee/apigee-service/bin/apigee-service-router Configuration -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
في نهاية الملف، سترى السمة set (مجموعة الخصائص) على النحو التالي:
conf/http.properties:HTTPClient.proxy.host=yhost.name.com