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

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

أصدرنا في يوم الثلاثاء 31 أيار (مايو) 2016 إصدارًا جديدًا من Apigee Edge لـ Private Cloud.

منذ إصدار ميزة Edge الخاصة بميزة "السحابة الإلكترونية الخاصة" السابق (4.16.01)، تم تضمين الإصدارات التالية في إصدار الميزة هذا:

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

الميزات والتحسينات الجديدة

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

لمعرفة مزيد من التفاصيل والتعليمات، يُرجى الاطّلاع على مستندات Edge for Private Cloud.

تم نقل أدلة التثبيت والعمليات إلى الإنترنت

يمكنك الآن الوصول إلى دليل العمليات وتثبيت متصفِّح Edge الخاص باستخدام السحابة الإلكترونية الخاصة من خلال الإصدار 4.18.01.

تحديثات البرامج

يتم تضمين تحديثات البرامج التالية في الإصدار:

  • Java JDK 1.8 - لتحقيق الاستفادة من أحدث ميزات Java، هذا الإصدار متوافق مع Java 1.8. يجب توفّر Oracle JDK 1.8 أو OpenJDK 8 في بيئتك.
    كجزء من عملية التحديث إلى Java 8، لم تعد بعض رموز TLS متوفرة في Oracle JDK 1.8. للحصول على القائمة الكاملة، يُرجى الاطّلاع على القسم "مجموعات الرموز غير المفعّلة التلقائية" http://docs.oracle.com/javase/8/docs/technotes/guides/security/SunProviders.html.
  • Cassandra 2.1.13: تم التعديل من الإصدار Cassandra 2.0.15.

التثبيت والترقية والتراجع

في ما يلي قائمة بالتغييرات التي طرأت على التثبيت والترقية والنصوص البرمجية ذات الصلة. وللحصول على معلومات حول الاستخدام، يُرجى الاطّلاع على مستندات Edge for Private Cloud.

  • عملية جديدة لتحديث الإصدار 4.16.01: يحلّ هذا الإصدار محلّ الأداة apigee-migrate المساعدة update.sh لتحديث التثبيت من 4.16.01 إلى 4.16.05. راجِع تحديث Apigee Edge 4.16.01 إلى 4.16.05.
  • شريط التمهيد
    • أصبح bootstrap.sh (الإصدار 4.16.01) الآن bootstrap_4.16.05.sh في 4.16.05.
    • لم تعد بحاجة إلى تحديد uname:pword لتنزيل bootstrap_4.16.05.sh.
  • العودة إلى الإصدار السابق: للتراجع عن تحديث إلى 4.16.05، يجب إلغاء تثبيت الإصدار 4.16.05 من المكوِّن وإعادة تثبيت الإصدار السابق. تمت إزالة أداة rollback.sh السابقة. يُرجى الاطّلاع على عملية العودة إلى الإصدار السابق 4.16.05.
  • يستطيع setup.sh وupdate.sh كتابة ملف السجلّ إلى /tmp - بشكل تلقائي، بإمكان الأداتين setup.sh وupdate.sh كتابة معلومات السجلّ إلى /opt/apigee/var/log/apigee-setup. إذا كان المستخدم الذي يشغّل الأداة لا يملك إذن الوصول إلى هذا الدليل، سيكتب السجلّ في الدليل /tmp. إذا لم يكن لدى المستخدم إذن الوصول إلى /tmp، سيتعذّر تشغيل الأداة المساعدة.
  • إجراء تحديث BaaS لواجهة برمجة التطبيقات: في الإصدار 4.16.01، كان عليك إعادة تثبيت BaaS لواجهة برمجة التطبيقات لنقلها. تتيح أداة update.sh الجديدة تحديث BaaS لواجهة برمجة التطبيقات. راجِع تحديث Apigee Edge 4.16.01 إلى 4.16.05.

الإدارة

