1.2.0 - ملاحظات إصدار نظام التشغيل Apigee المختلط

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

في 3 أبريل 2020، طرحنا الإصدار 1.2.0 من وقت تشغيل Apigee المختلط.

تجري ترقيته

ميزات وأخبار جديدة

في ما يلي الميزات والأخبار الجديدة في هذا الإصدار.

تمت إضافة إعداد جديد للمضيف الافتراضي لتحديد قواعد التوجيه

تعالج ميزة إعداد virtualhosts الجديدة مشكلة كانت تؤدي إلى عدم التأكّد من ترتيب توجيه المسارات الأساسية إلى بيئات متعددة. لمعرفة التفاصيل، يُرجى الاطّلاع على مقالة ضبط المضيفين الافتراضيين. (150336519)

الإصدار التجريبي من سياسة OASValidation

تتيح لك سياسة OASValidation (التحقّق من مواصفات OpenAPI) (الإصدار التجريبي) التحقّق من صحة طلب وارد أو رسالة ردّ استنادًا إلى مواصفات OpenAPI 3.0 (JSON أو YAML). لمزيد من المعلومات، يُرجى الاطّلاع على مقالة سياسة OASValidation (الإصدار التجريبي). (144949685)

الإصدار التجريبي من ميزة دعم WebSocket

يتوافق Apigee المختلط مع اتصالات WebSocket. يمكن لعملاء الخادم الوكيل لواجهة برمجة التطبيقات الآن طلب ترقية البروتوكول من HTTP إلى WebSockets. لمعرفة التفاصيل، يُرجى الاطّلاع على مقالة استخدام WebSockets (الإصدار التجريبي).

الوصول إلى القيم السرية للسياسة من أسرار Kubernetes

تتيح لك ميزة جديدة الوصول إلى القيم المخزّنة في سر Kubernetes في متغيّرات مسار الخادم الوكيل. لمعرفة التفاصيل، يُرجى الاطّلاع على مقالة تخزين البيانات في سر Kubernetes. (133377603)

يحلّ عنصر Apigee Operators (AO) محلّ ADAC وADAH

ينشئ عنصر Apigee Operators (AO) موارد Kubernetes وIstio من المستوى الأدنى ويعدّلها، وهي الموارد المطلوبة لنشر AD والحفاظ عليه. على سبيل المثال، ينفّذ التحكّم طرح معالجات الرسائل. يتحقّق أيضًا من صحة إعداد ApigeeDeployment قبل حفظه في مجموعة Kubernetes. يحلّ عنصر AO محلّ Apigee Deployment Admissionhook (ADAH) وApigee Deployment Controller (ADC). يُرجى الاطّلاع على ao في مرجع خصائص الإعدادات. (151250559)

استبدال بعض خصائص إعدادات المجموعة والمشروع وإيقافها نهائيًا

تمت إضافة خاصيتَي إعداد جديدتَين: k8sCluster وgcp. تحلّ هاتان الخاصيتان محلّ الخصائص التالية التي تم إيقافها نهائيًا: k8sClusterName, gcpRegion, وgcpProjectID. لمعرفة التفاصيل، يُرجى الاطّلاع على مرجع خصائص الإعدادات. (146299599)

توسيع الحجم الدائم لـ Cassandra على Kubernetes

تمت إضافة عملية لتوسيع الحجم الدائم الذي تستخدمه apigee-cassandra لاستيعاب احتياجات التخزين، بدون الحاجة إلى إضافة المزيد من العُقد لزيادة مساحة التخزين فقط. يُرجى الاطّلاع على مقالة توسيع الأحجام الدائمة لـ Cassandra. (138167919)

إتاحة مصادر إضافية للشهادات ومفاتيح التشفير وحسابات الخدمة

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

  • kmsEncryptionPath
  • kmsEncryptionSecret.key
  • kmsEncryptionSecret.name
  • cassandra.backup.serviceAccountSecretRef
  • cassandra.restore.serviceAccountSecretRef
  • envs[].cacheEncryptionPath
  • envs[].cacheEncryptionSecret.key
  • envs[].cacheEncryptionSecret.name
  • envs[].kmsEncryptionPath
  • envs[].kmsEncryptionSecret.key
  • envs[].kmsEncryptionSecret.name
  • envs[].serviceAccountSecretRefs.synchronizer
  • envs[].serviceAccountSecretRefs.udca
  • envs[].sslSecret
  • logger.serviceAccountSecretRef
  • mart.serviceAccountSecretRef
  • mart.sslSecret
  • metrics.serviceAccountSecretRef
  • synchronizer.serviceAccountSecretRef
  • udca.serviceAccountSecretRef

لمزيد من المعلومات، يُرجى الاطّلاع على مرجع خصائص الإعدادات. (145303466)

السماح للعملاء بإخفاء البيانات قبل إرسالها إلى "إحصاءات Apigee"

تمت إضافة ميزة تتيح لك إخفاء بعض بيانات "إحصاءات Apigee" قبل إرسالها إلى لوحة الإدارة. لمعرفة التفاصيل، يُرجى الاطّلاع على مقالة إخفاء بيانات المستخدمين لأغراض "إحصاءات Apigee". (142578910)

توسيع الأحجام الدائمة لمجموعات statefulsets

تمت إضافة ميزة تتيح لك توسيع الحجم الدائم الذي تستخدمه apigee-cassandra لـ استيعاب احتياجات التخزين، بدون إضافة المزيد من قوة الحوسبة. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة توسيع الأحجام الدائمة لمجموعات statefulsets. (138167919)

