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

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

يوضّح هذا القسم الإصدار 4.19.01 من Edge for Private Cloud Feature Release.

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

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

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

يتضمّن هذا الإصدار الميزات الجديدة التالية:

○ الإصدار المتاح للجميع من واجهة مستخدم Edge
○ الإصدار المتاح للجميع من ميزة تحقيق الربح في واجهة مستخدم Edge
○ إضافة خدمات المراقبة والإصلاح الذاتي في apigee-monit
○ تتضمّن واجهة مستخدم Edge خصائص جديدة لإعداد TLS
○ يمكنك الآن إنشاء مضيفات افتراضية وتعديلها وحذفها في واجهة مستخدم Edge
○ تمت إضافة إمكانية التوافق مع الإصدار 3 من مواصفات OpenAPI
○ أصبح نظاما التشغيل RedHat Enterprise Linux (RHEL) وCentOS 7.6 متوافقَين الآن
○ أصبح نظام التشغيل Oracle Linux 7.5 متوافقًا الآن

لمزيد من المعلومات عن كلّ من هذه الميزات الجديدة، يُرجى الاطّلاع على الميزات الجديدة.
الإصدارات المضمّنة

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

‫○ Edge:
   18.06.08
   18.06.06
   18.05.21
   18.05.10
   18.05.09
   18.04.23.00 		‫○ البوابة:
   18.11.28.00
   18.10.17.00
   18.10.09.00
   18.07.16.00
عمليات الإزالة بلا
الميزات التي سيتم إيقافها نهائيًا لم يعُد الإصدار 4.17.09 من Apigee Edge for Private Cloud متاحًا (تم إيقافه نهائيًا).

لمزيد من المعلومات، يُرجى الاطّلاع على عمليات إيقاف وإيقاف نهائي وتغييرات في CPS في Apigee.
إصلاح الأخطاء

يتضمّن هذا الإصدار إصلاحات الأخطاء التالية:

○ لم يتم إيقاف Zookeeper بواسطة نص برمجي احتياطي (122694069)
○ تمت إضافة صفحة مقصودة بعنوان "لا توجد مؤسسات" (120993451)
○ حذف التقارير المخصّصة (120682369)
○ علامة التبويب "الخريطة الجغرافية" في تجربة New Edge (120681592)
○ خيارات Zookeeper JVM (120624977)
○ حدثت أخطاء غير محدّدة في تلميحات الأدوات (80187407)
○ إنشاء خوادم وكيل عكسي من خلال OpenAPI (79949124)
○ عدم إرسال الروابط عند إعادة ضبط كلمات المرور (77515655)
○ عناوين غير صحيحة لروابط إعادة ضبط كلمة المرور (72799769)
○ استخدام WSDL لإنشاء خوادم وكيل لواجهة برمجة التطبيقات (69550284)

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

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

○ تنسيق ملف البيانات الوصفية لتثبيت apigee-sso (‫135616498)
○ apigee-monit غير متوافق مع Amazon Linux 1 (‫122370980)
○ لا يتم الاحتفاظ بنسخة احتياطية من مجموعة الملفات الصحيحة عند الاحتفاظ بنسخة احتياطية من "معالج الرسائل" (‫121095148)
○ عدم إبطال رموز الجلسة (‫115278838)
○ عدم عمل عمليات Cassandra عند تفعيل مصادقة JMX (‫113342838)
○ تعليق طلبات HEAD إلى أهداف Node.js (‫79993247)
○ عدم حلّ أسماء المضيفين (‫79757554)
○ DataAccessExceptions في إعدادات مراكز البيانات المتعددة (‫76087166)
○ سياسة MessageLogging تتضمّن معلومات إضافية في رسالة السجلّ (‫68722102)
○ تعذُّر إعادة ضبط كلمة مرور مشرف النظام (‫65737520)

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

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

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

من 4.18.05 الترقية مباشرةً من الإصدار 4.18.05 إلى الإصدار 4.19.01
من 4.18.01 الترقية مباشرةً من الإصدار 4.18.01 إلى الإصدار 4.19.01
من 4.17.09 الترقية مباشرةً من الإصدار 4.17.09 إلى الإصدار 4.19.01
الإصدار 4.17.05 والإصدارات الأحدث الترقية من الإصدار 4.17.05 إلى الإصدار 4.18.01، ثم الترقية من الإصدار 4.18.01 إلى الإصدار 4.19.01
بدءًا من الإصدار 4.17.01 الترقية من الإصدار 4.17.01 إلى الإصدار 4.18.01، ثم الترقية من الإصدار 4.18.01 إلى الإصدار 4.19.01
من 4.16.09 الترقية من الإصدار 4.16.09 إلى الإصدار 4.18.01، ثم الترقية من الإصدار 4.18.01 إلى الإصدار 4.19.01
بدءًا من 4.16.05 الترقية من الإصدار 4.16.05 إلى الإصدار 4.18.01، ثم الترقية من الإصدار 4.18.01 إلى الإصدار 4.19.01
الإصدار 4.16.01 والإصدارات الأحدث الترقية من الإصدار 4.16.01 إلى الإصدار 4.18.01، ثم الترقية من الإصدار 4.18.01 إلى الإصدار 4.19.01
الإصدار 4.15.0x والإصدارات الأحدث الترقية من الإصدار 4.15.0x إلى الإصدار 4.16.01، ثم الترقية من الترقية من الإصدار 4.16.01 إلى الإصدار 4.18.01، ثم الترقية من الإصدار 4.18.01 إلى الإصدار 4.19.01

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

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

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