في ما يلي الميزات الجديدة لإدارة Private Cloud وضبطها.

  • التحقق من صحة التثبيت - يمكن الآن تشغيل الأداة apigee-validate المستخدمة لاختبار تثبيت Edge Private Cloud من خادم الإدارة. في السابق، كان يجب تشغيل النص البرمجي على معالج الرسائل. يمكنك الاطّلاع على قسم اختبار التثبيت.
  • اسم المنطقة - يمكن أن يكون اسم المنطقة بأي اسم. وفي الإصدارات السابقة، كان الاسم بالتنسيق "dc-#"، حيث كانت # قيمة عدد صحيح.
  • لوحات المدخل - يمكن أن تحمل مجموعات البوابة أي اسم. في الإصدارات السابقة، كان يجب تسمية المجموعة المتسلسلة باسم "البوابة".
  • الإدارة المستندة إلى النص البرمجي: تتيح لك أداة سطر أوامر apigee-adminapi.sh الجديدة إمكانية تنفيذ مهام إعداد Edge نفسها التي تنفّذها من خلال إجراء اتصالات بواجهة برمجة تطبيقات إدارة Edge. راجِع استخدام الأداة apigee-adminapi.sh.
  • الإعداد الصامت لطبقة المقابس الآمنة للمضيف الافتراضي: عند إنشاء مؤسسة أو بيئة، يمكنك الآن ضبط الخصائص لضبط طبقة المقابس الآمنة على مضيف افتراضي. يُرجى الاطّلاع على القسم منح إمكانيّة الوصول إلى مؤسسة.

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

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

بادئة ذات طول ثابت لتسجيل رسائل سجلّ النظام (Cloud 16.03.30)

تشتمل سياسة تسجيل الرسائل على عنصر <FormatMessage> جديد في إعداد سجل النظام. ومن خلال ضبط <FormatMessage>true</FormatMessage>، تبدأ رسائل سجلّ النظام بعدد ثابت من الأحرف، ما يتيح لك فلترة البيانات التي تم إدراجها في Apigee. لمزيد من المعلومات، يُرجى الاطّلاع على سياسة تسجيل الرسائل. (APIRT-1398)

حرف بدل في المسار الأساسي للخادم الوكيل لواجهة برمجة التطبيقات (واجهة مستخدم Cloud 16.03.09)

تتيح واجهة مستخدم الإدارة استخدام حرف بدل /*/ واحد أو أكثر في المسارات الأساسية للخادم الوكيل لواجهة برمجة التطبيقات. على سبيل المثال، يتيح المسار الأساسي في /team/*/members للعملاء الاتصال بالخادم الوكيل باستخدام https://[host]/team/blue/members أو https://[host]/team/green/members بدون الحاجة إلى إنشاء خادم وكيل جديد لدعم الفِرق الجديدة. لا يُسمح باستخدام /**/. (MGMT-3154)

تسلسل الخادم الوكيل لواجهة برمجة التطبيقات (Cloud 16.03.02 وCloud 16.03.09 UI)

يتوافق متصفّح Edge مع تسلسل الخادم الوكيل لواجهة برمجة التطبيقات المحلي، ما يسمح لخادم وكيل لواجهة برمجة التطبيقات بالاتصال بخادم وكيل آخر لواجهة برمجة التطبيقات تم نشره في مؤسسة Edge بدون استخدام أي أعباء إضافية للشبكة. في السابق، كانت سلسلة الخادم الوكيل لواجهة برمجة التطبيقات تتطلب استدعاء http(s) إلى خادم وكيل آخر لواجهة برمجة التطبيقات كان يعيد توجيه الطلب من خلال جهاز موازنة الحمل وجهاز توجيه ومعالج رسائل.

تتوفر عناصر LocalTargetConnection جديدة في TargetEndpoint لخادم وكيل واجهة برمجة التطبيقات، ما يسمح لك بتحديد اسم خادم وكيل لواجهة برمجة التطبيقات، أو اسم ProxyEndpoint معيّن ضمن خادم وكيل لواجهة برمجة التطبيقات، أو ببساطة المسار الأساسي لمورد وكيل واجهة برمجة تطبيقات محلي (مثل /v1/myresource). توفّر واجهة مستخدم محرِّر الخادم الوكيل أيضًا هذه الخيارات عند إضافة ميزة TargetEndpoint أو تعديلها.

تتوفّر تسلسل الخادم الوكيل أيضًا في سياسات "وسائل شرح الخدمة".

لمزيد من المعلومات، يُرجى الاطّلاع على الخوادم الوكيلة لـ Chaining API معًا. يتم أيضًا إدراج عناصر LocalTargetConnection الجديدة في مخطّط XML هنا: https://github.com/apigee/api-platform-samples/blob/master/schemas/configuration/configuration_schemas.xsd. (MGMT-3049، MGMT-3050)

الأخطاء التي تم إصلاحها

تم إصلاح الأخطاء التالية في هذا الإصدار. هذه القائمة مخصَّصة في المقام الأول للمستخدمين الذين يتحققون مما إذا كانت طلبات الدعم الخاصة بهم قد تم إصلاحها. وهي غير مصمَّمة لتوفير معلومات مفصّلة لجميع المستخدمين.

