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

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

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

تجري ترقيته

الميزات والتحديثات الجديدة

في ما يلي الميزات والتحديثات الجديدة في هذا الإصدار.

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

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

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

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

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

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

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

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

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

تنشئ "عوامل تشغيل Apigee" (AO) وتعدّل موارد Kubernetes وIstio المنخفضة المستوى المطلوبة لنشر "بوابة Apigee" والحفاظ عليها. على سبيل المثال، ينفّذ المتحكّم عملية إيقاف معالجات الرسائل. يتحقّق أيضًا من صحة إعداد 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)

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

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

  • 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)

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

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

توسيع وحدات التخزين الدائمة لمجموعات statefulset

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

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

يتوافق Apigee hybrid الآن مع الإصدار 1.14.x من GKE والإصدار 1.2 من Anthos والإصدار 1.14.x من AKS. (149578101)

إتاحة الإصدار 1.3 من بروتوكول أمان طبقة النقل (TLS) للاتصالات المتجهة إلى الشمال

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

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

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

إتاحة عدة hostAliases لكل بيئة

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

السماح بنماذج لمجموعات المواقع

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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