‫1.2.0 - یادداشت‌های انتشار زمان اجرای ترکیبی Apigee

درحال مشاهده اسناد Apigee Edge هستید.
به اسناد Apigee X بروید.
اطلاعات

در تاریخ ۳ آوریل ۲۰۲۰، زمان اجرای ترکیبی Apigee نسخه ۱.۲.۰ را منتشر کردیم.

درحال ارتقا دادن

ویژگی‌های جدید و به‌روزرسانی‌ها

در زیر ویژگی‌ها و به‌روزرسانی‌های جدید در این نسخه پخش آمده است.

پیکربندی میزبان مجازی جدیدی برای مشخص کردن قوانین مسیریابی اضافه شد

ویژگی پیکربندی جدید 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 را که برای استقرار و نگهداری 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)

پشتیبانی از منابع اضافی برای گواهینامه‌ها، کلیدهای رمزگذاری، و SA

دارایی‌های پیکربندی جدیدی اضافه شده است که انعطاف‌پذیری بیشتری در نحوه مشخص کردن گواهینامه‌های «امنیت لایه انتقال»، کلیدهای رمزگذاری، و کلیدهای حساب سرویس ارائه می‌دهد. دارایی‌های جدید در زیر فهرست شده‌اند:

  • 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

برای اطلاعات بیشتر، مرجع ویژگی‌های «پیکربندی» را ببینید. (۱۴۵۳۰۳۴۶۶)

به مشتریان اجازه می‌دهد داده‌ها را قبل‌از ارسال به Analytics مبهم کنند

ویژگی‌ای اضافه شده است که به شما امکان می‌دهد برخی‌از داده‌های تجزیه‌وتحلیل را قبل‌از ارسال به صفحه مدیریت مبهم کنید. برای جزئیات، مبهم‌سازی داده‌های کاربر برای تجزیه‌وتحلیل را ببینید. (۱۴۲۵۷۸۹۱۰)

ازهم بازکردن حجم‌های ماندگار برای مجموعه‌های حالت‌دار

ویژگی‌ای اضافه شده است که به شما امکان می‌دهد حجم دائمی استفاده‌شده توسط apigee-cassandra را گسترش دهید تا بدون افزودن قدرت محاسباتی بیشتر، نیازهای فضای ذخیره‌سازی را برآورده کنید. برای اطلاعات بیشتر، به ازهم بازکردن حجم‌های ماندگار برای مجموعه‌های حالت‌دار مراجعه کنید. (138167919)

حداقل نسخه‌های پشتیبانی‌شده GKE،‏ Anthos، و AKS ارتقا می‌یابند

‫Apigee hybrid اکنون از GKE 1.14.x،‏ Anthos 1.2، و AKS 1.14.x پشتیبانی می‌کند. (149578101)

پشتیبانی از «امنیت لایه انتقال» نسخه ۱.۳ برای اتصالات «شمالی»

دو دارایی پیکربندی جدید به شما امکان می‌دهد حداقل و حداکثر نسخه «امنیت لایه انتقال» را برای ورودی تنظیم کنید: ingress.minTLSProtocolVersion و maxTLSProtocolVersion. مقادیر ممکن عبارت‌اند از ۱.۰، ۱.۱، ۱.۲، و ۱.۳. برای اطلاعات بیشتر، مرجع ویژگی‌های «پیکربندی» را ببینید. (۱۱۷۵۸۰۷۸۰)

پشتیبانی از پیکربندی پراکسی رو به جلو برای زمان اجرای ترکیبی

اکنون برای پراکسی‌های API که در محیطی مستقر شده‌اند، از پراکسی‌سازی فوروارد HTTP پشتیبانی می‌شود. برای جزئیات بیشتر، پیکربندی پراکسی ارسال را ببینید. (148970527)

پشتیبانی از چندین hostAliases در هر محیط

دارایی پیکربندی جدیدی، envs[].hostAliases، اضافه شده است. این دارایی به شما امکان می‌دهد چندین نام مستعار میزبان را به یک محیط اضافه کنید. به‌جای hostAlias که منسوخ شده است، از این عنصر استفاده کنید. برای جزئیات، افزودن چند نام مستعار میزبان به محیط را ببینید. (150738495)

