كيفية ضبط Edge

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

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

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

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

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

  1. العميل
  2. أداة تثبيت
  3. المكوّن

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

قبل ضبط قيمة جديدة لرمز مميّز في ملف .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

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

إذا كنت لا تعرف الاسم الكامل للرمز المميّز، استخدِم أداة مثل grep للبحث. باسم الخاصية أو الكلمة الأساسية. لمزيد من المعلومات، راجع تحديد موقع الرمز المميّز.

ملفات الخصائص

هناك ملفات إعداد مكوّنات قابلة للتعديل وغير قابلة للتعديل. يصف هذا القسم هذه الملفات.

ملفات إعداد المكونات القابلة للتعديل

يسرد الجدول التالي مكوّنات Apigee وملفات السمات التي يمكنك استخدامها. تحريره لتكوين هذه المكونات:

المكوّن اسم المكوِّن ملف إعداد قابل للتعديل
كاساندرا apigee-cassandra /opt/apigee/customer/application/cassandra.properties
واجهة مستخدم Edge edge-ui /opt/apigee/customer/application/ui.properties
الدخول المُوحَّد (SSO) إلى شبكة Edge apigee-sso /opt/apigee/customer/application/sso.properties
خادم الإدارة edge-management-server /opt/apigee/customer/application/management-server.properties
معالج الرسائل edge-message-processor /opt/apigee/customer/application/message-processor.properties
apigee-monit apigee-monit /opt/apigee/customer/application/monit.properties
واجهة مستخدم جديدة apigee-management-ui لا ينطبق (استخدام ملف إعدادات التثبيت)
OpenLDAP apigee-openldap /opt/apigee/customer/application/openldap.properties
خادم Postgres edge-postgres-server /opt/apigee/customer/application/postgres-server.properties
قاعدة بيانات PostgreSQL apigee-postgresql /opt/apigee/customer/application/postgressql.properties
خادم Qpid edge-qpid-server /opt/apigee/customer/application/qpid-server.properties
لوحة مفاتيح Qpidd apigee-qpidd /opt/apigee/customer/application/qpidd.properties
جهاز التوجيه edge-router /opt/apigee/customer/application/router.properties
حارس حديقة حيوان apigee-zookeeper /opt/apigee/customer/application/zookeeper.properties

إذا كنت تريد تعيين خاصية في أحد ملفات التهيئة المكونة هذه، ولكن لا الموجودة أعلاه، يمكنك إنشاؤها في المكان الموضح أعلاه.

بالإضافة إلى ذلك، يجب التأكّد من أنّ ملف الخصائص يملكه "apigee". المستخدم:

chown apigee:apigee /opt/apigee/customer/application/configuration_file.properties

ملفات إعداد المكوِّن غير القابلة للتعديل

بالإضافة إلى ملفات إعداد المكونات القابلة للتعديل، هناك أيضًا ملفات تهيئة لا يمكنك تعديله.

تشمل الملفات الإعلامية (غير القابلة للتعديل) ما يلي:

المالك اسم الملف أو الدليل
تثبيت 
/opt/apigee/token
المكوّن 
/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 (واجهة المستخدم الكلاسيكية)

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

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

لإنشاء ملف .properties:

  1. أنشئ ملفًا نصيًا جديدًا في محرِّر. يجب أن يتطابق اسم الملف مع القائمة المعروضة في أعلاه لملفات العملاء.
  2. غيّر مالك الملف إلى "apigee:apigee"، كما يبيِّن المثال التالي: 
    chown apigee:apigee /opt/apigee/customer/application/router.properties

    في حال تغيير المستخدم الذي يشغِّل خدمة Edge من "apigee" مستخدم، استخدم chown لتغيير الملكية إلى المستخدم الذي يشغل متصفّح Edge خدمة ما.

عند ترقية Edge، سيتم حفظ الملفات البالغ عددها .properties في تمت قراءة الدليل /opt/apigee/customer/application. وهذا يعني أن الترقية الاحتفاظ بأي خصائص قمت بتعيينها على المكون.

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

  1. عدِّل ملف .properties الخاص بالمكوِّن.
  2. أضِف قيمة الرمز المميّز أو غيِّرها. يحدد المثال التالي قيمة conf_http_HTTPRequest.line.limit إلى "10 آلاف": 
    conf_http_HTTPRequest.line.limit=10k

    إذا كان الرمز المميّز يحصل على قيم متعدّدة، افصل بين كلّ قيمة بفاصلة، على النحو التالي: مثال يوضح:

    conf_security_rbac.restricted.resources=/environments,/environments/*,/environments/*/virtualhosts,/environments/*/virtualhosts/*,/pods,/environments/*/servers,/rebuildindex,/users/*/status,/myuri/*

    لإضافة قيمة جديدة إلى قائمة مثل هذه، عادةً ما تُلحق القيمة الجديدة في النهاية من القائمة.

  3. أعِد تشغيل المكوِّن: 
    /opt/apigee/apigee-service/bin/apigee-service component_name restart

    حيث تكون السمة 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 (واجهة المستخدم الكلاسيكية)

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

    /opt/apigee/apigee-service/bin/apigee-service edge-router restart
  4. (اختياري) تحقّق من ضبط قيمة الرمز المميّز على القيمة الجديدة باستخدام الخيار configure -search. مثل: 
    /opt/apigee/apigee-service/bin/apigee-service edge-router configure -search conf_http_HTTPRequest.line.limit

    لمزيد من المعلومات عن configure -search، يُرجى الاطّلاع على تحديد القيمة الحالية للرمز المميّز

تحديد موقع رمز مميّز

وفي معظم الحالات، يتم تحديد الرموز المميزة التي تحتاج إلى ضبطها في هذا الدليل. ومع ذلك، إذا كنت بحاجة لاستبدال قيمة رمز مميز موجود لست متأكدًا من اسمه الكامل أو موقعه، استخدم grep للبحث في دليل source الخاص بالمكوِّن.

على سبيل المثال، إذا كنت تعلم أنه في إصدار سابق من Edge، قمت بتعيين session.maxAge للسمة وتريد معرفة قيمة الرمز المميّز المستخدمة لإعداده، ثم grep للموقع الإلكتروني في /opt/apigee/edge-ui/source الدليل:

grep -ri "session.maxAge" /opt/apigee/edge-ui/source

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

/opt/apigee/component_name/source/conf/application.conf:property_name={T}token_name{/T}

يوضّح المثال التالي قيمة الرمز المميّز session.maxAge لواجهة المستخدم:

/opt/apigee/edge-ui/source/conf/application.conf:session.maxAge={T}conf_application_session.maxage{/T}

السلسلة بين العلامتَين {T}{/T} هي اسم الرمز المميّز الذي يمكنك ضبطه. في ملف .properties ضمن واجهة المستخدم.

ضبط رمز مميّز يتم التعليق عليه حاليًا

يتم تعليق بعض الرموز المميزة في ملفات إعداد Edge. إذا حاولت ضبط رمز مميز تم التعليق عليه في ملف إعداد تثبيت أو مكون، يتم تجاهل إعدادك.

لتعيين قيمة رمز مميز تم التعليق عليه في ملف تهيئة Edge، استخدم خاص بناء الجملة بالشكل التالي:

conf/filename+propertyName=propertyValue

على سبيل المثال، لضبط السمة المسماة HTTPClient.proxy.host في الرسالة معالِج البيانات، أول grep للموقع لتحديد الرمز المميّز:

grep -ri /opt/apigee/edge-message-processor/ -e "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=myhost.name.com