4.18.05 Edge الخاص بملاحظات الإصدار في السحابة الإلكترونية الخاصة

أنت الآن بصدد الاطّلاع على مستندات Apigee Edge.
انتقِل إلى مستندات Apigee X. info

يوضّح هذا القسم الإصدار 4.18.05 من ميزة Edge for Private Cloud.

ملخّص الإصدار

يلخّص الجدول التالي التغييرات في هذا الإصدار من الميزات:

الميزات الجديدة ○ أصبحت سياسات JWT متاحة للجميع الآن
○ أصبح نظام التشغيل RedHat Enterprise Linux 6.9 متوافقًا الآن
○ أصبح نظام التشغيل Oracle Linux 6.9 متوافقًا الآن
○ أصبح نظام التشغيل CentOS 6.9 متوافقًا الآن
○ تغييرات جديدة في إعدادات تثبيت تجربة Edge
○ يمكن الآن ضبط خيارات إعادة محاولة جهاز التوجيه على مستوى المضيف الظاهري
الإصدارات المضمَّنة
‫○ Edge UI:
   18.04.04
   18.03.02
   18.02.14
   17.11.06 		‫○ Edge Management/Runtime:
   18.04.06
   18.04.04
   18.03.02
   18.02.02
   18.01.05
 ‫○ البوابة:
   18.04.25.01
   18.04.25.00
   18.04.23.00
   18.03.28.00
   18.03.05.00
   18.02.15.00
   18.01.31.00
   17.12.20.00
عمليات إيقاف المنتجات نهائيًا ○ API BaaS
○ لوحة بيانات المراقبة (إصدار تجريبي)
عمليات الإيقاف النهائي ○ استبدال مخازن Apigee الآمنة (المخازن) بمفاتيح وقيم
○ إضافة مسارات إلى علامة التبويب "الأداء" في خادم وكيل واجهة برمجة التطبيقات
○ السمة SMTPSSL لبوابة "خدمات المطوّرين"
إصلاح الأخطاء ○ منع تغيير عنوان البريد الإلكتروني للمستخدم (65550638)
○ ثغرة أمنية في jackson-databind (69711616)
○ تسرُّب الذاكرة في "معالجات الرسائل" (71612599)
المشاكل المعروفة

يتضمّن هذا الإصدار المشاكل المعروفة التالية:

○ عدم احتفاظ نسخة احتياطية من مجموعة الملفات الصحيحة في Message Processor (رقم التعريف 121095148)
○ تعليق طلبات HEAD إلى استهدافات Node.js (رقم التعريف 79993247)
○ ظهور خيار إنشاء خادم وكيل عكسي من خلال Open API (رقم التعريف 79949124)
○ عدم حل أسماء المضيفين (رقم التعريف 79757554)
○ DataAccessExceptions في عمليات الإعداد المتعددة لمراكز البيانات (رقم التعريف 76087166)
○ ظهور رسالة خطأ في الأذونات عند إيقاف apigee-postgresql (رقم التعريف 72379834)
○ سياسة MessageLogging تتضمّن معلومات إضافية في رسالة السجلّ (رقم التعريف 68722102)

لمزيد من المعلومات حول كل من هذه المشاكل المعروفة، بما في ذلك الحلول البديلة، يُرجى الاطّلاع على المشاكل المعروفة.

توضّح الأقسام التالية كل موضوع من هذه المواضيع بالتفصيل.

مسارات الترقية

يوضّح الجدول التالي مسارات الترقية لإصدار الميزة هذا:

من 4.18.01 الترقية مباشرةً من الإصدار 4.18.01 إلى الإصدار 4.18.05
من 4.17.09 الترقية مباشرةً من الإصدار 4.17.09 إلى الإصدار 4.18.05
من 4.17.05 الترقية مباشرةً من الإصدار 4.17.05 إلى الإصدار 4.18.05
من 4.17.01 الترقية من الإصدار 4.17.01 إلى الإصدار 4.18.01، ثم الترقية من الإصدار 4.18.01 إلى الإصدار 4.18.05
من 4.16.09 الترقية من الإصدار 4.16.09 إلى الإصدار 4.18.01، ثم الترقية من الإصدار 4.18.01 إلى الإصدار 4.18.05
من 4.16.05 الترقية من الإصدار 4.16.05 إلى الإصدار 4.18.01، ثم الترقية من الإصدار 4.18.01 إلى الإصدار 4.18.05
من 4.16.01 الترقية من الإصدار 4.16.01 إلى الإصدار 4.18.01، ثم الترقية من الإصدار 4.18.01 إلى الإصدار 4.18.05
الإصدار 4.15.0x والإصدارات الأحدث الترقية من الإصدار 4.15.0x إلى الإصدار 4.16.01، ثم الترقية من الإصدار 4.16.01 إلى الإصدار 4.18.01، ثم الترقية من الإصدار 4.18.01 إلى الإصدار 4.18.05

