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

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

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

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

يلخّص الجدول التالي التغييرات التي تم إجراؤها على إصدار الميزات هذا:

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

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

○ عملية النسخ الاحتياطي لمعالج الرسائل لا تحتفظ بنسخة احتياطية من مجموعة الملفات الصحيحة (121095148)
○ هناك HEAD طلبات إلى أهداف Node.js معلّقة (79993247)
○ يتم عرض خيار "إنشاء خادم وكيل عكسي عبر واجهة برمجة التطبيقات المفتوحة" (79949124)
○ أسماء المضيفين لا يتم تحليلها (79757554)
○ DataAccessExceptions في تكوينات مراكز بيانات متعددة (76087166)
○ تظهر رسالة خطأ الإذن عند إيقاف apigee-postgresql (72379834)
○ سياسة تسجيل الرسائل التي تتضمن معلومات إضافية في رسالة السجل (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 وEdge Management و Portal المدرجة في الإصدارات المضمَّنة:

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

سياسات JWT

سياسات JWT التالية لم تعد في المرحلة التجريبية، وأصبحوا الآن GA:

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

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

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

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

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

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

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

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

لمزيد من المعلومات، يُرجى مراجعة فعالية افتراضية خصائص إعداد المضيف.

سمة "إحصاءات 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.

تحذير: يُحتمَل أن يتم انتحال عنوان IP الخاص بالعنوان X-Forwarded-For، وبالتالي تم حظر وصوله. باستثناء العنوان الأخير في الرأس، وهو عنوان 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 for Private Cloud Feature، تم إطلاق الإصدارات التالية وتم تضمينهم في إصدار الميزة هذا:

واجهة مستخدم 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.

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

التقاعد

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

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

تمت إزالة BaaS من واجهة برمجة التطبيقات. لمزيد من المعلومات، يُرجى مراجعة عمليات إيقاف Apigee نهائيًا وعمليات التقاعد والتغييرات في خدمات المنصة الأساسية:

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

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

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

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

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

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

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

لمزيد من المعلومات، يُرجى مراجعة عمليات إيقاف Apigee نهائيًا وعمليات التقاعد والتغييرات في خدمات المنصة الأساسية:

متجر Apigee Secure (مخازن)

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

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

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

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

تم إيقاف هذه الميزة الآن، وهي غير متاحة. متاحة الآن في واجهة المستخدم. للحصول على بديل لهذه الوظيفة، يمكنك الاطّلاع على بديل لواجهة برمجة تطبيقات المعاملات التجارية.

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

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

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

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

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

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

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

تم إصلاح تسرّب الذاكرة. وقد تم إنشاؤه في "معالجات الرسائل" عندما كان Qpidd تَوَقَّفْنَا.
69711616

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

وقد تم تحديث مكتبة جاكسون للبيانات إلى الإصدار 2.7.9.1 لمنع عيب في إزالة الأقمار الصناعية.
65550638

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

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

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

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

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

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

الحل:

شغِّل عملية النسخ الاحتياطي مرة ثانية وسيتم إجراء نسخ احتياطي لمجموعة الملفات الصحيحة.
79993247

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

يمكن أن تعلّق طلبات الرأس إلى هدف Node.js، ما يترك الاتصالات في انتظار المراجعة.

الحل:

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

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

يعرض معالج الخادم الوكيل حاليًا خيارًا لإنشاء خادم وكيل جديد عبر واجهة برمجة تطبيقات مفتوحة. ولا يمكن تنفيذ ذلك على 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

والنتيجة هي أنه قد لا يبدأ "خادم الإدارة" لأنه يحاول الاتصال بـ "كاساندرا". في كل من dc-1 وdc-2. وتحدث DataAccessExceptions إذا كانت عقدة كاساندرا إلى الأسفل. وقد يؤدي ذلك أيضًا إلى حدوث خلل في حركة بيانات واجهة برمجة التطبيقات، حيث يتم عرض تقرير "معالجي الرسائل". 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 تأكد من تدوين أرقام التعريف الفريدة العالمية التي يتم عرضها.
  3. إلغاء تسجيل العُقد باستخدام الأمر التالي: 
    curl -u ADMIN_EMAIL:ADMIN_PW "http://MS_IP:MS_PORT/v1/servers/UUID" -X DELETE

    يشير الرمز 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 ولا تحتوي على أي على المجموعة العنقودية كاساندرا. لمزيد من المعلومات حول هذه الأوامر، يمكنك الاطّلاع على تحديث عمليات تسجيل تخزين البيانات.
72379834

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

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

الحل:

لا ينطبق
68722102

سياسة تسجيل الرسائل النصية، بما في ذلك المعلومات الإضافية في رسالة السجلّ

يتحكّم العنصر 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
التالي
18.01.02