‫4.52.00.03 - یادداشت‌های انتشار Edge for Private Cloud

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

در ۲۵ اکتبر ۲۰۲۳، نسخه جدیدی از Apigee Edge for Private Cloud منتشر کردیم.

توجه: این نسخه تا ۲۵ اکتبر ۲۰۲۴ پشتیبانی خواهد شد.

به‌روزرسانی رویه

این بخش نحوه نصب این نسخه را درصورتی‌که از نسخه قبلی Edge for Private Cloud به‌روزرسانی می‌کنید شرح می‌دهد. اگر نیاز دارید از نسخه قبلی به‌روزرسانی کنید، به اعمال کردن چند نسخه وصله مراجعه کنید.

به‌روزرسانی این نسخه باعث به‌روزرسانی مؤلفه‌های فهرست زیر از بسته‌های RPM خواهد شد:

  • edge-gateway-4.52.00-0.0.60200.noarch.rpm
  • edge-management-server-4.52.00-0.0.60200.noarch.rpm
  • edge-message-processor-4.52.00-0.0.60200.noarch.rpm
  • edge-postgres-server-4.52.00-0.0.60200.noarch.rpm
  • edge-qpid-server-4.52.00-0.0.60200.noarch.rpm
  • edge-router-4.52.00-0.0.60200.noarch.rpm
  • apigee-sso-4.52.00-0.0.21316.noarch.rpm
  • edge-analytics-4.52.00-0.0.40100.noarch.rpm
  • edge-management-ui-4.52.00-0.0.20029.noarch.rpm
  • edge-ui-4.52.00-0.0.20233.noarch.rpm
  • apigee-service-4.52.00-0.0.1500.noarch.rpm
  • apigee-mirror-4.52.00-0.0.1032.noarch.rpm
  • apigee-tomcat-9.0.82-0.0.939.noarch.rpm
  • apigee-configutil-4.52.00-0.0.624.noarch.rpm

با وارد کردن دستور زیر می‌توانید نسخه‌های RPM نصب‌شده فعلی را بررسی کنید تا ببینید نیاز به به‌روزرسانی دارند یا نه:

apigee-all version

برای به‌روزرسانی نصب، روی گره‌های Edge، روش زیر را انجام دهید:

  1. در همه گره‌های Edge:

    1. مخازن Yum را پاک کنید:
      sudo yum clean all
    2. جدیدترین فایل Edge 4.52.00 bootstrap_4.52.00.sh را در /tmp/bootstrap_4.52.00.sh بارگیری کنید:
      curl https://software.apigee.com/bootstrap_4.52.00.sh -o /tmp/bootstrap_4.52.00.sh
    3. ابزار و وابستگی‌های Edge 4.52.00 apigee-service را نصب کنید:
      sudo bash /tmp/bootstrap_4.52.00.sh apigeeuser=uName apigeepassword=pWord

      که در آن uName و pWord نام کاربری و گذرواژه‌ای است که از Apigee دریافت کرده‌اید. اگر pWord را حذف کنید، از شما خواسته می‌شود آن را وارد کنید.

    4. از فرمان source برای اجرای اسکریپت apigee-service.sh استفاده کنید:
      source /etc/profile.d/apigee-service.sh
  2. در همه گره‌های Edge، اسکریپت update.sh را برای فرایند لبه اجرا کنید:
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  3. نوشتار update.sh را برای SSO در همه گره‌ها اجرا کنید:
  4. /opt/apigee/apigee-setup/bin/update.sh -c sso -f configFile
  5. در همه گره‌های واسط کاربر، دستورگان update.sh را برای واسط کاربر اجرا کنید:
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  6. اگر از تجربه «Edge جدید» استفاده می‌کنید، فرمان زیر را اجرا کنید:
    /opt/apigee/apigee-setup/bin/update.sh -c ue -f configFile

مشکلات امنیتی برطرف شد

در این نسخه پخش، مشکلات امنیتی شناخته‌شده زیر برطرف شده است. برای جلوگیری از این مشکلات، جدیدترین نسخه Edge for Private Cloud را نصب کنید.
شناسه مشکل شرح
279065506 در نشانی وب هدایت مجدد برای OAuth2، آنتروپی پارامتر حالت بهبود یافته است تا غیرقابل پیش‌بینی شود، به‌منظور جلوگیری از آسیب‌پذیری «جعل درخواست بین‌سایتی» (CSRF).",
279065586 خط‌مشی‌های امنیت محتوا در سرایند اضافه شد تا لایه امنیتی بیشتری برای سایت‌ها دربرابر حملات سمت مشتری فراهم شود.

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

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

  • ‫Red Hat Enterprise Linux (‏Intel‏ ۶۴ بیتی): نسخه ۸.۸
  • ‫Oracle Linux (‏Intel‏ ۶۴ بیت): نسخه‌های ۷.۹،‏ ۸.۷، و ۸.۸
  • Rocky Linux 8
  • Tomcat 9.0.82

برای فهرست کامل نرم‌افزارهای پشتیبانی‌شده، نرم‌افزار پشتیبانی‌شده Edge برای «ابر خصوصی» را ببینید.

منسوخ شدن و بازنشستگی

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

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

این نسخه پخش ویژگی‌های جدید زیر را معرفی می‌کند:

حداکثر تعداد نویسه‌ها را برای نام‌های سازمان و محیط تنظیم کنید

