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

عند استخدام متغيّر مسار cachehit بعد سياسة LookupCache، بسبب الطريقة التي يتم إرسال نقاط تصحيح الأخطاء بها للسلوك غير المتزامن، تتم تعبئة كائن DebugInfo من خلال LookupPolicy قبل تنفيذ طلب معاودة الاتصال، ما يؤدي إلى حدوث خطأ.

الحل: كرِّر العملية (إجراء مكالمة ثانية) مرة أخرى مباشرةً بعد المكالمة الأولى.

من المفترض أن يؤدي ضبط السياسة PurgeChildEntries في سياسة invalidateCache إلى إزالة قيم العنصر KeyFragment فقط نهائيًا، ولكن سيتم محو ذاكرة التخزين المؤقت بأكملها.

الحل: استخدِم سياسة KeyValueMapOperations لتكرار تحديد إصدارات ذاكرة التخزين المؤقت وتجاوز الحاجة إلى إبطال ذاكرة التخزين المؤقت.

• يتوافق Apigee Edge مع مواصفات OpenAPI الإصدار 3.0 عند إنشاء المواصفات باستخدام أداة تعديل المواصفات وواجهات برمجة تطبيقات النشر باستخدام "مستندات Google الذكية" على البوابة، علمًا أنّ مجموعة فرعية من الميزات ليست متوافقة بعد.

  على سبيل المثال، الميزات التالية من الإصدار 3.0 من مواصفات OpenAPI لم يتم دعمها حتى الآن:

  • allOf سمة لدمج المخططات وتوسيعها
  • المراجع عن بُعد

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

  ملاحظة: بما أنّ محرِّر المواصفات أقل تقييدًا من "مستندات Google الذكية" عند عرض المستندات المرجعية لواجهة برمجة التطبيقات، قد تظهر لك نتائج مختلفة بين الأداتَين.

• عند استخدام تجربة واجهة برمجة التطبيقات هذه في البوابة، يتم ضبط عنوان Accept على application/json بغض النظر عن القيمة المضبوطة على consumes في مواصفات OpenAPI.

• لا يتم حاليًا توفير التحديثات المتزامنة للبوابة (مثل تعديلات الصفحة أو المظهر أو CSS أو النصوص البرمجية) من قِبل مستخدمين متعددين في الوقت الحالي.
• إذا حذفت صفحة مستندات مرجعية لواجهة برمجة التطبيقات من البوابة، ما من طريقة لإعادة إنشائها، بل عليك حذف منتج واجهة برمجة التطبيقات وإعادة إضافته وإعادة إنشاء المستندات المرجعية لواجهة برمجة التطبيقات.
• عند ضبط سياسة أمان المحتوى، قد يستغرق تطبيق التغييرات بالكامل ما يصل إلى 15 دقيقة.
• عند تخصيص مظهر البوابة، قد يستغرق تطبيق التغييرات بالكامل ما يصل إلى 5 دقائق.

• وسيتم دمج خدمة "بحث Google" في البوابة المتكاملة في إصدار مستقبلي.

تؤثر هذه المشكلة فقط في أولئك الذين يستخدمون MINT أو MINT مفعَّلة في Edge لعمليات تثبيت Private Cloud.

المكوّن المتأثر: برنامج معالجة الرسائل الحدّ

المشكلة: إذا كانت ميزة تحقيق الربح مفعّلة وكنت تريد تثبيت الإصدار 4.52.01 كتثبيت جديد أو الترقية من إصدارات Private Cloud السابقة، ستواجه مشكلة في معالجات الرسائل. ستكون هناك زيادة تدريجية في عدد سلاسل المحادثات المفتوحة، مما يؤدي إلى استنفاد الموارد. يظهر الاستثناء التالي في Edge-message-processor system.log:

Error injecting constructor, java.lang.OutOfMemoryError: unable to create new native thread