الإصدار المتوفّر للجمهور العام (GA) من واجهة مستخدم Edge

واجهة مستخدم Apigee Edge هي أحدث خدمة واجهة مستخدم للإدارة. كانت هذه الميزة متوفّرة سابقًا في إصدار تجريبي. في الإصدار 4.19.01 من Apigee Edge Private Cloud، أصبحت واجهة مستخدم Edge جزءًا من الإصدار العام.

لاستخدام واجهة مستخدم Edge، يجب تفعيل SAML ثم تثبيت واجهة مستخدم Edge على عقدتها الخاصة.

لمزيد من المعلومات، يُرجى الاطّلاع على واجهة مستخدم Edge لـ Private Cloud.

إصدار ميزة "تحقيق الربح" في واجهة مستخدم Edge المتوفّرة للجمهور العام

يتوفّر الآن الإصدار المتاح للجميع من ميزة "تحقيق الربح" في واجهة مستخدم تجربة Edge الجديدة.

يمكنك الآن إدارة جميع مهام تحقيق الربح في Apigee Edge for Private Cloud من خلال واجهة مستخدم New Edge، بما في ذلك ما يلي:

بموجب هذا الإعلان، تم إيقاف تقارير تباين تحقيق الربح نهائيًا. راجِع عمليات إيقاف Apigee.

تضيف apigee-monit خدمات الإصلاح الذاتي والمراقبة

يتضمّن إصدار Apigee Edge Private Cloud الآن apigee-monit، وهي أداة تستند إلى الأداة المساعدة monit المفتوحة المصدر. تطلب apigee-monit من خدمات Edge بشكل دوري، وإذا كانت إحدى الخدمات غير متاحة، تحاول apigee-monit إعادة تشغيلها.

للحصول على معلومات حول تثبيت apigee-monit وإعداده واستخدامه، يُرجى الاطّلاع على الإصلاح الذاتي باستخدام apigee-monit.

خصائص إعدادات بروتوكول أمان طبقة النقل (TLS) الجديدة

تتيح واجهة مستخدم Edge خصائص إعدادات جديدة لبروتوكول TLS يمكنك استخدامها لضبط ما يلي:

  • بروتوكول أمان طبقة النقل التلقائي
  • قائمة ببروتوكولات أمان طبقة النقل (TLS) المتوافقة
  • خوارزميات TLS المتوافقة
  • رموز TLS المتوافقة

لمزيد من المعلومات، يُرجى الاطّلاع على ضبط خصائص طبقة النقل الآمنة الاختيارية.

إنشاء مضيفات افتراضية وتعديلها وحذفها في Edge UI

تم توسيع وظيفة الخدمة الذاتية لتتمكّن الآن من إنشاء المضيفين الافتراضيين وتعديلهم وحذفهم في المتصفّح (واجهة مستخدم Edge فقط).

لمزيد من المعلومات، يُرجى الاطّلاع على إنشاء مضيف افتراضي باستخدام متصفّح.

تمت إضافة إمكانية استخدام الإصدار 3 من OpenAPI

أضاف هذا الإصدار إمكانية إنشاء خادم وكيل من خلال الإصدار 3 من OpenAPI (واجهة مستخدم Edge فقط).

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

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

تمت إضافة الدعم لم تعُد متاحة

يتيح هذا الإصدار استخدام المنصّات التالية:

  • Red Hat Enterprise Linux (RHEL) 7.6
  • CentOS 7.6
  • Oracle Linux 7.6

لم يعُد هذا الإصدار متوافقًا مع الأنظمة الأساسية التالية:

  • الإصدار 7.3 من RHEL/CentOS/Oracle
  • الإصدار 6.8 من RHEL/CentOS
  • Oracle Linux 6.7

للاطّلاع على قائمة كاملة بالمنصات المتوافقة، راجِع البرامج والإصدارات المتوافقة.

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

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

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

لم يتم إيقاف Zookeeper بواسطة نص النسخ الاحتياطي

لم يكن النص البرمجي للنسخ الاحتياطي يوقف عملية Zookeeper قبل تطبيق هذا الإصلاح.
120993451

تمت إضافة الصفحة المقصودة "لا توجد مؤسسات"

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

حذف التقارير المخصّصة

تعذّر على المستخدمين حذف التقارير المخصّصة في تجربة New Edge.
120681592

علامة التبويب "الخريطة الجغرافية" في تجربة Edge الجديدة