الميزات الجديدة

يوضّح هذا القسم الميزات الجديدة في هذا الإصدار من Feature Release. بالإضافة إلى هذه الميزات، يتضمّن هذا الإصدار جميع الميزات الواردة في إصدارات Edge UI وEdge Management وPortal المدرَجة في الإصدارات المضمّنة.

بالإضافة إلى التحسينات التالية، يتضمّن هذا الإصدار أيضًا تحسينات متعددة على سهولة الاستخدام والأداء والأمان والثبات.

سياسات JWT

لم تعُد سياسات JWT التالية في مرحلة الإصدار التجريبي، بل أصبحت متاحة للجميع:

البرامج المتوافقة

يتضمّن إصدار الميزة هذا التغييرات التالية على البرامج المتوافقة:

  • أصبحت الإصدارات 6.9 من Red Hat Enterprise Linux (RHEL) متوافقة
  • أصبح نظام التشغيل Oracle Linux 6.9 متوافقًا الآن
  • أصبح نظام التشغيل CentOS 6.9 متوافقًا الآن
  • لم يعُد الإصدار 7.2 من RHEL أو CentOS أو Oracle Linux متوافقًا

لمزيد من المعلومات، يُرجى الاطّلاع على البرامج والإصدارات المتوافقة.

تغييرات في إعدادات تثبيت تجربة Edge الجديدة

يحتوي الإصدار 4.18.05 من تجربة New Edge على تغييرات في ملف الإعداد مقارنةً بالإصدار 4.18.01. يتم وصف الخصائص الجديدة في تغييرات إعدادات التثبيت من Edge 4.18.01.

يمكن الآن ضبط خيارات إعادة المحاولة في جهاز التوجيه على مستوى المضيف الافتراضي

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

لمزيد من المعلومات، يُرجى الاطّلاع على سمات إعداد المضيف الافتراضي.

سمة إحصاءات جديدة وتغيير في السمة x_forwarded_for_ip

تغيّرت الطريقة التي يضبط بها Edge السمة x_forwarded_for_ip في Edge Analytics. في السابق، إذا كانت هناك عناوين IP متعددة في العنوان X-Forwarded-For، كان المقياس x_forwarded_for_ip يحتوي على آخر عنوان IP مُدرَج فقط. كان العملاء يستخدمون السمة x_forwarded_for_ip غالبًا لتحديد عنوان IP الخاص بالعميل الذي يرسل طلب البيانات من واجهة برمجة التطبيقات إلى Edge.

في هذا الإصدار، تحتوي السمة x_forwarded_for_ip الآن على القائمة الكاملة لعناوين IP في العنوان X-Forwarded-For.

تحذير: يمكن أن يتم تزييف العنوان X-Forwarded-For من خلال عنوان IP تم رفض وصوله، باستثناء العنوان الأخير في العنوان، وهو عنوان IP الذي تلقّاه Edge من آخر مصافحة TCP خارجية. لتحديد عنوان IP الأصلي للعميل الذي يرسل طلب بيانات من واجهة برمجة التطبيقات إلى Edge، يضيف هذا الإصدار سمة جديدة إلى Edge Analytics، وهي: ax_resolved_client_ip.

يمكنك الآن استخدام السمة ax_resolved_client_ip في تقرير مخصّص أو في شرط فلتر في تقرير مخصّص لتحديد عنوان IP للعميل الذي يرسل طلب بيانات من واجهة برمجة التطبيقات. اطّلِع على مرجع المقاييس والسمات والفلاتر في "إحصاءات Google" للحصول على مزيد من المعلومات عن السمة ax_resolved_client_ip.

يؤثّر هذا التغيير أيضًا في طريقة تعامل سياسة AccessControl مع العنوان X-Forwarded-For. في هذا الإصدار، يملأ Edge تلقائيًا عنوان HTTP X-Forwarded-For بعنوان IP واحد تلقّاه من آخر مصافحة TCP خارجية (مثل عنوان IP الخاص بالعميل أو جهاز التوجيه). في الإصدارات السابقة، كان Edge يضبط عنوان HTTP X-Forwarded-For باستخدام عنوان IP واحد يتلقّاه من أول عملية مصافحة TCP خارجية (مثل عنوان IP للعميل أو جهاز التوجيه). لمزيد من المعلومات، يمكنك الاطّلاع على لمحة عن عنوان HTTP الذي يتضمّن X-Forwarded-For.