تم اكتشاف ثغرة أمنية لحجب الخدمة (DoS) مؤخرًا في العديد من عمليات تنفيذ بروتوكول HTTP/2 (CVE-2023-44487)، بما في ذلك Apigee Edge for Private Cloud. قد تؤدي الثغرة الأمنية إلى ظهور وظيفة إدارة واجهة برمجة تطبيقات DoS of Apigee. لمزيد من التفاصيل، يُرجى الاطّلاع على Apigee Security Bulletin GCP-2023-032.

تكون مكوّنات جهاز توجيه وخادم الإدارة في Edge for Private Cloud معرّضة للهجوم على الإنترنت، ما قد يتعرّض للاختراق. على الرغم من تفعيل بروتوكول HTTP/2 في منفذ إدارة المكوّنات الأخرى الخاصة بخدمة Edge في Edge for Private Cloud، لا يظهر أي من هذه المكوّنات على الإنترنت. لا يتم تفعيل HTTP/2 في المكونات التي لا تنتمي إلى Edge، مثل Cassandra و Zookeeper وغيرها. ننصحك باتّخاذ الخطوات التالية لمعالجة الثغرة الأمنية Edge for Private Cloud:

• خطوات الإصدار 4.51.00.11 أو الإصدارات الأحدث من Edge الخاص بـ Private Cloud
• خطوات إصدارات Edge الأقدم من 4.51.00.11

يُرجى اتّباع هذه الخطوات إذا كنت تستخدم الإصدار 4.51.00.11 من Edge الخاص أو إصدار أحدث:

1. تحديث خادم الإدارة:

   1. في كل عقدة خادم الإدارة، افتح /opt/apigee/customer/application/management-server.properties.
   2. أضِف هذا السطر إلى ملف السمات:

      conf_webserver_http2.enabled=false

   3. أعِد تشغيل مكوّن خادم الإدارة:

      apigee-service edge-management-server restart

2. تحديث معالج الرسائل:

   1. في كل عقدة لمعالج الرسائل، افتح "/opt/apigee/customer/application/message-processor.properties".
   2. أضِف هذا السطر إلى ملف السمات:

      conf_webserver_http2.enabled=false

   3. أعِد تشغيل مكوّن معالج الرسائل:

      apigee-service edge-message-processor restart

3. تحديث جهاز التوجيه:

   1. على كل عقدة جهاز توجيه، افتح /opt/apigee/customer/application/router.properties.
   2. أضِف هذا السطر إلى ملف السمات:

      conf_webserver_http2.enabled=false

   3. أعِد تشغيل مكوّن معالج الرسائل:

      apigee-service edge-router restart

4. تعديل معرّف QPID:

   1. في كل عقدة QPID، افتح /opt/apigee/customer/application/qpid-server.properties
   2. أضِف هذا السطر إلى ملف السمات:

      conf_webserver_http2.enabled=false

   3. أعِد تشغيل مكوّن معالج الرسائل:

      apigee-service edge-qpid-server restart

5. تعديل المشاركات:

   1. في كل عقدة Postgres، افتح /opt/apigee/customer/application/postgres-server.properties
   2. أضِف هذا السطر إلى ملف السمات:

      conf_webserver_http2.enabled=false

   3. أعِد تشغيل مكوّن معالج الرسائل:

      apigee-service edge-postgres-server restart

اتّبع هذه الخطوات إذا كنت تستخدم Edge لإصدارات Private Cloud الأقدم من 4.51.00.11:

1. تحديث خادم الإدارة:

   1. في كل عقدة خادم الإدارة، افتح /opt/apigee/customer/application/management-server.properties.
   2. أضِف السطرَين التاليَين إلى ملف السمات:

      conf_webserver_http2.enabled=false
      conf/webserver.properties+http2.enabled=false

   3. أعِد تشغيل مكوّن خادم الإدارة:

      apigee-service edge-management-server restart

2. تحديث معالج الرسائل:

   1. في كل عقدة لمعالج الرسائل، افتح "/opt/apigee/customer/application/message-processor.properties".
   2. أضِف السطرَين التاليَين إلى ملف السمات:

      conf_webserver_http2.enabled=false
      conf/webserver.properties+http2.enabled=false

   3. أعِد تشغيل مكوّن معالج الرسائل:

      apigee-service edge-message-processor restart

