یادداشت‌های انتشار Edge برای فضای ابری خصوصی نسخه ۴.۵۰.۰۰

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

این بخش نسخه ۴.۵۰.۰۰ از «انتشار ویژگی Edge برای Cloud خصوصی» را شرح می‌دهد.

خلاصه انتشار

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

ویژگی‌های جدید

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

○ اطلاعات اتصال TLS اکنون در پراکسی‌های API دردسترس است
○ ارتقای Zookeeper
○ دردسترس بودن درگاه Drupal 8 و پایان عمر Drupal 7

برای کسب اطلاعات بیشتر درباره هریک از این ویژگی‌های جدید، به ویژگی‌های جدید مراجعه کنید.

سازگاری با نسخه قدیمی مشکلات زیر که بر سازگاری با نسخه‌های قبلی تأثیر می‌گذارد در این نسخه از Apigee Edge for Private Cloud معرفی شده است:
     
  • به‌دلیل رفع مشکل ۱۳۲۴۴۳۱۳۷ (همان‌طور که در یادداشت‌های انتشار Cloud عمومی در تاریخ ۱۹.۰۳.۰۱ توضیح داده شده است)، «پردازشگرهای پیام» اکنون سرایندهایی را که با X-Apigee-* شروع می‌شوند نادیده می‌گیرند. درنتیجه، باید هر کدی را که از سرایندهای X-Apigee-* استفاده می‌کند بازسازی کنید و آن سرایندها را با سرایندهای پشتیبانی‌شده جایگزین کنید.
  • نام فایل‌های گزارش Cassandra تغییر کرده است. اکنون این است:

    /opt/apigee/var/log/apigee-cassandra/system.log
نسخه‌های پخش گنجانده‌شده

از زمان انتشار ویژگی قبلی Edge for Private Cloud، نسخه‌های پخش زیر منتشر شده است و در این نسخه پخش گنجانده شده است:

○ Edge:
   20.04.06 (زمان اجرا، مدیریت API، مدیریت درآمدزایی)
   20.03.27 (واسط کاربر)
   20.03.16 (تحلیل Edge)
   20.03.11 (واسط کاربر)
   20.02.27 (پایش API)
   20.02.24 (واسط کاربر)
   20.02.03 (پایش API)
   20.01.29 (واسط کاربر)
   20.01.22 (واسط کاربر)
   20.01.06 (مدیریت API/زمان اجرا)
○ Edge (ادامه):
   ‫۲۰.۰۱.۰۶ (واسط کاربر)
   ‫۱۹.۱۱.۱۳ (گزارش امنیت API)
   ‫۱۹.۱۰.۰۱ (واسط کاربر)
   ‫۱۹.۰۹.۲۶ (واسط کاربر/درگاه Edge)
   ‫۱۹.۰۸.۲۷ (واسط کاربر)
   ‫۱۹.۰۸.۱۵ (گزارش امنیت API)
   ‫۱۹.۰۷.۲۹ (واسط کاربر)
○ Portal:
   20.05.27.00
   20.04.13.00
   20.03.20.00
   19.12.20.00
   19.11.21.00
   19.09.25.00
بازنشستگی‌ها خالی
منسوخ‌سازی‌ها

با انتشار نسخه ۴.۵۰.۰۰:

  • 4.18.05: نسخه 4.18.05 از Apigee Edge برای «ابر خصوصی» اکنون منسوخ شده است.

ویژگی‌های منسوخ‌شده در این نسخهٔ پخش شامل موارد زیر می‌شود:

  • پشتیبانی از پراکسی‌های Node.js و «گاوصندوق‌های امن»
  • پشتیبانی از خط‌مشی‌های OAuth v1
  • پشتیبانی از خط‌مشی «محدودیت نرخ هم‌زمان»
  • پشتیبانی از «وقث‌دهنده Apigee برای Istio»
  • پشتیبانی از ویژگی دسترسی زودرس Teams

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

رفع اشکال‌ها

این نسخهٔ پخش شامل رفع اشکالات زیر است:

○ وقتی فروشگاه‌های کلید با نام‌ها یا نام‌های مستعار مشابه پیکربندی می‌شوند، «پردازشگر پیام» نمی‌تواند محیط‌ها را بار کند. (۱۵۴۴۲۸۳۳۸)
○ تعارض وابستگی QPid هنگام نصب وصله (۱۵۲۵۷۴۴۲۱)
○ محدودکننده حافظه نهان اندازه بیشینه حافظه نهان L1 را رعایت نمی‌کند (۱۵۱۴۴۹۱۶۳)
○ اسکریپت‌های پشتیبان‌گیری ناموفق است (۱۵۰۷۱۰۹۵۲)
○ سرور QPid پیام‌های گزارش اضافی ارسال می‌کند (۱۴۸۲۳۱۲۹۰)
○ پشتیبان‌گیری Postgresql اطلاعات SSO را ذخیره نمی‌کند (۱۴۷۴۵۸۳۳۰)
○ نسخه apigee-nginx ارتقا نیافته است. ‫(۱۴۶۸۷۲۸۵۸)
○ پیام «میانای کاربری جدید را امتحان کنید» دیگر نشان داده نمی‌شود (۱۴۵۴۱۹۶۲۱)
○ آسیب‌پذیری Apigee SmartDocs API (۱۴۵۳۴۰۱۰۶)
○ کار نکردن دستورگان پشتیبان‌گیری Postgres (۱۴۵۲۵۴۶۹۳)
○ اصلاحات امنیتی مختلف (۱۴۲۱۵۰۷۰۶)
○ نرخ بالای زمان‌های اتمام «روتر به پردازشگر پیام» (۱۳۸۱۰۷۶۱۸)
○ کار نکردن دستورگان راه‌اندازی SSO (۱۳۵۶۱۶۴۹۸)
○ درگاه‌های JMX (۱۳۲۰۴۴۹۰۷)
○ خطاهای متناوب ۴۰۴ برای ترافیک زمان اجرا به‌دلیل وضعیت مسابقه (۱۳۰۶۵۳۸۱۶)
○ خراب شدن OpenLDAP درطول ارتقا (۱۲۰۷۹۹۱۸۲)
○ DataAccessException در پیکربندی‌های چند مرکز داده (۷۶۰۸۷۱۶۶)
○ کار نکردن «FormatMessage» که در خط‌مشی «MessageLogging» روی false تنظیم شده است (۶۸۷۲۲۱۰۲)

برای اطلاعات بیشتر درباره هریک از این اصلاحات، به اصلاحات اشکال مراجعه کنید.

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

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

○ اعتبارسنجی JWT ناموفق است (۱۵۹۷۸۸۱۷۰)
○ نشت حافظه سرورهای رده‌بندی Mint (۱۳۷۸۶۵۱۸۴)
○ apigee-monit در Amazon Linux 1 پشتیبانی نمی‌شود (۱۲۲۳۷۰۹۸۰)
○ نسخه پشتیبان «پردازشگر پیام» از مجموعه صحیح فایل‌ها پشتیبان‌گیری نمی‌کند (۱۲۰۹۵۱۴۸)
○ افزایش نسبت ازدست رفتن حافظه نهان پس‌از ارتقا (۱۶۰۱۰۹۰۱۴)
○ پاسخ HTTP 408 برای درخواست GET با بدنه خالی و «کدبندی محتوا: gzip». ‫(۱۵۹۸۵۸۰۱۵)

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

مسیرهای ارتقا

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

از 4.19.01 یا 4.19.06 مستقیماً از ۴.۱۹.۰۱/۴.۱۹.۰۶ به ۴.۵۰.۰۰ ارتقا دهید
از ۴.۱۸.۰۵ مستقیماً از ۴.۱۸.۰۵ به ۴.۵۰.۰۰ ارتقا دهید

ویژگی‌های جدید

این بخش ویژگی‌های جدید این نسخه پخش را فهرست می‌کند. علاوه‌براین، این نسخهٔ پخش شامل همه ویژگی‌های موجود در نسخه‌های پخش «میانای کاربر Edge»، «مدیریت Edge»، و «درگاه» فهرست‌شده در نسخه‌های پخش گنجانده‌شده می‌شود.

علاوه‌بر بهبودهای زیر، این نسخهٔ پخش شامل بهبودهای متعددی در زمینه کارایی، عملکرد، امنیت، و پایداری نیز می‌شود.

اطلاعات اتصال «امنیت لایه انتقال» اکنون در پراکسی‌های API دردسترس است