تتم ترقية الحد الأدنى للإصدارات المتوافقة من GKE وAnthos وAKS

يتوافق Apigee المختلط الآن مع GKE 1.14.x وAnthos 1.2 وAKS 1.14.x. (149578101)

إتاحة استخدام بروتوكول أمان طبقة النقل (TLS) 1.3 للاتصالات الواردة

تتيح لك خاصيتَا إعداد جديدتَين ضبط الحد الأدنى والأقصى لإصدار بروتوكول أمان طبقة النقل (TLS) لوحدة التحكّم في الدخول: ingress.minTLSProtocolVersion وmaxTLSProtocolVersion. القيمتان المحتمَلتان هما 1.0 و1.1 و1.2 و1.3. لمزيد من المعلومات، يُرجى الاطّلاع على مرجع خصائص الإعدادات. (117580780)

إتاحة إعداد الخادم الوكيل الأمامي لوقت التشغيل المختلط

تتوفّر الآن ميزة توجيه طلبات HTTP عبر خادم وكيل أمامي للخوادم الوكيلة لواجهة برمجة التطبيقات التي تم نشرها في بيئة. لمعرفة التفاصيل، يُرجى الاطّلاع على مقالة ضبط توجيه الطلبات عبر خادم وكيل أمامي. (148970527)

إتاحة أسماء مستعارة متعددة للمضيف لكل بيئة

تمت إضافة خاصية إعداد جديدة، وهي envs[].hostAliases. تتيح لك هذه الخاصية إضافة أسماء مستعارة متعددة للمضيف إلى بيئة. يُرجى استخدام هذا العنصر بدلاً من hostAlias الذي تم إيقافه نهائيًا. لمعرفة التفاصيل، يُرجى الاطّلاع على مقالة إضافة أسماء مستعارة متعددة للمضيف إلى بيئة. (150738495)

إتاحة النماذج لمجموعات الخصائص

تمت إضافة عنصر جديد <PropertySetRef> إلى العنصر <AssignVariable> في سياسة <AssignMessage> policy. يسمح لك العنصر <PropertySetRef> بإنشاء زوج من اسم مجموعة الخصائص/المفتاح بشكل ديناميكي. تتوفّر هذه الميزة للخوادم الوكيلة لواجهة برمجة التطبيقات التي تم نشرها على Apigee المختلط فقط. يُرجى الاطّلاع على مقالة AssignVariable. (148612340)

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

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

معرّف المشكلة اسم المكوّن الوصف
147958049 وقت التشغيل تمت معالجة مشكلة في التوقيت في تسلسل بدء وقت التشغيل كانت تمنع أحيانًا أداة المزامنة من بدء التشغيل بشكل صحيح.
149867244 منصة K8S تعذُّر تشغيل مجموعة apigee-cps-setup في الإعداد المتعدد المناطق
150187652 / 149117839 وقت التشغيل تعذُّر استخدام الواصلات في أسماء البيئات
149220463 مجموعة MP كانت الخوادم الوكيلة التي تم نشرها سابقًا بحاجة إلى إعادة نشرها.
144321144 وقت التشغيل تعذُّر إعادة تحميل الخوادم الوكيلة التي تتضمّن مضيفين افتراضيين آمنَين
147685310 وقت التشغيل فشل تهيئة أداة المزامنة بسبب تعذُّر جلب رمز GCP المميّز أثناء التهيئة
151115900 وقت التشغيل لم يكن التحقيق الداخلي الدوري يحدث لـ HybridMART، ما أدّى إلى نتائج إيجابية خاطئة.

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

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

المشكلة الوصف
لا ينطبق

خطأ في عنوان HTTP غير صالح: تحوّل وحدة التحكّم في الدخول في Istio جميع الردود الواردة على الهدف إلى بروتوكول HTTP2. بما أنّ معالج الرسائل المختلط لا يتوافق إلا مع HTTP1، قد يظهر الخطأ التالي عند استدعاء خادم وكيل لواجهة برمجة التطبيقات:

http2 error: Invalid HTTP header field was received: frame type: 1, stream: 1,
   name: [:authority], value: [domain_name]

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

  • تعديل الخدمة المستهدَفة لإزالة عنوان المضيف في الردّ
  • إزالة عنوان المضيف باستخدام سياسة AssignMessage في الخادم الوكيل لواجهة برمجة التطبيقات إذا لزم الأمر
144584813 إذا أنشأت جلسة تصحيح أخطاء ولكن لم تتضمّن الجلسة بعد أيّ معاملات، لا تتضمّن واجهة برمجة التطبيقات List Debug Sessions الجلسة في هذه القائمة. لا تتضمّن واجهة برمجة التطبيقات الجلسات في الردّ إلا إذا كانت الجلسة تحتوي على معاملة واحدة على الأقل.
143659917

يجب ضبط إعداد انتهاء الصلاحية في سياسة PopulateCache على قيمة صريحة تتراوح بين 1 و30. على سبيل المثال:

<ExpirySettings>
  <TimeoutInSec>30</TimeoutInSec>
</ExpirySettings>
133192879

الملخّص: هناك فترة تأخير كبيرة جدًا عند استخدام واجهة برمجة التطبيقات أو واجهة المستخدم للحصول على حالة النشر في مؤسستك. يمكن أن يؤدي هذا التأخير إلى ظهور الردّ HTTP 204 (No Content) أو HTTP 400 (Bad Request).

الحلّ البديل: يُرجى إعادة تحميل المتصفّح (أو إعادة إرسال الطلب).