4.16.05 - Edge for Private Cloud یادداشت های انتشار

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

در روز سه‌شنبه، ۳۱ مه ۲۰۱۶، نسخه جدیدی از Apigee Edge را برای فضای ابری خصوصی منتشر کردیم.

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

برای درک چگونگی تشخیص اینکه آیا یک نسخه ابری خاص در نسخه Edge شما برای Private Cloud گنجانده شده است یا خیر، به «درباره شماره‌گذاری نسخه‌ها» مراجعه کنید.

ویژگی‌ها و پیشرفت‌های جدید

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

برای جزئیات و دستورالعمل‌های بیشتر، به مستندات Edge for Private Cloud مراجعه کنید.

راهنماهای نصب و عملیات به صورت آنلاین منتشر شدند

اکنون می‌توانید به راهنمای نصب و راه‌اندازی Edge برای ابر خصوصی در نسخه ۴.۱۸.۰۱ دسترسی داشته باشید.

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

به‌روزرسانی‌های نرم‌افزاری زیر در این نسخه گنجانده شده‌اند:

  • Java JDK 1.8 - برای بهره‌مندی از جدیدترین ویژگی‌های جاوا، این نسخه با جاوا ۱.۸ سازگار است. Oracle JDK 1.8 یا OpenJDK 8 در محیط شما مورد نیاز است.
    به عنوان بخشی از به‌روزرسانی جاوا ۸، برخی از رمزهای TLS دیگر در Oracle JDK 1.8 در دسترس نیستند. برای مشاهده لیست کامل، به بخش "مجموعه‌های رمز غیرفعال پیش‌فرض" مراجعه کنید http://docs.oracle.com/javase/8/docs/technotes/guides/security/SunProviders.html .
  • کاساندرا ۲.۱.۱۳ - به‌روزرسانی‌شده از کاساندرا ۲.۰.۱۵.

نصب، ارتقا، بازگشت به حالت اولیه

در ادامه لیستی از تغییرات در نصب، ارتقا و اسکریپت‌های مرتبط آمده است. برای اطلاعات بیشتر در مورد نحوه‌ی استفاده، به مستندات Edge for Private Cloud مراجعه کنید.

  • فرآیند جدید برای به‌روزرسانی از ۴.۱۶.۰۱ - این نسخه، ابزار apigee-migrate را با ابزار update.sh جایگزین می‌کند تا نصب شما را از ۴.۱۶.۰۱ به ۴.۱۶.۰۵ به‌روزرسانی کند. به بخش به‌روزرسانی Apigee Edge 4.16.01 به ۴.۱۶.۰۵ مراجعه کنید.
  • بوت‌استرپ
    • bootstrap.sh (نسخه ۴.۱۶.۰۱) اکنون در نسخه ۴.۱۶.۰۵ bootstrap_4.16.05.sh است.
    • دیگر نیازی به مشخص کردن uname:pword برای دانلود bootstrap_4.16.05.sh ندارید.
  • بازگرداندن به نسخه قبلی - برای بازگرداندن به‌روزرسانی به نسخه ۴.۱۶.۰۵، نسخه ۴.۱۶.۰۵ کامپوننت را حذف نصب کرده و نسخه قبلی را دوباره نصب می‌کنید. ابزار rollback.sh قبلی حذف شده است. به فرآیند بازگرداندن به نسخه ۴.۱۶.۰۵ مراجعه کنید.
  • setup.sh و update.sh می‌توانند فایل لاگ را در /tmp بنویسند - به طور پیش‌فرض، ابزارهای setup.sh و update.sh اطلاعات لاگ را در /opt/apigee/var/log/apigee-setup می‌نویسند. اگر کاربری که این ابزار را اجرا می‌کند به آن دایرکتوری دسترسی نداشته باشد، لاگ را در دایرکتوری /tmp می‌نویسد. اگر کاربر به /tmp دسترسی نداشته باشد، این ابزار از کار می‌افتد.
  • روش به‌روزرسانی API BaaS - در نسخه ۴.۱۶.۰۱، برای مهاجرت API BaaS باید آن را دوباره نصب می‌کردید. ابزار جدید update.sh از به‌روزرسانی API BaaS در محل پشتیبانی می‌کند. به به‌روزرسانی Apigee Edge از ۴.۱۶.۰۱ به ۴.۱۶.۰۵ مراجعه کنید.

اداره