3. تحديث جهاز التوجيه:

   1. على كل عقدة جهاز توجيه، افتح /opt/apigee/customer/application/router.properties.
   2. أضِف السطرَين التاليَين إلى ملف السمات:

      conf_webserver_http2.enabled=false
      conf/webserver.properties+http2.enabled=false

   3. أعِد تشغيل مكوّن معالج الرسائل:

      apigee-service edge-router restart

4. تعديل معرّف QPID:

   1. في كل عقدة QPID، افتح /opt/apigee/customer/application/qpid-server.properties
   2. أضِف السطرَين التاليَين إلى ملف السمات:

      conf_webserver_http2.enabled=false
      conf/webserver.properties+http2.enabled=false

   3. أعِد تشغيل مكوّن معالج الرسائل:

      apigee-service edge-qpid-server restart

5. تعديل المشاركات:

   1. في كل عقدة Postgres، افتح /opt/apigee/customer/application/postgres-server.properties
   2. أضِف السطرَين التاليَين إلى ملف السمات:

      conf_webserver_http2.enabled=false
      conf/webserver.properties+http2.enabled=false

   3. أعِد تشغيل مكوّن معالج الرسائل:

      apigee-service edge-postgres-server restart

تواجه Apigee-postgresql مشاكل في الترقية من Edge لخدمة Private Cloud الإصدار 4.50 أو 4.51 إلى الإصدار 4.52. تحدث المشاكل بشكل أساسي عندما يكون عدد الجداول أكبر من 500.

يمكنك التحقق من العدد الإجمالي للجداول في Postgres عن طريق تشغيل استعلام SQL أدناه:

select count(*) from information_schema.tables

الحل البديل: عند تحديث Apigee Edge 4.50.00 أو من 4.51.00 إلى 4.52.00، تأكَّد من تنفيذ الخطوة الأولية قبل ترقية Apigee-postgresql.

لا يعمل apigee-mirror على الإصدار 8.0 من Red Hat Enterprise Linux (RHEL).

الحل: كحل بديل، يمكنك تثبيت apigee-mirror على خادم يعمل بإصدار أقل من RHEL أو نظام تشغيل آخر متوافقًا مع Apigee. يمكنك بعد ذلك استخدام النسخة المطابقة لإضافة حزم حتى إذا كنت قد ثبّت Apigee على خوادم RHEL 8.0.

149245401: لا تنعكس إعدادات مجموعة اتصال LDAP لـ JNDI التي تم ضبطها من خلال مورد LDAP، وتتسبّب الإعدادات التلقائية لJNDI في إجراء اتصالات تُستخدَم لمرة واحدة في كل مرة. ونتيجة لذلك، يتم فتح الاتصالات وإغلاقها في كل مرة للاستخدام الفردي، ما يؤدي إلى إنشاء عدد كبير من الاتصالات في الساعة بخادم LDAP.

حلّ المشكلة:

لتغيير سمات مجموعة اتصالات LDAP، نفِّذ الخطوات التالية لضبط تغيير عام في جميع سياسات LDAP.

1. أنشئ ملف سمات ضبط إذا لم يكن متوفرًا:

   /opt/apigee/customer/application/message-processor.properties

2. أضِف ما يلي إلى الملف (استبدِل قيم سمات Java التسمية وواجهة الدليل (JNDI) استنادًا إلى متطلّبات إعداد موارد LDAP).

   bin_setenv_ext_jvm_opts="-Dcom.sun.jndi.ldap.connect.pool.maxsize=20
   -Dcom.sun.jndi.ldap.connect.pool.prefsize=2
   -Dcom.sun.jndi.ldap.connect.pool.initsize=2
   -Dcom.sun.jndi.ldap.connect.pool.timeout=120000
   -Dcom.sun.jndi.ldap.connect.pool.protocol=ssl"

3. تأكَّد من أنّ الملف /opt/apigee/customer/application/message-processor.properties يملكه apigee:apigee.
4. أعِد تشغيل كل معالج رسائل.

