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

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

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

ارتقا

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

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

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

ویژگی جدید پیکربندی virtualhosts به مشکلی می‌پردازد که در آن ترتیب مسیریابی مسیرهای پایه به چندین محیط نامشخص بود. برای جزئیات بیشتر، به پیکربندی میزبان‌های مجازی مراجعه کنید. (150336519)

انتشار نسخه بتای سیاست اعتبارسنجی OAS

سیاست OASValidation (اعتبارسنجی مشخصات OpenAPI) (نسخه بتا) شما را قادر می‌سازد تا یک درخواست یا پاسخ ورودی را با استفاده از مشخصات OpenAPI 3.0 (JSON یا YAML) اعتبارسنجی کنید. برای اطلاعات بیشتر، به سیاست OASValidation (نسخه بتا) مراجعه کنید. (144949685)

انتشار نسخه بتای پشتیبانی از WebSocket

Apigee hybrid از اتصالات WebSocket پشتیبانی می‌کند. کلاینت‌های پروکسی API اکنون می‌توانند درخواست ارتقاء پروتکل از HTTP به WebSockets را بدهند. برای جزئیات بیشتر، به بخش «استفاده از WebSockets (بتا)» مراجعه کنید.

دسترسی به مقادیر مخفی سیاست از طریق مخفی‌های Kubernetes

یک ویژگی جدید به شما امکان می‌دهد به مقادیر ذخیره شده در یک Kubernetes secret در متغیرهای جریان پروکسی دسترسی داشته باشید. برای جزئیات بیشتر، به ذخیره داده‌ها در Kubernetes secret مراجعه کنید. (133377603)

عنصر Apigee Operators (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)

گسترش حجم مداوم برای کاساندرا در 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)

گسترش حجم‌های پایدار برای مجموعه‌های حالت‌دار

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

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

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

پشتیبانی از TLS 1.3 برای اتصالات Northbound

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

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

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

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

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

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

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

اشکالات برطرف شد

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

شناسه مسئله نام کامپوننت توضیحات
۱۴۷۹۵۸۰۴۹ زمان اجرا یک مشکل زمان‌بندی در توالی راه‌اندازی در زمان اجرا که گاهی اوقات مانع از راه‌اندازی صحیح هماهنگ‌کننده می‌شد، برطرف شد.
۱۴۹۸۶۷۲۴۴ پلتفرم K8S عدم موفقیت غلاف apigee-cps-setup در راه‌اندازی چند منطقه‌ای
۱۵۰۱۸۷۶۵۲ / ۱۴۹۱۱۷۸۳۹ زمان اجرا نمی‌توانست از خط فاصله در نام محیط‌ها استفاده کند.
۱۴۹۲۲۰۴۶۳ غلاف MP پروکسی‌های مستقر شده قبلی نیاز به استقرار مجدد داشتند.
۱۴۴۳۲۱۱۴۴ زمان اجرا پروکسی‌هایی با میزبان‌های مجازی امن قابل بارگیری مجدد نبودند.
۱۴۷۶۸۵۳۱۰ زمان اجرا خرابی‌های مقداردهی اولیه‌ی همگام‌ساز به دلیل عدم دریافت توکن GCP در حین مقداردهی اولیه.
۱۵۱۱۱۵۹۰ زمان اجرا پروب داخلی دوره‌ای برای HybridMART انجام نمی‌شد که منجر به نتایج مثبت کاذب می‌شد.

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

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

مسئله توضیحات
ناموجود

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

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

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

  • سرویس هدف را طوری تغییر دهید که هدر Host در پاسخ حذف شود.
  • در صورت لزوم، هدر Host را با استفاده از سیاست AssignMessage در پروکسی API خود حذف کنید.
۱۴۴۵۸۴۸۱۳ اگر یک جلسه اشکال‌زدایی ایجاد کنید اما هنوز هیچ تراکنشی در آن جلسه وجود نداشته باشد، API مربوط به List Debug Sessions، جلسه را در این لیست قرار نمی‌دهد. این API فقط جلساتی را در پاسخ قرار می‌دهد که جلسه حداقل شامل یک تراکنش باشد.
۱۴۳۶۵۹۹۱۷

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

<ExpirySettings>
  <TimeoutInSec>30</TimeoutInSec>
</ExpirySettings>
۱۳۳۱۹۲۸۷۹

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

راه حل: مرورگر خود را رفرش کنید (یا درخواست را دوباره ارسال کنید).