در ادامه ویژگی‌های جدیدی برای مدیریت و پیکربندی Private Cloud ارائه شده است.

  • اعتبارسنجی نصب - ابزار apigee-validate که برای آزمایش نصب Edge Private Cloud شما استفاده می‌شود، اکنون می‌تواند از سرور مدیریت اجرا شود. پیش از این، اسکریپت باید روی پردازنده پیام اجرا می‌شد. به بخش «آزمایش نصب» مراجعه کنید.
  • نام منطقه - منطقه می‌تواند هر نامی باشد. در نسخه‌های قبلی، نام به شکل "dc-#" بود، که در آن # یک مقدار صحیح بود.
  • پادهای دروازه‌ای - پادهای دروازه‌ای می‌توانند هر نامی داشته باشند. در نسخه‌های قبلی، پاد باید «دروازه» نامگذاری می‌شد.
  • مدیریت مبتنی بر اسکریپت - یک ابزار خط فرمان جدید apigee-adminapi.sh به شما امکان می‌دهد همان وظایف پیکربندی Edge را که با فراخوانی API مدیریت Edge انجام می‌دهید، انجام دهید. به بخش استفاده از ابزار apigee-adminapi.sh مراجعه کنید.
  • پیکربندی بی‌صدای SSL میزبان مجازی - هنگام ایجاد یک سازمان یا محیط، اکنون می‌توانید ویژگی‌هایی را برای پیکربندی SSL روی یک میزبان مجازی ارسال کنید. به Onboard an organization مراجعه کنید.

خدمات API

در ادامه ویژگی‌های جدیدی برای سرویس‌های Edge API ارائه شده است که در نسخه‌های ابری قبلی این محصول ارائه شده بودند.

پیشوند با طول ثابت برای ثبت پیام‌های syslog (Cloud 16.03.30)

سیاست ثبت پیام‌ها (Message Logging) یک عنصر جدید <FormatMessage> در پیکربندی Syslog دارد. با تنظیم <FormatMessage>true</FormatMessage> ، پیام‌های Syslog با تعداد ثابتی کاراکتر شروع می‌شوند که به شما امکان می‌دهد داده‌های درج‌شده توسط Apigee را فیلتر کنید. برای اطلاعات بیشتر، به سیاست ثبت پیام‌ها (Message Logging) مراجعه کنید. (APIRT-1398)

Wildcard در مسیر پایه پروکسی API (رابط کاربری Cloud 16.03.09)

رابط کاربری مدیریت از استفاده از یک یا چند کاراکتر وایلد /*/ در مسیرهای پایه پروکسی API پشتیبانی می‌کند. برای مثال، یک مسیر پایه /team/*/members به ​​کلاینت‌ها اجازه می‌دهد تا پروکسی شما را با https://[host]/team/blue/members یا https://[host]/team/green/members فراخوانی کنند، بدون اینکه شما مجبور باشید یک پروکسی جدید برای پشتیبانی از تیم‌های جدید ایجاد کنید. توجه داشته باشید که /**/ مجاز نیست. (MGMT-3154)

زنجیره‌سازی پروکسی API (رابط کاربری Cloud 16.03.02، Cloud 16.03.09)

Edge از زنجیره‌سازی پروکسی API محلی پشتیبانی می‌کند، که به یک پروکسی API اجازه می‌دهد تا بدون سربار شبکه اضافی، با پروکسی API دیگری که در سازمان Edge شما مستقر شده است، تماس بگیرد. پیش از این، زنجیره‌سازی پروکسی API نیاز به یک فراخوانی http(s) به پروکسی API دیگری داشت که درخواست را از طریق یک متعادل‌کننده بار، روتر و پردازنده پیام ارسال می‌کرد.

عناصر جدید LocalTargetConnection در TargetEndpoint یک پروکسی API موجود هستند که به شما امکان می‌دهند نام یک پروکسی API، نام یک ProxyEndpoint خاص در یک پروکسی API یا به سادگی مسیر پایه به یک منبع پروکسی API محلی (مانند /v1/myresource) را مشخص کنید. رابط کاربری ویرایشگر پروکسی نیز این گزینه‌ها را هنگام اضافه کردن یا به‌روزرسانی یک TargetEndpoint ارائه می‌دهد.

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

برای اطلاعات بیشتر، به بخش «زنجیره‌بندی پروکسی‌های API با هم » مراجعه کنید. عناصر جدید LocalTargetConnection همچنین در طرح XML اینجا فهرست شده‌اند: https://github.com/apigee/api-platform-samples/blob/master/schemas/configuration/configuration_schemas.xsd (MGMT-3049، MGMT-3050)

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

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