درطول درخواست به پراکسی API ازطریق میزبان مجازی که از «امنیت لایه انتقال» پشتیبانی می‌کند، ‫Edge می‌تواند اطلاعات مربوط به اتصال «امنیت لایه انتقال» را ضبط کند. اکنون کارگزار نیابتی API شما می‌تواند ازطریق متغیرهای جاری به آن اطلاعات دسترسی پیدا کند تا تجزیه‌وتحلیل و اعتبارسنجی بیشتری انجام دهد. برای اطلاعات بیشتر، دسترسی به اطلاعات اتصال «امنیت لایه انتقال» در پراکسی API را ببینید.

ارتقا Zookeeper

این نسخه حاوی Zookeeper 3.4.14 است.

دردسترس بودن درگاه Drupal 8 و پایان عمر Drupal 7

‫Drupal 8 جایگزین Drupal 7 شده است و Apigee آن را به‌عنوان درگاه توسعه‌دهنده توصیه‌شده برای «ابر خصوصی» پیشنهاد می‌کند. ازآنجایی‌که Drupal 7 در نوامبر ۲۰۲۱ به پایان پشتیبانی بلندمدت خود می‌رسد، از نوامبر ۲۰۲۱، از واحدهای Apigee برای Drupal 7 پشتیبانی نخواهد شد. اگرچه هنوز دردسترس است، از این پس نباید از دستورگان نصب/ارتقا برای Drupal 7 استفاده شود و در نسخه پخش آتی برداشته خواهد شد.

برای آشنایی با واحدهای Drupal 8 که با Apigee ادغام می‌شوند، به موارد زیر مراجعه کنید: ساختن درگاه بااستفاده از Drupal 8.

نرم‌افزار پشتیبانی‌شده

این نسخه شامل تغییرات زیر در نرم‌افزار پشتیبانی‌شده است:

پشتیبانی اضافه شد دیگر پشتیبانی نمی‌شود

این نسخه پخش از پلاتفرم‌های زیر پشتیبانی می‌کند:

  • Red Hat Enterprise Linux (RHEL) 7.8
  • CentOS 7.8
  • Oracle Linux 7.8

نسخه پخش جدید دیگر از پلاتفرم‌های زیر پشتیبانی نمی‌کند:

  • Red Hat Enterprise Linux (RHEL) 6.10
  • CentOS 6.10
  • Oracle Linux 6.9

برای فهرست کامل پلاتفرم‌های پشتیبانی‌شده، به نرم‌افزار پشتیبانی‌شده و نسخه‌های پشتیبانی‌شده مراجعه کنید.

رفع اشکال‌ها

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

شناسه مشکل شرح
154428338

وقتی فروشگاه‌های کلید با نام‌ها یا نام‌های مستعار مشابه پیکربندی می‌شوند، «پردازشگر پیام» نمی‌تواند محیط‌ها را بار کند.

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

تداخل وابستگی QPid هنگام نصب وصله

نسخه صحیح QPid اکنون نصب شده است.
151449163

محدودکننده حافظه نهان اندازه بیشینه حافظه نهان L1 را رعایت نمی‌کند

محدودکننده حافظه نهان اکنون حداکثر اندازه حافظه نهان L1 را رعایت می‌کند.
150710952

برنامه‌های پشتیبان‌گیری ناموفق است

روال پشتیبان‌گیری براساس دستورگان‌های پشتیبان‌گیری به‌روزشده به‌روز شده است.
148231209

سرور QPid پیام‌های گزارش اضافی ارسال می‌کند

سرور QPid دیگر پیام‌های گزارش اضافی ارسال نمی‌کند.
147458330

پشتیبان‌گیری Postgresql اطلاعات «ورود به سیستم با یک حساب» را ذخیره نمی‌کند

نسخه پشتیبان Postgresql اکنون اطلاعات SSO را ذخیره می‌کند.
146872858

نسخه apigee-nginx ارتقا نیافت.

نسخه apigee-nginx اکنون به‌درستی ارتقا یافته است.
145419621

پیام `Try the new UI` (واسط کاربر جدید را امتحان کنید) دیگر نشان داده نمی‌شود

واسط کاربر دیگر پیام «واسط کاربر جدید را امتحان کنید» را نمایش نمی‌دهد.
145340106

آسیب‌پذیری Apigee SmartDocs API

کارگزار نیابتی Apigee SmartDocs به‌روزرسانی شد تا آسیب‌پذیری امنیتی را برطرف کند. برای اطلاعات بیشتر و مراحل لازم، به رویه نصب SmartDocs مراجعه کنید.
145254693

برنامه پشتیبان‌گیری Postgres با خطا مواجه می‌شود

اکنون دستورگان پشتیبان‌گیری Postgres به‌درستی کار می‌کند.
142150706