عندما كان المستخدمون ينتقلون إلى علامة التبويب "الخريطة الجغرافية" في تجربة New Edge، كانت تجربة New Edge تعرض رسالة خطأ.
120624977

خيارات JVM في Zookeeper

لم يكن من الممكن ضبط خيارات JVM باستخدام "الرمز مع الإعدادات" في Zookeeper.
80187407

حدثت أخطاء غير محدّدة في تلميحات الأدوات

عندما كان الرسم البياني يتضمّن سلسلة زمنية واحدة فقط، كانت تظهر أخطاء غير محدّدة في تلميحات الأدوات.
79949124

إنشاء خوادم وكيلة عكسية من خلال OpenAPI

لم يكن الزر استخدام OpenAPI يعمل عند إنشاء الخوادم الوكيلة.
77515655

عدم إرسال الروابط لإعادة ضبط كلمات المرور

لم يكن المستخدمون يتلقّون رسائل إلكترونية عند طلب رابط لإعادة ضبط كلمات المرور.
72799769

عناوين غير صحيحة لروابط إعادة ضبط كلمة المرور

وحتى بعد أن ضبط أحد المستخدمين قيمة السمة trustxforwarded على true، لم تكن عناوين الطلبات الناتجة تستخدم HTTPS.
69550284

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

تعذّر إنشاء خادم وكيل لواجهة برمجة التطبيقات عند استخدام ملفات WSDL.

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

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

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

تنسيق ملف البيانات الوصفية لتثبيت apigee-sso

عند تثبيت apigee-sso واستخدام ملف metadata.xml بدلاً من عنوان URL، إذا لم يتضمّن ملف metadata.xml سطرًا جديدًا (CRLF) في نهاية الملف، لن تتم قراءة ملف metadata.xml بالكامل.

الحل:

لحلّ هذه المشكلة، يمكنك اتّخاذ أحد الإجراءات التالية:

  • أضِف CRLF إلى نهاية ملف metadata.xml

    أو

  • استخدام موقع جغرافي مستند إلى عنوان URL للبيانات الوصفية
122370980

apigee-monit غير متوافق مع Amazon Linux 1

الحل:

بلا عُري
121095148

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

الحل:

نفِّذ عملية الاحتفاظ بنسخة احتياطية مرة ثانية، ومن المفترض أن يتم الاحتفاظ بالمجموعة الصحيحة من الملفات.
115278838

عدم إبطال رموز الجلسات

لا يتم إبطال رموز الجلسات المميزة على الخادم عندما ينقر المستخدم على زر "تسجيل الخروج" في Apigee Edge.

الحل:

استخدام تجربة Edge الجديدة مع SAML
113342838

تعذُّر عمليات Cassandra عند تفعيل مصادقة JMX

الحل:

أضِف اسم المستخدم وكلمة المرور كلما استدعيت الأمر nodetool.
79993247

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

قد تتوقف طلبات HEAD الموجّهة إلى هدف Node.js، ما يؤدي إلى بقاء عمليات الربط في انتظار المراجعة.

الحل:

لتجنُّب هذه المشكلة، حدِّد معالجًا لطلبات HEAD من أجل عرض استجابة فارغة بشكلٍ صريح.
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

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

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

الحل البديل

الحل البديل هو إلغاء تسجيل أنواع عقد 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 هو اسم الحزمة، وهو "gateway" تلقائيًا. مع ذلك، قد تكون أعدت تسميته إلى اسم آخر، لذا راجِع عملية التنفيذ.
    • 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 لكل معرّف فريد عالمي (UUID) جمعته في الخطوتَين 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. لمزيد من المعلومات حول هذه الأوامر، يُرجى الاطّلاع على تعديل عمليات تسجيل مخزن البيانات.
68722102

سياسة MessageLogging تتضمّن معلومات إضافية في رسالة السجلّ

يتحكّم العنصر FormatMessage في سياسة MessageLogging في تنسيق الرسالة التي تم تسجيلها. عندما تكون القيمة FormatMessage=false، من المفترض ألا تتضمّن الرسالة المسجّلة أي معلومات من إنشاء Apigee. ومع ذلك، حتى إذا ضبطت FormatMessage=false، ستظل رسالة السجلّ تتضمّن المعلومات التالية:

  • نتيجة الأولوية
  • الطابع الزمني

الحل:

بلا عُري
65737520

تعذُّر إعادة ضبط كلمة مرور مشرف النظام

ستتعذّر إعادة ضبط كلمة مرور مشرف النظام لخادم الإدارة الذي يحتوي على رموز خاصة.

الحل:

حدِّد كلمة المرور في ملف بيانات ترسله بعد ذلك إلى نقطة النهاية /users في Management API. لمزيد من المعلومات، يُرجى الاطّلاع على إعادة ضبط كلمة مرور مشرف النظام.

الخطوة التالية

لبدء استخدام Edge for Private Cloud 4.19.01، استخدِم الروابط التالية:

عمليات التثبيت الجديدة:
نظرة عامة على التثبيت الجديدة
عمليات التثبيت الحالية:
مسارات الترقية