لبه برای ابر خصوصی ۴.۱۶.۰۵

شناسه مسئله توضیحات
PRC-770 نصب‌کننده‌ی نسخه ۱۶.۰۱ نمی‌تواند سرور آماده به کار Postgres را در axgroup ثبت کند.
PRC-758 کاربر با نقش کاربری قادر به ویرایش گزارش‌های سفارشی است
PRC-883 به‌روزرسانی سرور Postgres با پیکربندی master-standby با شکست مواجه می‌شود.

ابر ۱۶.۰۳.۳۰

شناسه مسئله توضیحات
سِنگ-۵۸۴ بررسی اعتبارسنجی برای خط جدید بین گواهی‌ها در یک زنجیره گواهی، باعث ایجاد مشکل در برخی از گواهی‌ها در محیط عملیاتی می‌شود.
MGMT-3217 اگر نام KVMap به "keys" ختم شود، فراخوانی‌های API مدیریت با شکست مواجه می‌شوند.
MGMT-3214 تداخل کلاس‌ها می‌تواند در طول JavaCalloutها رخ دهد و باعث از کار افتادن کد جاوای مشتری شود.
MGMT-3185 خطا هنگام اضافه کردن مدیران سازمان به یک سازمان
EDGEUI-127 دریافت مجوزهای ناکافی با ویرایشگر پروکسی جدید
EDGEUI-119 مشکل اتمام زمان جلسه رابط کاربری
کورسرو-۶۷۱ مشاهده خطاهای "هیچ حلقه‌ای پیکربندی نشده است؛ نمی‌توان سرویس cps را مقداردهی اولیه کرد"
AXAPP-2345 مشکل در فهرست کردن گزارش‌های سفارشی AX برای مشتریان غیر cps
AXAPP-2302 خلاصه تحلیل‌های روزانه Apigee نشان می‌دهد که میزان پذیرش توسعه‌دهندگان صفر است.
APIRT-2750 خرابی‌های ترافیکی در سازمان‌های خاص زیاد است
APIRT-2516 خطاهای زمان اجرا در فراخوانی‌های جاوا اسکریپت، شماره خطوط نادرست را مشخص می‌کنند.
APIRT-2508 خطای خروج هنگام فراخوانی express listen در یک فراخوانی برگشتی vault
APIRT-2336 مشکل Gzip با Node.js
APIRT-1975 پیکربندی‌های ماسک برای message.content کار نمی‌کنند

رابط کاربری ابری ۱۶.۰۳.۱۶

شناسه مسئله توضیحات
MGMT-3142 نمودارها در داشبورد تحلیل خطا بارگذاری نمی‌شوند (رفع مشکل به‌روزرسانی شده)

رابط کاربری ابری ۱۶.۰۳.۰۹

شناسه مسئله توضیحات
MGMT-3158 مجوزهای ناکافی در رابط کاربری، زمانی که RBAC روی پروکسی‌های منفرد از طریق API تنظیم می‌شود.
MGMT-3142 نمودارها در داشبورد تحلیل خطا بارگذاری نمی‌شوند
MGMT-3118 رابط کاربری، پیکربندی میزبان مجازی SSL نادرستی را برای پارامتر "clientAuthEnabled" نمایش می‌دهد.
DEVRT-2344 تعاریف گزارش‌های یک روزه، تراکنش‌ها را در رابط کاربری بارگذاری نمی‌کنند

ابر ۱۶.۰۳.۰۲

شناسه مسئله توضیحات
MGMT-3083 به‌روزرسانی خودکار لاگ‌های Node.js بیش از حد شامل پیام‌های لاگ است.
DEVRT-2275 طرح‌های نرخ ویژگی سفارشی فقط ۵ ویژگی را به جای ۱۰ ویژگی مجاز نشان می‌دهند
DEVRT-1275 همه توسعه‌دهندگان در منوی کشویی طرح نرخ نمایش داده نمی‌شوند
DEVRT-1074 توسعه‌دهنده‌ی پیش‌پرداخت با موجودی صفر، هنگام اعمال اعتبار، خطای NullpointerException را صادر می‌کند.

ابر ۱۶.۰۲.۱۷

شناسه مسئله توضیحات
MGMT-3083 به‌روزرسانی خودکار لاگ‌های Node.js بیش از حد شامل پیام‌های لاگ است.
MGMT-3077 رابط کاربری یک بسته پروکسی نامعتبر از WSDL تولید می‌کند که از فضای نام پیش‌فرض استفاده می‌کند.
MGMT-1642 نقش کاربر سفارشی مجوز "دریافت" برای برنامه‌های توسعه‌دهنده را ندارد.

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

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