الإصدارات المضمَّنة

منذ الإصدار السابق من ميزات Edge for Private Cloud، تم طرح الإصدارات التالية وهي مضمّنة في هذا الإصدار من الميزات:

واجهة مستخدم Edge إدارة الأجهزة الطرفية/وقت التشغيل بوابة
18.04.04
18.03.02
18.02.14
17.11.06 		18.04.06
18.04.04
18.03.02*
18.02.02
18.01.05
 18.04.25.01
18.04.25.00
18.04.23.00
18.03.28.00
18.03.05.00
18.02.15.00
18.01.31.00
17.12.20.00
* لم يتم تضمين إصلاح الخطأ 74622499 في إصدار Edge for Private Cloud 4.18.05.

انقر على الروابط أعلاه للاطّلاع على إصلاحات الأخطاء والميزات الجديدة من تلك الإصدارات المضمّنة في هذا الإصدار من الميزات.

عمليات الإيقاف

يوضّح هذا القسم الميزات التي تم إيقافها نهائيًا في هذا الإصدار من الميزات.

API BaaS

تم إيقاف خدمة API BaaS نهائيًا. لمزيد من المعلومات، يُرجى الاطّلاع على عمليات إيقاف وإيقاف نهائي وتغييرات في CPS في Apigee.

لوحة بيانات المراقبة (إصدار تجريبي)

تم إيقاف "لوحة بيانات المراقبة" (الإصدار التجريبي) نهائيًا ولن تعود متاحة. نتيجةً لذلك، لم تعُد المكوّنات التالية جزءًا من عملية التثبيت:

  • apigee-influxdb
  • apigee-telegraf
  • apigee-grafana

لمواصلة الحصول على مقاييس الموجه ومعالج الرسائل والعُقد، تنصح Apigee باستخدام JMX لدمج بيانات Edge for Private Cloud مع أدوات المراقبة الخاصة بك. لمزيد من المعلومات، يُرجى الاطّلاع على مقالتَي ما يجب مراقبته وكيفية المراقبة.

إذا كنت تريد ترقية عملية تثبيت حالية إلى الإصدار 4.18.05، عليك إلغاء تثبيت "لوحة بيانات المراقبة". لا تضمن Apigee استمرار عملها على النحو المتوقّع.

الميزات التي سيتم إيقافها نهائيًا

تم إيقاف الميزات التالية نهائيًا في هذا الإصدار من الميزات.

لمزيد من المعلومات، يُرجى الاطّلاع على عمليات إيقاف وإيقاف نهائي وتغييرات في CPS في Apigee.

مخازن Apigee الآمنة (الخزائن)

سيتم إيقاف نهائيًا ميزة "المخزن الآمن" في Apigee، المعروفة أيضًا باسم "الخزائن"، في سبتمبر 2018.

بدلاً من استخدام وحدة التخزين الآمنة، استخدِم خرائط قيم المفاتيح (KVM) المشفرة، كما هو موضّح في مقالة العمل باستخدام خرائط قيم المفاتيح. توفّر آلات KVM المشفّرة مستوى الأمان نفسه الذي توفّره الخزائن، كما أنّها تتيح المزيد من الخيارات لإنشاء المفاتيح واستردادها.

إضافة مسارات في علامة التبويب "الأداء" لخادم وكيل واجهة برمجة التطبيقات

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

تم إيقاف هذه الميزة نهائيًا ولم تعُد متاحة في واجهة المستخدم. للحصول على بديل لهذه الوظيفة، اطّلِع على بديل لواجهة برمجة التطبيقات Business Transactions API.

خاصية SMTPSSL لبوابة "خدمات المطوّرين"

لضبط البروتوكول الذي يستخدمه خادم SMTP المرتبط بالبوابة، عليك الآن استخدام السمة SMTP_PROTOCOL بدلاً من السمة SMTPSSL. القيم الصالحة لـ SMTP_PROTOCOL هي "standard" و"ssl" و "tls".

لمزيد من المعلومات، يُرجى الاطّلاع على تثبيت بوابة "خدمات المطوّرين".

إصلاح الأخطاء

يسرد هذا القسم الأخطاء التي تم إصلاحها في إصدار الميزة هذا من Private Cloud. بالإضافة إلى الأخطاء المذكورة أدناه، يتضمّن هذا الإصدار من الميزات جميع إصلاحات الأخطاء في واجهة مستخدم Edge وEdge Management وإصدارات Portal الموضّحة في الإصدارات المضمّنة.