رفع اشکال‌های امنیتی مختلف

رفع مشکلات امنیتی، ازجمله #111390246.
138107618

نرخ بالای زمان‌های اتمام «رهیاب» به «پردازشگر پیام»

این مشکل برطرف شده است.
135616498

خطای دستورگان راه‌اندازی SSO

مشکلی که در آن استفاده از نشانی‌های وب طرح فایل باعث ازکار افتادن دستورگان راه‌اندازی SSO می‌شد رفع شد.
132044907

درگاه‌های JMX

درگاه‌های JMX نباید برای دسترسی خارجی باز باشند، بلکه فقط برای سرورهای داخلی باز باشند.
130653816

خطاهای متناوب ۴۰۴ برای ترافیک زمان اجرا به‌دلیل وضعیت مسابقه

شرایط مسابقه‌ای درطول راه‌اندازی MP که منجر به استقرار نادرست برخی‌از پراکسی‌ها می‌شد برطرف شد.
120799182

خراب شدن OpenLDAP درحین ارتقا

این مشکل برطرف شده است.
76087166

‫DataAccessException در پیکربندی‌های چند مرکز داده

در پیکربندی‌های چند مرکز داده، اگر یکی از مخازن داده دردسترس نباشد، دیگر خطای DataAccessException را نمی‌بینید.
68722102

‫FormatMessage در خط‌مشی MessageLogging روی false تنظیم شده است و کار نمی‌کند

اکنون می‌توانید «قالب‌بندی پیام» را در خط‌مشی «گزارش پیام» روی «نادرست» تنظیم کنید.

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

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

شناسه مشکل شرح
159788170

اعتبارسنجی JWT انجام نشد

اعتبارسنجی JWT برای کلیدهای RSA کوچک‌تر از ۲۰۴۸ بیت انجام نمی‌شود.

راهکار موقت:

مطمئن شوید که کلیدهایتان ۲۰۴۸ بیت یا بزرگ‌تر باشند.
137865184

نشت حافظه سرورهای رده‌بندی Mint

وقتی نمونه Qpid جدیدی در mxgroup ثبت می‌شود، صف‌ها بدون مصرف‌کننده ساخته می‌شوند که باعث می‌شود عمق صف تا زمانی که از همه منابع دردسترس استفاده کند افزایش یابد.

راهکار موقت:

هیچ‌کدام.
122370980

‫apigee-monit در Amazon Linux 1 پشتیبانی نمی‌شود

راهکار موقت:

هیچ‌کدام.
121095148

پشتیبان‌گیری «پردازشگر پیام» از مجموعه فایل‌های صحیح پشتیبان‌گیری نمی‌کند

راهکار موقت:

پشتیبان‌گیری را برای بار دوم اجرا کنید تا مجموعه فایل‌های صحیح پشتیبان‌گیری شود.

160109014

افزایش نسبت «عدم اصابت حافظه نهان» پس‌از ارتقا

پس‌از ارتقا به نسخه ۴.۵۰.۰۰، ممکن است پراکسی‌ها نسبت ازدست رفتن حافظه نهان افزایش‌یافته‌ای نشان دهند. این ازدست‌دادن‌ها ممکن است با افزایش پیام‌های خطا در گزارش‌های MP همراه باشد، مشابه:

InvalidClassException when fetching cps cache entry from second level - com.apigee.jsonparser.LinkedJSONObject; local class incompatible: stream classdesc serialVersionUID = -8575741446425131573, local class serialVersionUID = 752634431212433936. Considering it as cache miss.

راهکار موقت:

هیچ‌کدام. انتظار می‌رود نسبت اصابت حافظه نهان درطول زمان تثبیت شود.

159858015

پاسخ HTTP 408 برای درخواست GET با بدنه خالی و Content-Encoding: gzip.

وقتی کارخواه API درخواست GET را با سرایند Content-Encoding: gzip و بدنه درخواست خالی ارسال می‌کند، پاسخ «۴۰۸ زمان‌بندی» دریافت می‌کند.

راهکار موقت:

هنگام ایجاد درخواست‌های GET با بدنه خالی، سرایند Content-Encoding را حذف کنید.

مرحله بعدی

برای شروع کار با Edge for Private Cloud 4.50.00، از پیوندهای زیر استفاده کنید:

تاسیسات جدید:
نمای کلی نصب جدید
تاسیسات موجود:
مسیرها را ارتقا دهید