شناسه مسئله توضیحات
APIRT-2978

روتر در شروع Nginx ناموفق بود یا روتر شروع به کار نکرد

اگر روتر Edge نتوانست Nginx را شروع کند یا اصلاً شروع نشد، همانطور که در فایل /opt/apigee/var/log/edge-router/logs/system.log نشان داده شده است، تمام فایل‌های موجود در دایرکتوری /opt/nginx/conf.d را حذف کنید و روتر را مجدداً راه‌اندازی کنید:

> rm -f /opt/nginx/conf.d/*
> /opt/apigee/apigee-service/bin/apigee-service edge-router restart
APIRT-3364

پردازشگر پیام، جستجوی DNS را روی IPv4 و IPv6 انجام می‌دهد.

اگر NSCD (Name Service Cache Daemon) را نصب و فعال کرده باشید، ممکن است متوجه شده باشید که پردازنده‌های پیام دو جستجوی DNS انجام می‌دهند: یکی برای IPv4 و دیگری برای IPv6.

برای غیرفعال کردن جستجوی DNS در IPv6:

  1. در هر گره پردازشگر پیام، فایل /etc/nscd.conf را ویرایش کنید.
  2. ویژگی زیر را تنظیم کنید:

    میزبان‌های enable-cache شماره
PRC-1118

خطا هنگام اجرای دستور "apigee-service apigee-postgresql pg-data-purge"

اگر دستور "apigee-service apigee-postgresql pg-data-purge" را اجرا کنید و خطایی در فرم زیر مشاهده کنید:

خطا: باید مالک رابطه باشد

فایل /opt/apigee/apigee-postgresql-4.16.05-0.0.894/lib/actions/pg-data-purge را ویرایش کرده و ویژگی زیر را روی 'apigee' تنظیم کنید:

POSTGRES_USER=آپیجی

DOC-1687 به دلیل یک تداخل وابستگی بسته شناخته‌شده، عامل Katello که در Satellite Server 6 استفاده می‌شود، روی میزبان‌های Apigee Edge که سرویس Qpid را اجرا می‌کنند، به درستی نصب نمی‌شود.

بارهای داده JSON در سیاست‌های Assign Message، Java Callout و Raise Fault

سیاست‌های Assign Message، Java Callout و Raise Fault به شما امکان می‌دهند محتوای پیام را با استفاده از عنصر <Set><Payload> تولید کنید. به عنوان بخشی از این پیام‌ها، می‌توانید متغیرهایی را که مقادیر آنها در زمان اجرا به طور خودکار پر می‌شوند، وارد کنید. به عنوان مثال، اگر می‌خواهید تاریخ را از هدر HTTP خروجی بگیرید، می‌توانید {message.header.date} را در پیام خود وارد کنید.

اگر فرمت پیام JSON باشد، چیزی شبیه به این خواهد بود:

{"The date is: " : "{message.header.date}"}

با این حال، می‌توانید ببینید که این JSON ناقص است. برای حل این مشکل، دو گزینه دارید:

  • با استفاده از یک بک اسلش، آکولاد آغازین را از حالت فشرده خارج کنید: 
    \{"The date is: " : "{message.header.date}"}
  • در پیکربندی عنصر Payload، از ویژگی‌های variablePrefix و variableSuffix برای نشان دادن یک متغیر در یک payload از نوع JSON استفاده کنید. برای مثال:
    <Payload contentType="application/json" variablePrefix="#" variableSuffix="%">{"The date is: " : "#message.header.date%"}</Payload>

در نسخه بعدی ویژگی Edge برای ابر خصوصی، شما قادر خواهید بود بدون مشکل از آکولاد برای متغیرها در پیام‌های JSON استفاده کنید. (APIRT-1160)

روتر در شروع Nginx ناموفق بود یا روتر شروع به کار نکرد

اگر روتر Edge نتوانست Nginx را شروع کند یا اصلاً شروع نشد، همانطور که در فایل /opt/apigee/var/log/edge-router/logs/system.log نشان داده شده است، تمام فایل‌های موجود در دایرکتوری /opt/nginx/conf.d را حذف کنید و روتر را مجدداً راه‌اندازی کنید:

> rm -f /opt/nginx/conf.d/*
> /opt/apigee/apigee-service/bin/apigee-service edge-router restart
قبلی
4.16.05.01
بعدی
4.16.01.08