معرّف المشكلة الوصف
71612599

تسريب الذاكرة في "معالجات الرسائل"

تم إصلاح تسرب في الذاكرة. حدث ذلك في "معالجات الرسائل" عند إيقاف Qpidd.
69711616

ثغرة أمنية في jackson-databind

تم تعديل مكتبة jackson-databind إلى الإصدار 2.7.9.1 لتجنُّب حدوث خلل في إلغاء التسلسل.
65550638

منع تغيير عنوان البريد الإلكتروني للمستخدم

لم يعُد بإمكانك تغيير عنوان البريد الإلكتروني للمستخدم في حمولة الرسالة المُرسَلة إلى واجهة برمجة التطبيقات الإدارية. تمنع واجهة برمجة التطبيقات الإدارية الآن أيضًا استخدام XML في نص الطلب.

المشاكل المعروفة

يسرد الجدول التالي المشاكل المعروفة في هذا الإصدار من الميزة:

معرّف المشكلة الوصف
121095148

عدم احتفاظ "معالج الرسائل" بنسخة احتياطية من مجموعة الملفات الصحيحة

الحلّ البديل:

نفِّذ عملية الاحتفاظ بنسخة احتياطية مرة ثانية، ومن المفترض أن يتم الاحتفاظ بالمجموعة الصحيحة من الملفات.
79993247

تتوقف طلبات HEAD إلى أهداف Node.js

قد تتوقف طلبات HEAD الموجّهة إلى هدف Node.js، ما يؤدي إلى بقاء عمليات الربط في انتظار المراجعة.

الحلّ البديل:

لتجنُّب هذه المشكلة، حدِّد معالجًا لطلبات HEAD من أجل عرض استجابة فارغة بشكلٍ صريح.
79949124

يتم عرض خيار "إنشاء خادم وكيل عكسي" من خلال Open API

يعرض معالج الخادم الوكيل حاليًا خيارًا لإنشاء خادم وكيل جديد من خلال Open API. لا يمكن إجراء ذلك على Edge for the Private Cloud.

الحلّ البديل:

بلا عُري
79757554

تعذُّر مطابقة أسماء المضيفين

بعد تثبيت Edge for Private Cloud أو ترقيته، قد لا يتم تحويل أسماء المضيفين إلى عناوينها.

الحلّ البديل:

لحلّ هذه المشكلة، أعِد تشغيل مكوّن واجهة مستخدم Edge:

/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
76087166

DataAccessException في إعدادات مراكز بيانات متعدّدة

في إعدادات مراكز البيانات المتعددة، إذا أصبح أحد مخازن البيانات غير متاح، قد يظهر لك الخطأ التالي:

DataAccessException: Error while accessing datastore;
Please retry later

ونتيجةً لذلك، قد لا يبدأ تشغيل Management Server لأنّه يحاول الاتصال بعُقد Cassandra في كلّ من dc-1 وdc-2. يحدث الخطأ DataAccessExceptions إذا كانت إحدى عُقد Cassandra غير متاحة. قد يؤدي ذلك أيضًا إلى حدوث انقطاع في عدد الزيارات إلى واجهة برمجة التطبيقات، حيث تعرض "معالجات الرسائل" القيمة DataAccessExceptions أثناء محاولة استرداد خرائط المفاتيح والقيم.

يُرجى العِلم أنّ الحالة المتوقّعة هي عدم اتصال "خادم الإدارة" بمكوّنات مخزن البيانات في مناطق مختلفة.

حل بديل

الحل البديل هو إلغاء تسجيل أنواع عقد Cassandra التالية في مركز البيانات غير المتاح ثم إعادة تسجيلها بعد أن تصبح عقد Cassandra متاحة مرة أخرى:

  • kms-datastore
  • dc-datastore
  • keyvaluemap-datastore