للتحقّق من أنّ سمات مجموعة الاتصال JNDI سارية، يمكنك تنفيذ tcpdump لملاحظة سلوك مجموعة اتصالات LDAP بمرور الوقت.

139051927: تؤثر أوقات استجابة المعالجة الكبيرة للخادم الوكيل في معالج الرسائل على جميع الخوادم الوكيلة لواجهة برمجة التطبيقات. تشمل الأعراض التأخيرات التي تتراوح بين 200 و300 ملي ثانية في أوقات المعالجة خلال أوقات الاستجابة العادية لواجهة برمجة التطبيقات، ويمكن أن تحدث بشكلٍ عشوائي حتى مع انخفاض عدد نقاط الاتصال. ويمكن أن يحدث ذلك عندما يُجري أكثر من 50 خادمًا مستهدفًا يقوم فيه معالج الرسائل بإجراء اتصالات.

السبب الأساسي: تحتفظ معالجات الرسائل بذاكرة تخزين مؤقت تعمل على ربط عنوان URL للخادم المستهدف بكائن HTTPClient في الاتصالات الصادرة بالخوادم المستهدفة. يتم ضبط هذا الإعداد تلقائيًا على 50، وهو ما قد يكون منخفضًا جدًا لمعظم عمليات النشر. عندما تتضمّن عملية النشر عدة مجموعات من المؤسسات والبيئات في عملية إعداد، ويكون عدد الخوادم المستهدفة يتجاوز 50 خادمًا في المجمل، يتم باستمرار إزالة عناوين URL الخاصة بالخوادم المستهدفة من ذاكرة التخزين المؤقت، ما يؤدي إلى حدوث مشاكل في وقت الاستجابة.

التحقّق: لتحديد ما إذا كان إخلاء عنوان URL للخادم المستهدف هو السبب في حدوث مشكلة في وقت الاستجابة، ابحث في سجلّات نظام معالجة الرسائل عن الكلمة الرئيسية "onEvict" أو "إخلاء". ويشير وجود هذه العناوين في السجلات إلى أنّ عناوين URL للخادم المستهدف يتم إخراجها من ذاكرة التخزين المؤقت لـ HTTPClient لأنّ حجم ذاكرة التخزين المؤقت صغير جدًا.

الحل: بالنسبة إلى الإصدارين 19.01 و19.06 من Edge في السحابة الإلكترونية الخاصة، يمكنك تعديل وإعداد ذاكرة التخزين المؤقت لـ HTTPClient، وهي /opt/apigee/customer/application/message-processor.properties:

conf/http.properties+HTTPClient.dynamic.cache.elements.size=500

ثم أعِد تشغيل معالج الرسائل. أجرِ التغييرات نفسها على جميع معالجات الرسائل.

القيمة 500 هي مثال. ويجب أن تكون القيمة المثلى لعملية الإعداد أكبر من عدد الخوادم المستهدفة التي سيتصل بها معالج الرسائل. ليس هناك أي آثار جانبية ناتجة عن ضبط مستوى أعلى لهذه السمة على مستوى أعلى، والتأثير الوحيد الذي قد يحدث هو تحسين أوقات معالجة طلبات الخادم الوكيل لمعالج الرسائل.

ملاحظة: الإعداد التلقائي 500 في الإصدار 50.00 من Edge على السحابة الإلكترونية الخاصة هو 500.

157933959: تؤدي عمليات الإدخال والتعديلات المتزامنة في خريطة قيمة المفتاح نفسها (KVM) نفسها على مستوى المؤسسة أو البيئة إلى ظهور بيانات غير متسقة وفقدان التعديلات.

ملاحظة: لا ينطبق هذا القيد إلا على Edge for Private Cloud. ولا تشمل شبكات Edge الخاصة بالسحابة الإلكترونية العامة والمختلطة هذا القيد.

للحصول على حل بديل في Edge for Private Cloud، يمكنك إنشاء KVM على نطاق apiproxy.