مجاز کردن الگوها برای مجموعه‌های دارایی

عنصر جدید <PropertySetRef> به عنصر <AssignVariable> در خط‌مشی <AssignMessage> اضافه شد. ‫<PropertySetRef> به شما امکان می‌دهد جفت کلید/نام مجموعه دارایی را به‌صورت پویا ایجاد کنید. این ویژگی فقط برای پراکسی‌های API که در Apigee hybrid مستقر شده‌اند دردسترس است. به AssignVariable مراجعه کنید. (148612340)

اشکالات رفع شد

اشکالات زیر در این نسخه پخش برطرف شده است. این فهرست عمدتاً برای کاربرانی است که بررسی می‌کنند آیا درخواست‌های پشتیبانی‌شان برطرف شده است یا نه. این ویژگی برای ارائه اطلاعات دقیق به همه کاربران طراحی نشده است.

شناسه مشکل نام عنصر شرح
147958049 زمان اجرا مشکل زمان‌بندی در توالی راه‌اندازی زمان اجرا برطرف شد که گاهی اوقات مانع از راه‌اندازی صحیح همگام‌ساز می‌شد.
149867244 K8S Platform واحد apigee-cps-setup در راه‌اندازی چندمنطقه‌ای ناموفق است
۱۵۰۱۸۷۶۵۲ / ۱۴۹۱۱۷۸۳۹ زمان اجرا نمی‌توانید از خط تیره در نام‌های محیط استفاده کنید.
149220463 تیم MP کارگزاران پراکسی که قبلاً مستقر شده بودند باید دوباره مستقر شوند.
144321144 زمان اجرا کارگزاران با میزبان‌های مجازی امن مجدد بار نشدند.
147685310 زمان اجرا مقداردهی اولیه همگام‌ساز به‌دلیل واکشی ناموفق نشان GCP درطول مقداردهی اولیه ناموفق بود.
151115900 زمان اجرا «کاوشگر داخلی دوره‌ای» برای HybridMART انجام نمی‌شد و درنتیجه نتایج مثبت کاذب به‌دست می‌آمد.

مشکلات شناخته‌شده

جدول زیر مشکلات شناخته‌شده این نسخه پخش را شرح می‌دهد:

مشکل شرح
موجود نیست

خطای سرایند HTTP نامعتبر: Istio ingress همه پاسخ‌های هدف ورودی را به پروتکل HTTP2 تغییر می‌دهد. ازآنجایی‌که پردازشگر پیام ترکیبی فقط از HTTP1 پشتیبانی می‌کند، وقتی یک پراکسی API فراخوانی می‌شود ممکن است خطای زیر را ببینید:

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

اگر این خطا را مشاهده کردید، می‌توانید یکی از اقدامات زیر را برای اصلاح مشکل انجام دهید: مشکل:

  • سرویس مقصد را اصلاح کنید تا سرایند «میزبان» را در پاسخ حذف کند.
  • درصورت لزوم، سرصفحه «میزبان» را بااستفاده از خط‌مشی «تخصیص پیام» در پراکسی API بردارید.
144584813 اگر جلسه اشکال‌زدایی ایجاد کنید اما جلسه هنوز هیچ تراکنشی نداشته باشد، سپس «میانای برنامه‌سازی کاربردی فهرست جلسات اشکال‌زدایی» جلسه را در این فهرست اضافه نمی‌کند. میانای برنامه‌سازی کاربردی فقط جلسه‌هایی را در پاسخ قرار می‌دهد که حداقل یک تراکنش داشته باشند.
143659917

تنظیم انقضای خط‌مشی PopulateCache باید روی مقدار صریحی بین ۱ تا ۳۰ تنظیم شود. برای مثال:

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

خلاصه: هنگام استفاده از API یا واسط کاربر برای دریافت وضعیت استقرار سازمان شما، تأخیر بسیار بالایی وجود دارد. این تأخیر می‌تواند منجر به پاسخ HTTP 204 (No Content) یا HTTP 400 (Bad Request) شود.

راهکار موقت: مرورگرتان را بازآوری کنید (یا درخواست را دوباره ارسال کنید).