لإلغاء تسجيل أنواع عقد Cassandra هذه وإعادة تسجيلها، اتّبِع الخطوات التالية:

  1. احصل على معرّفات UUID لعُقد Cassandra باستخدام الأمر curl التالي: 
    curl -u ADMIN_EMAIL:ADMIN_PW \
  "http://MS_IP:MS_PORT/v1/servers?region=REGION&pod=GATEWAY_POD \
  &type=CASSANDRA_NODE_TYPE"

    المكان:

    • ADMIN_EMAIL وADMIN_PW هما بيانات اعتماد حسابك على Apigee.
    • MS_IP وMS_PORT هما عنوان IP ورقم المنفذ الخاصان بخادم الإدارة.
    • REGION هو اسم مركز البيانات الذي يقع فيه خادم الإدارة.
    • ‫GATEWAY_POD هو اسم الحزمة، وهو "البوابة" تلقائيًا. مع ذلك، قد تكون أعدت تسميته إلى اسم آخر، لذا راجِع عملية التنفيذ.
    • ‫CASSANDRA_NODE_TYPE هي إحدى القيم kms-datastore وdc-datastore وkeyvaluemap-datastore.

    على سبيل المثال: 

    curl -u nickdanger@google.com:myP@$$w0rD
  "http://192.168.0.1:8080/v1/servers?region=dc-1&pod=gateway&type=dc-datastore"

    يستخدم الردّ التنسيق التالي: 

    {
  "internalIP" : "POD_IP_ADDRESS",
  "isUp" : [true|false],
  "pod" : "GATEWAY_POD",
  "reachable" : [true|false],
  "region" : "dc-1",
  "tags" : {
    "property" : [ ]
  },
  "type" : [ "kms-datastore", "dc-datastore", "keyvaluemap-datastore" ],
    "uUID" : "POD_UUID"
}

    على سبيل المثال: 

    {
  "internalIP" : "192.168.1.11",
  "isUp" : false,
  "pod" : "gateway",
  "reachable" : false,
  "region" : "dc-1",
  "tags" : {
    "property" : [ ]
  },
  "type" : "dc-datastore",
  "uUID" : "13cee956-d3a7-4577-8f0f-1694564179e4"
}

    لاحظ قيم الحقل uUID في الردّ. ستستخدم هذه المعرّفات لإلغاء تسجيل العُقد.

  2. كرِّر الخطوة الأولى لكل نوع من أنواع عقد Cassandra: kms-datastore وdc-datastore وkeyvaluemap-datastore. احرص على تدوين أرقام التعريف الفريدة (UUID) التي يتم عرضها.
  3. ألغِ تسجيل العُقد باستخدام الأمر التالي: 
    curl -u ADMIN_EMAIL:ADMIN_PW "http://MS_IP:MS_PORT/v1/servers/UUID" -X DELETE

    حيث UUID هو المعرّف الفريد العالمي (UUID) الذي تم عرضه في ردّ الأمر السابق.

  4. كرِّر الخطوة 3 لكل معرّف فريد عالمي جمعته في الخطوتَين 1 و2.
  5. أعِد تسجيل العُقد باستخدام الأمر التالي: 
    curl -u ADMIN_EMAIL:ADMIN_PW "http://MS_IP:MS_PORT/v1/servers -d \
  "Type=kms-datastore&Type=dc-datastore&Type=keyvaluemap-datastore& \
  Type=counter-datastore&Type=cache-datastore&InternalIP=POD_IP_ADDRESS& \
  region=REGION&pod=GATEWAY_POD" -H \
  'content-type: application/x-www-form-urlencoded' -X POST

يُرجى العِلم أنّ هذه العمليات تسجّل العُقد وتلغي تسجيلها من Zookeeper، ولا يكون لها أي تأثير على مجموعة Cassandra. لمزيد من المعلومات حول هذه الأوامر، يُرجى الاطّلاع على تعديل عمليات تسجيل مخزن البيانات.
72379834

تظهر رسالة خطأ في الأذونات عند إيقاف apigee-postgresql

عند استخدام الأمر apigee-seriver apigee-postgresql stop لإيقاف apigee-postgresql، قد تظهر لك رسالة تفيد بأنّه لا يمكن تغيير apigee-serive إلى دليل المستخدم الرئيسي، ويمكنك تجاهل هذه الرسالة.

الحلّ البديل:

لا ينطبق
68722102

سياسة MessageLogging تتضمّن معلومات إضافية في رسالة السجلّ

يتحكّم العنصر FormatMessage في سياسة MessageLogging في تنسيق الرسالة المسجّلة. عندما تكون القيمة FormatMessage=false، من المفترض ألا تتضمّن الرسالة المسجّلة أي معلومات من إنشاء Apigee. ومع ذلك، حتى إذا ضبطت FormatMessage=false، ستظل رسالة السجلّ تتضمّن المعلومات التالية:

  • نتيجة الأولوية
  • الطابع الزمني

الحلّ البديل:

بلا عُري

الخطوة التالية

لبدء استخدام Edge for Private Cloud 4.18.05، استخدِم الروابط التالية:

عمليات التثبيت الجديدة:
نظرة عامة على التثبيت الجديدة
عمليات التثبيت الحالية:
الترقية من 4.18.01
الترقية من 4.17.05 أو 4.17.09
الترقية من 4.17.01
الترقية من 4.16.09
الترقية من 4.16.01 أو 4.16.05