Edge لـ Private Cloud 4.16.05

معرّف المشكلة الوصف
PRC-770 تعذّر على أداة التثبيت 16.01 تسجيل خادم وضع الاستعداد Postgres في axgroup
PRC-758 يمكن للمستخدم الذي لديه دور "المستخدم" تعديل التقارير المخصّصة
PRC-883 يتعذَّر إجراء تحديث على خادم Postgres باستخدام إعداد الاستعداد الرئيسي

السحابة الإلكترونية 16.03.30

معرّف المشكلة الوصف
SECENG-584 تؤدي عملية التحقّق من صحة السطر الجديد بين الشهادات في سلسلة الشهادات إلى حدوث مشاكل في بعض الشهادات في مرحلة الإنتاج
MGMT-3217 تعذُّر طلبات البيانات من واجهة برمجة التطبيقات للإدارة في حال انتهاء اسم KVMap بـ "المفاتيح"
MGMT-3214 قد يحدث تعارض بين الفئات أثناء استخدام JavaCallouts، ما يؤدي إلى تعذُّر رمز Java الخاص بالعميل
MGMT-3185 حدث خطأ أثناء إضافة مسؤولي المؤسسة إلى مؤسسة
EDGEUI-127 الحصول على أذونات غير كافية باستخدام محرّر الخادم الوكيل الجديد
EDGEUI-119 مشكلة انتهاء مهلة جلسة واجهة المستخدم
CORESERV-671 ظهور أخطاء "لم يتم ضبط أي حلقات، لذا يتعذّر إعداد خدمة cps"
AXAPP-2345 مشكلة في إدراج تقارير AX المخصّصة للعملاء الذين لا يستخدمون خدمة cps
AXAPP-2302 ملخّص "إحصاءات Apigee" اليومي لا يعرض البيانات التي يطبّقها المطوّرون
APIRT-2750 حالات تعذُّر حركة المرور في مؤسسة معيّنة
APIRT-2516 تحدِّد أخطاء وقت التشغيل في وسائل الشرح باستخدام JavaScript أرقام أسطر غير صحيحة.
APIRT-2508 خطأ في الخروج عند استدعاء الاستماع السريع ضمن معاودة الاتصال في Vault
APIRT-2336 مشكلة في Gzip مع Node.js
APIRT-1975 إعدادات القناع لا تعمل في عنصر message.content

واجهة مستخدم Cloud 16.03.16

معرّف المشكلة الوصف
MGMT-3142 عدم تحميل الرسوم البيانية على لوحة بيانات تحليل الأخطاء (إصلاح محدّث)

واجهة المستخدم في Cloud 16.03.09

معرّف المشكلة الوصف
MGMT-3158 أذونات غير كافية في واجهة المستخدم عند ضبط RBAC على الخوادم الوكيلة الفردية من خلال واجهة برمجة التطبيقات
MGMT-3142 تعذُّر تحميل الرسوم البيانية في لوحة بيانات تحليل الأخطاء
MGMT-3118 تعرض واجهة المستخدم إعدادات غير صحيحة للمضيف الافتراضي لطبقة المقابس الآمنة للمَعلمة "clientAuthEnabled".
DEVRT-2344 لا تؤدي تعريفات تقارير اليوم الواحد إلى تحميل المعاملات في واجهة المستخدم

السحابة الإلكترونية 16.03.02

معرّف المشكلة الوصف
MGMT-3083 التحديث التلقائي لسجلات Node.js يكون مطول جدًا مع رسائل السجل
DEVRT-2275 تعرض خطط معدّلات السمات المخصّصة 5 سمات فقط بدلاً من السمات العشر المسموح بها.
DEVRT-1275 لا يتم عرض بعض المطوّرين في القائمة المنسدلة لخطة الأسعار
DEVRT-1074 مطوّر البرامج ذو الدفع المسبق الذي لا يملك رصيدًا بقيمة تساوي NullpointerException عند إضافة الرصيد

السحابة الإلكترونية 16.02.17

معرّف المشكلة الوصف
MGMT-3083 التحديث التلقائي لسجلات Node.js يكون مطول جدًا مع رسائل السجل
MGMT-3077 إنشاء واجهة المستخدم حزمة خادم وكيل غير صالحة من WSDL الذي يستخدم مساحة الاسم التلقائية
MGMT-1642 لا يتضمّن الدور المخصّص للمستخدم إذن "الحصول على" تطبيقات المطوّرين

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

