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

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

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

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

راجِع لمحة عن نظام ترقيم الإصدارات لمعرفة كيف يمكنك تحديد ما إذا كان إصدار معيّن من السحابة الإلكترونية مضمّنًا في إصدارك من 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 Management API. راجِع مقالة استخدام الأداة المساعدة apigee-adminapi.sh.
  • الإعداد الصامت لطبقة المقابس الآمنة (SSL) للمضيف الافتراضي: عند إنشاء مؤسسة أو بيئة، يمكنك الآن تمرير خصائص لإعداد طبقة المقابس الآمنة على مضيف افتراضي. اطّلِع على إعداد مؤسسة.

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

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

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

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

حرف بدل في المسار الأساسي لخادم وكيل واجهة برمجة التطبيقات (واجهة مستخدم 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

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

Cloud 16.03.30

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

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

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

Cloud 16.03.09 UI

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

Cloud 16.03.02

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

‫Cloud 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 (برنامج Name Service Cache Daemon) وتفعيله، قد تلاحظ أنّ &quot;معالجات الرسائل&quot; تجري عمليتَي بحث في نظام أسماء النطاقات: إحداهما للإصدار الرابع من بروتوكول الإنترنت (IPv4) والأخرى للإصدار السادس من بروتوكول الإنترنت (IPv6).

لإيقاف البحث في نظام أسماء النطاقات على الإصدار السادس من بروتوكول الإنترنت (IPv6)، اتّبِع الخطوات التالية:

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

    enable-cache hosts no
PRC-1118

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

إذا شغّلت الأمر "apigee-service apigee-postgresql pg-data-purge" وظهر لك خطأ بالشكل التالي:

ERROR: must be owner of relation

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

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

حِملات 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
السابق
4.16.05.01
التالي
16.01.08