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 		‫○ Portal:
   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.
إصلاح الأخطاء

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

○ لم يتم إيقاف 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 experience، بما في ذلك ما يلي:

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

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

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

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

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

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

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

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

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

تم توسيع وظيفة الخدمة الذاتية لتتمكّن الآن من إنشاء المضيفين الافتراضيين وتعديلهم وحذفهم في المتصفّح (واجهة مستخدم 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.

الحلّ البديل:

استخدام تجربة New 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

ونتيجةً لذلك، قد لا يبدأ تشغيل Management Server لأنّه يحاول الاتصال بعُقد 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 هو اسم الحزمة، وهو "البوابة" تلقائيًا. مع ذلك، قد تكون أعدت تسميته إلى اسم آخر، لذا راجِع عملية التنفيذ.
    • ‫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 لكل معرّف فريد عالمي جمعته في الخطوتَين 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، استخدِم الروابط التالية:

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