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

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

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

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

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

الميزات الجديدة ○ أصبحت سياسات JWT متاحة للجميع الآن
○ أصبح الإصدار 6.9 من RedHat Enterprise Linux متوافقًا الآن
○ أصبح الإصدار 6.9 من Oracle Linux متوافقًا الآن
○ أصبح الإصدار 6.9 من CentOS متوافقًا الآن
○ تغييرات جديدة في إعدادات تثبيت تجربة 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
 ‫○ Portal:
   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 الآمنة (المخازن) بخرائط القيمة الرئيسية (KVM)
○ إضافة مسارات إلى علامة التبويب "الأداء" في خادم وكيل واجهة برمجة التطبيقات
○ السمة SMTPSSL لبوابة Developer Services
إصلاح الأخطاء ○ منع تغيير عنوان البريد الإلكتروني للمستخدم (65550638)
○ ثغرة أمنية في jackson-databind (69711616)
○ تسرُّب الذاكرة في "معالجات الرسائل" (71612599)
المشاكل المعروفة

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

○ عدم احتفاظ نسخة احتياطية من "معالج الرسائل" بمجموعة الملفات الصحيحة (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

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

يوضّح هذا القسم الميزات الجديدة في هذا الإصدار. بالإضافة إلى هذه الميزات، يتضمّن هذا الإصدار جميع الميزات في إصدارات 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": ax_resolved_client_ip.

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

يؤثّر هذا التغيير أيضًا في طريقة تعامل سياسة AccessControl مع العنوان X-Forwarded-For. في هذا الإصدار، يملأ Edge تلقائيًا عنوان X-Forwarded-For HTTP بعنوان 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
* لا يتضمّن إصدار Edge for Private Cloud 4.18.05 إصلاح الخطأ 74622499.

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

عمليات الإزالة

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

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 secure store، المعروفة أيضًا باسم "الخزائن"، نهائيًا في أيلول (سبتمبر) 2018.

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

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

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

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

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

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

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

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

يسرد هذا القسم الأخطاء التي تم إصلاحها في إصدار الميزة هذا في "السحابة الإلكترونية الخاصة". بالإضافة إلى الأخطاء المدرَجة أدناه، يتضمّن هذا الإصدار من الميزات جميع إصلاحات الأخطاء في إصدارات Edge UI و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 للسحابة الإلكترونية الخاصة.

الحل:

بلا عُري
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

والنتيجة هي أنّه قد لا يبدأ خادم الإدارة لأنّه يحاول الاتصال بعُقد 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 هو اسم الحزمة، وهو "gateway" تلقائيًا. مع ذلك، قد تكون أعدت تسميته إلى اسم آخر، لذا راجِع عملية التنفيذ.
    • 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 لكل معرّف فريد عالمي (UUID) جمعته في الخطوتَين 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