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