يحتوي هذا الإصدار على المشاكل المعروفة التالية.

معرّف المشكلة الوصف
APIRT-2978

تعذّر تشغيل جهاز التوجيه Nginx أو تعذّر تشغيل جهاز التوجيه

إذا تعذّر على جهاز Edge Router في بدء تشغيل Nginx أو تعذّر بدؤه على الإطلاق، كما هو موضّح في الملف /opt/apigee/var/log/edge-router/logs/system.log، احذف جميع الملفات في الدليل /opt/nginx/conf.d، وأعِد تشغيل جهاز التوجيه:

> rm -f /opt/nginx/conf.d/*
> /opt/apigee/apigee-service/bin/apigee-service edge-router restart
APIRT-3364

يُجري "معالج الرسائل" بحث نظام أسماء النطاقات على IPv4 وIPv6

إذا كنت قد ثبَّتّ وفعّلت برنامج NSCD (الخفي لذاكرة التخزين المؤقت لخدمة الأسماء)، قد تلاحظ أنّ معالِجات الرسائل تُجري عمليتَي بحث لنظام أسماء النطاقات: أحدهما لبروتوكول IPv4 والآخر للبروتوكول IPv6.

لإيقاف بحث نظام أسماء النطاقات على IPv6:

  1. في كل عقدة من عُقد معالج الرسائل، عدِّل /etc/nscd.conf.
  2. اضبط السمة التالية:

    enable-cache domains no
PRC-1118

حدث خطأ عند تشغيل الأمر "apigee-service apigee-postgresql pg-data-purge"

في حال شغّلت الأمر "apigee-service apigee-postgresql pg-data-purge" وظهرت لك رسالة خطأ في النموذج:

خطأ: يجب أن يكون مالك العلاقة

عدِّل /opt/apigee/apigee-postgresql-4.16.05-0.0.894/lib/actions/pg-data-purge واضبط السمة التالية على "apigee":

POSTGRES_USER=apigee
DOC-1687 بسبب وجود تعارض معروف في التبعية للحزمة، لن يتم تثبيت وكيل Katello المستخدَم في خادم قَمى القمر 6 بشكل صحيح على مضيفي Apigee Edge الذين يشغّلون البرنامج الخفي Qpid.

الحمولات الأساسية بتنسيق JSON في سياسات "إسناد الرسائل" و"وسائل الشرح في Java" و"رفع المستوى"

تسمح لك سياسات "تعيين الرسالة" و"وسيلة شرح Java" و"رفع الأخطاء" بإنشاء محتوى رسالة باستخدام العنصر <Set><Payload>. وكجزء من هذه الرسائل، يمكنك تضمين متغيّرات تتم تعبئة قيمها تلقائيًا في وقت التشغيل. على سبيل المثال، إذا كنت تريد عرض التاريخ من عنوان HTTP، يمكنك إدراج {message.header.date} في رسالتك.

إذا كان تنسيق الرسالة هو JSON، ستبدو على النحو التالي:

{"The date is: " : "{message.header.date}"}

ومع ذلك، يمكنك ملاحظة أنّ تنسيق JSON هذا تمت صياغته بشكل غير صحيح. لحلّ هذه المشكلة، أمامك خياران:

  • اهرب من القوس الافتتاح المعقوف باستخدام الشرطة المائلة للخلف: 
    \{"The date is: " : "{message.header.date}"}
  • في إعداد عنصر حمولة البيانات، استخدِم السمتَين variablePrefix وvariableSuffix للإشارة إلى متغيّر في حمولة JSON. مثلاً:
    <Payload contentType="application/json" variablePrefix="#" variableSuffix="%">{"The date is: " : "#message.header.date%"}</Payload>

في الإصدار التالي من Edge for Private Cloud Feature Cloud ، ستتمكن من استخدام الأقواس المعقوفة للمتغيرات في رسائل JSON بدون مشكلة. (APIRT-1160)

تعذُّر تشغيل جهاز التوجيه (Nginx) أو تعذّر تشغيل جهاز التوجيه

إذا تعذّر على جهاز Edge Router في بدء تشغيل Nginx أو تعذّر بدؤه على الإطلاق، كما هو موضّح في الملف /opt/apigee/var/log/edge-router/logs/system.log، احذف جميع الملفات في الدليل /opt/nginx/conf.d، وأعِد تشغيل جهاز التوجيه:

> rm -f /opt/nginx/conf.d/*
> /opt/apigee/apigee-service/bin/apigee-service edge-router restart
السابق
4.16.05.01
التالي
4.16.01.08