با این نسخه، هنگام ایجاد سازمان یا محیط جدید می‌توانید حداکثر تعداد نویسه‌ها را برای نام‌های سازمان و محیط محدود کنید. مقدار پیش‌فرض برای حداکثر تعداد نویسه‌ها ۲۵۵ است. برای تنظیم حداکثر پایین‌تر، ویژگی‌های زیر را در فایل ویژگی مربوطه تنظیم کنید:

  • در فایل دارایی سازمان، org.name.max.length را تنظیم کنید.
  • در فایل دارایی سازمان، env.name.max.length را تنظیم کنید.

اگر هریک از این دارایی‌ها روی مقداری کمتر از ۰ یا بیشتر از ۲۵۵ تنظیم شود، سیستم به‌ترتیب از مقدار بیشینه ۱ یا ۲۵۵ استفاده خواهد کرد.

تنظیم انقضای کدهای دسترسی

با این نسخه پخش، می‌توانید انقضای کد دسترسی را با تنظیم کردن دارایی conf_keymanagement_oauth_access_token_expiry_time_in_millis روی زمان انقضای موردنظر به میلی‌ثانیه تنظیم کنید. این ویژگی به‌طور پیش‌فرض غیرفعال است. برای فعال کردن آن، conf_keymanagement_oauth_access_token_is_apply_limit را روی true در «پردازشگر پیام» تنظیم کنید.

این ویژگی به سرپرستان Apigee امکان می‌دهد کنترل بهتری بر انقضای کدهای دسترسی ایجادشده در Apigee داشته باشند.

رفع اشکال‌ها

این بخش فهرست اشکالات «ابر خصوصی» را که در این نسخه اصلاح شده است ارائه می‌دهد.

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

وقتی متغیر ServiceCallout.response در «پوشش داده» استفاده شد، خط‌مشی‌ها در ردیابی قابل‌مشاهده نبود.

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

مشکلی در «الگوهای ایمیل» مانع از ارسال نویسه‌های چند بایتی در ایمیل شد.

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

مشکلی وجود داشت که در آن منو سمت راست هنگام تغییر سازمان‌ها در «میانای کاربری Edge» جدید ناپدید می‌شد.

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

وابستگی‌های Analytics در گره‌های سرور مدیریت به‌طور خودکار ارتقا پیدا نمی‌کرد.

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

بررسی راه‌اندازی اولیه اضافه شد تا اطمینان حاصل شود که postgresql درطول فرایند ارتقا برداشته/حذف نمی‌شود.

279065586

در نشانی وب هدایت مجدد برای OAuth2، آنتروپی پارامتر حالت بهبود یافته است تا غیرقابل پیش‌بینی شود و از آسیب‌پذیری «جعل درخواست بین‌سایتی» (CSRF) جلوگیری شود.

283310836

پیام خطا هنگام تجزیه کردن فایل‌های XML بزرگ بهبود یافته است.

245936798

مشکلی در نام‌های سازمان و محیط باعث می‌شد پُرسمان‌های Postgresql <code<create< code="" dir="ltr" translate="no"> ناموفق باشد.</code<create<>

این مشکل با بهبود مدیریت تداخل نام شاخص postgres برای نام‌های طولانی سازمان و محیط برطرف شده است.
293733533

کتابخانه طرف سوم Spring در Edge اجزای «دروازه» از نسخه ۵.۳.۲۰ به نسخه ۵.۳.۲۷ به‌روز شده است.

294363158

یک پسرفت باعث شده بود برخی‌از ابعاد اضافی در منوهای کرکره‌ای صفحات تجزیه‌وتحلیل و نظارت واسط کاربری Edge نشان داده شود.

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

دارایی‌های تولیدشده توسط apigee-mirror اکنون مالکیت صحیح را دارند.

294989027

عملکرد بهبودیافته برخی‌از «میاناهای برنامه‌سازی کاربردی آمار».

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

برای فهرست کامل مشکلات شناخته‌شده، مشکلات شناخته‌شده Edge for Private Cloud را ببینید.

اعمال کردن چندین نسخه وصله

این بخش نحوه اعمال چندین نسخه وصله را درصورتی‌که از نسخه Edge for Private Cloud قدیمی‌تر از نسخه انتشار وصله قبلی به‌روزرسانی می‌کنید توضیح می‌دهد.

هر نسخه وصله حاوی به‌روزرسانی‌هایی برای اجزای خاصی از Edge برای «ابر خصوصی» است، مثل edge-management-server. برای اعمال چند نسخه وصله، باید هریک از عناصر Edge را که در نسخه وصله‌ای جدیدتر از نسخه نصب‌شده فعلی شما گنجانده شده است به‌روزرسانی کنید. با بررسی یادداشت‌های انتشار Edge for Private Cloud برای همه نسخه‌های جدیدتر از نسخه فعلی‌تان و بررسی فهرست RPM برای آن انتشارها می‌توانید این عناصر را پیدا کنید. برای دریافت پیوند به همه یادداشت‌های انتشار Edge for Private Cloud، یادداشت‌های انتشار Apigee را ببینید.

توجه: فقط یک‌بار باید هر عنصر را با نصب کردن RPM برای جدیدترین نسخه عنصر موجود در نسخه‌های وصله به‌روز کنید. برای به‌روزرسانی عنصر، دستورالعمل‌های موجود در یادداشت‌های انتشار آن نسخه را دنبال کنید.

توجه: ارتقا دادن یک عنصر به‌طور خودکار جدیدترین نسخه وصله آن عنصر را نصب می‌کند. اگر می‌خواهید به نسخه وصله‌ای ارتقا دهید که جدیدترین نسخه نیست، باید بااستفاده از Apigee mirror، نسخه tarball مخزن Apigee را حفظ کنید و از این آینه برای نصب‌های Apigee استفاده کنید. برای اطلاعات بیشتر، به استفاده از مخزن محلی Edge برای حفظ نسخه Edge مراجعه کنید.