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

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

في يوم الثلاثاء الموافق 31 مايو 2016، أطلقنا إصدارًا جديدًا من Apigee Edge Private Cloud.

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

• السحابة الإلكترونية: 16.02.17 و16.03.02 و16.03.09 (واجهة المستخدم) و16.03.16 (واجهة المستخدم) و16.03.23 (واجهة المستخدم) و16.03.30

راجِع مقالة لمحة عن ترقيم الإصدارات لمعرفة كيف يمكنك تحديد ما إذا كان إصدار معيّن من السحابة الإلكترونية مضمّنًا في إصدارك من Edge for Private Cloud.

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

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

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

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

يمكنك الآن الوصول إلى دليل "تثبيت وتشغيل Edge for Private Cloud" على الإصدار 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
  • أصبح 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، ستتعذّر الأداة.
• إجراء تعديل API BaaS: في الإصدار 4.16.01، كان عليك إعادة تثبيت API BaaS لنقل البيانات. تتيح أداة update.sh المساعدة الجديدة تعديل واجهة برمجة التطبيقات BaaS في مكانها. راجِع تحديث Apigee Edge من الإصدار 4.16.01 إلى الإصدار 4.16.05.

الإدارة

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

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

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

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

بادئة ثابتة الطول لتسجيل رسائل syslog (الإصدار 16.03.30 من Cloud)

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

حرف بدل في Base Path لخادم وكيل API (واجهة مستخدم Cloud 16.03.09)

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

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

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

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

تتوفّر أيضًا ميزة ربط الخوادم الوكيلة في سياسات "استدعاء الخدمة".

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

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

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

Edge for Private Cloud 4.16.05

Cloud 16.03.30

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

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

Cloud 16.03.02

Cloud 16.02.17

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

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

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

حِملات JSON في سياسات Assign Message وJava Callout وRaise Fault

تتيح سياسات "تعيين الرسالة" و"استدعاء 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، ستتمكّن من استخدام الأقواس المعقوفة للمتغيرات في رسائل 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