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

يتم الآن عرض مستندات Apigee Edge.
انتقِل إلى مستندات Apigee X. المعلومات

يصف هذا القسم الإصدار 4.18.05 من Edge الخاص بإصدار ميزات السحابة الإلكترونية الخاصة.

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

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

الميزات الجديدة ○ سياسات JWT متاحة الآن بشكل عام
○ تمت إتاحة الإصدار 6.9 من RedHat Enterprise Linux الآن
○ يتوفر الآن الإصدار 6.9 من Oracle Linux 6.9
○ الإصدار 6.9 من نظام التشغيل CentOS متاح الآن
تغييرات على إعدادات تثبيت تجربة الإصدار الجديد من Edge
○ يمكنك الآن ضبط خيارات إعادة محاولة جهاز التوجيه على مستوى المضيف الافتراضي
الإصدارات المضمَّنة
○ واجهة مستخدم Edge:
   18.04.04
   18.03.02
   18.02.14
   17.11.06 		○ إدارة Edge/وقت التشغيل:
   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.0018.02.15.0018.01.31.0017.12.20.00
التقاعد ○ BaaS في واجهة برمجة التطبيقات
○ لوحة بيانات التتبُّع (إصدار تجريبي)
الإيقافات ○ تم استبدال متاجر Apigee الآمنة بـ KVMs
○ إضافة المسارات إلى علامة التبويب "أداء الخادم الوكيل لواجهة برمجة التطبيقات"
○ موقع SMTPSSL لبوابة "خدمات المطوّرين"
إصلاح الأخطاء ○ منع تغيير عنوان البريد الإلكتروني للمستخدم (65550638)
○ ثغرة أمنية في jackson-databind (69711616)
○ تسرب الذاكرة في معالجات الرسائل (71612599)
المشاكل المعروفة

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

○ تعمل نسخة احتياطية لمعالج الرسائل على عدم الاحتفاظ بنسخة احتياطية من مجموعة الملفات الصحيحة (121095148)
○ يتم إيقاف طلبات HEAD لاستهداف أهداف Node.js (79993247)
○ يظهر الخيار "إنشاء خادم وكيل عكسي عبر واجهة برمجة التطبيقات Open API"
78 بيانات ضبط الإعدادات الإضافية (121095148)



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

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

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

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

من 4: 18 الترقية مباشرةً من الساعة 4.18.01 ← 4.18.05
من 4:17 الترقية مباشرةً من 4.17.09 ← 4.18.05
من 4:17 الترقية مباشرةً من 4.17.05 ← 4.18.05
من 4:17 الترقية من 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 الترقية من 4.16.05 ← 4.18.01، ثم الترقية من 4.18.01 ← 4.18.05
من 4:16 الترقية من 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.16.01 ← 4.16.01، ثم الترقية من 4.18.01 ← 4.18.05

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

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

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

سياسات JWT

لم تعُد سياسات JWT التالية في المرحلة التجريبية، بل أصبحت الآن تظهر في "إحصاءات Google":

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

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

  • يتوفّر الآن الإصدار 6.9 من Red Hat Enterprise Linux (RHEL)
  • دعم Oracle Linux 6.9 الآن
  • ميزة CentOS 6.9 متوفّرة الآن
  • لم تعد RHEL/CentOS/Oracle Linux 7.2 متوافقة

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

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

يتضمّن الإصدار 4.18.05 من تجربة New Edge تغييرات على ملف الإعداد من الإصدار 4.18.01. ويتم وصف السمات الجديدة في التغييرات التي تطرأ على إعدادات التثبيت من الإصدار 4.18.01 من Edge.

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

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

لمزيد من المعلومات، راجِع سمات ضبط المضيف الافتراضي.

سمة جديدة ضمن "إحصاءات Google" وتغييرات على السمة 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 تلقائيًا عنوان HTTP الذي يتضمّن العنصر X-Forwarded-For بعنوان IP الفردي الذي يتلقّاه من عملية تأكيد اتصال بروتوكول TCP الخارجية الأخيرة (مثل عنوان IP للعميل أو جهاز التوجيه). في الإصدارات السابقة، كان متصفّح Edge يضبط عنوان HTTP X-Forwarded-For باستخدام عنوان IP الفردي الذي يتلقّاه من عملية تأكيد اتصال بروتوكول TCP الخارجية الأول (مثل عنوان IP للعميل أو جهاز التوجيه). لمزيد من المعلومات، يمكنك الاطّلاع على لمحة عن عنوان X-Forwarded-For HTTP.

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

تمّ طرح الإصدارات التالية من إصدار ميزة Edge الخاص بالسحابة الإلكترونية الخاصة منذ أن تم تضمينها في هذا الإصدار:

واجهة مستخدم Edge إدارة 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.0017.12.20.00
* لا يتوفّر إصلاح الخطأ 74622499 في إصدار Edge الخاص بخدمة Private Cloud 4.18.05.

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

التقاعد

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

نظام BaaS لواجهة برمجة التطبيقات

تم إيقاف العمل باستخبارات واجهة برمجة التطبيقات. للحصول على مزيد من المعلومات، يُرجى الاطّلاع على عمليات إيقاف Apigee نهائيًا وحالات التقاعد والتغييرات في مؤسسات شيكاغو التعليمية الحكومية.

لوحة بيانات التتبُّع (إصدار تجريبي)

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

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

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

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

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

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

للحصول على مزيد من المعلومات، يُرجى الاطّلاع على عمليات إيقاف Apigee نهائيًا وحالات التقاعد والتغييرات في مؤسسات شيكاغو التعليمية الحكومية.

متجر Apigee الآمن (المخازن)

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

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

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

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

تم إيقاف هذه الميزة الآن ولم تعُد متوفرة في واجهة المستخدم. للعثور على بديل لهذه الوظيفة، يُرجى الاطّلاع على واجهة برمجة التطبيقات البديلة لمعاملات الأنشطة التجارية.

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

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

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

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

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

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

تسرُّب الذاكرة في معالِجات الرسائل

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

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

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

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

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

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

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

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

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

الحل:

قم بتشغيل النسخة الاحتياطية مرة ثانية وينبغي أن تقوم بعمل نسخة احتياطية من مجموعة الملفات الصحيحة.
79993247

تعليق طلبات HEAD لأهداف Node.js

يمكن تعليق طلبات HEAD لهدف Node.js، مما يترك الاتصالات معلّقة.

الحل:

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

يتم عرض خيار إنشاء وكيل عكسي عبر واجهة برمجة التطبيقات المفتوحة

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

الحل:

بلا عُري
79757554

تعذُّر تحليل أسماء المضيفين

بعد تثبيت أو ترقية Edge لخدمة Private Cloud الخاصة، قد لا يتم ربط أسماء المضيفين بعناوينهم.

الحل:

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

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

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

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

DataAccessException: Error while accessing datastore;
Please retry later

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

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

الحل

الحل البديل هو إلغاء تسجيل أنواع عُقد 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
السابق
4.18.05.01
التالي
4.18.01.02