4.18.05 Edge for Private Cloud release notes

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

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

خلاصه انتشار

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

ویژگی‌های جدید ○ «خط‌مشی‌های JWT» اکنون «عموماً دردسترس» (GA) است
○ اکنون از RedHat Enterprise Linux 6.9 پشتیبانی می‌شود
○ اکنون از Oracle Linux 6.9 پشتیبانی می‌شود
○ اکنون از CentOS 6.9 پشتیبانی می‌شود
○ تغییرات پیکربندی نصب تجربه جدید Edge
○ اکنون گزینه‌های تلاش مجدد رهیاب را می‌توان در سطح میزبان مجازی تنظیم کرد
نسخه‌های پخش گنجانده‌شده
○ Edge UI:
   18.04.04
   18.03.02
   18.02.14
   17.11.06 		○ مدیریت/زمان اجرای Edge:
   18.04.06
   18.04.04
   18.03.02
   18.02.02
   18.01.05
 ○ درگاه:
   18.04.25.01
   18.04.25.00
   18.04.23.00
   18.03.28.00
   18.03.05.00
   18.02.15.00
   18.01.31.00
   17.12.20.00
بازنشستگی‌ها ○ API BaaS
○ داشبورد پایش (نسخه بتا)
منسوخ شدن‌ها ○ فروشگاه‌های امن Apigee (گاوصندوق‌ها) با KVM جایگزین شد
○ افزودن مسیرها در برگه «عملکرد» پراکسی API
○ دارایی SMTPSSL برای درگاه «خدمات توسعه‌دهندگان»
رفع اشکال‌ها ○ جلوگیری از تغییر نشانی ایمیل کاربر (۶۵۵۵۰۶۳۸)
○ آسیب‌پذیری امنیتی در jackson-databind (۶۹۷۱۱۶۱۶)
○ نشت حافظه در «پردازشگرهای پیام» (۷۱۶۱۲۵۹۹)
مشکلات شناخته‌شده

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

○ پشتیبان «پردازشگر پیام» از مجموعه صحیح فایل‌ها پشتیبان‌گیری نمی‌کند (۱۲۱۰۹۵۱۴۸)
○ HEAD درخواست‌های هدف‌های Node.js معلقه می‌شود (۷۹۹۹۳۲۴۷)
○ گزینه ایجاد پراکسی معکوس ازطریق Open API نمایش داده می‌شود (۷۹۹۴۹۱۴۲)
○ نام‌های میزبان حل‌وفصل نمی‌شوند (۷۹۷۵۷۵۵۴)
○ خطاهای DataAccessExceptions در پیکربندی‌های چند مرکز داده (۷۶۰۸۷۱۶۶)
○ پیام خطای اجازه هنگام توقف apigee-postgresql ظاهر می‌شود (۷۲۳۷۹۸۳۴)
○ خط‌مشی MessageLogging اطلاعات اضافی را در پیام گزارش اضافه می‌کند (۶۸۷۲۲۱۰۲)

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

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

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

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

از ۴.۱۸.۰۱ مستقیماً از ۴.۱۸.۰۱ به ۴.۱۸.۰۵ ارتقا دهید
از ۴.۱۷.۰۹ مستقیماً از ۴.۱۷.۰۹ به ۴.۱۸.۰۵ ارتقا دهید
از ۴٫۱۷٫۰۵ مستقیماً از ۴.۱۷.۰۵ به ۴.۱۸.۰۵ ارتقا دهید
از ۴.۱۷.۰۱ از ۴.۱۷.۰۱ به ۴.۱۸.۰۱ ارتقا دهید، سپس از ۴.۱۸.۰۱ به ۴.۱۸.۰۵ ارتقا دهید
از ۴.۱۶.۰۹ از ۴.۱۶.۰۹ به ۴.۱۸.۰۱ ارتقا دهید، سپس از ۴.۱۸.۰۱ به ۴.۱۸.۰۵ ارتقا دهید
از ۴.۱۶.۰۵ از ۴.۱۶.۰۵ به ۴.۱۸.۰۱ ارتقا دهید، سپس از ۴.۱۸.۰۱ به ۴.۱۸.۰۵ ارتقا دهید
از ۴/۱۶/۰۱ از ۴.۱۶.۰۱ به ۴.۱۸.۰۱ ارتقا دهید، سپس از ۴.۱۸.۰۱ به ۴.۱۸.۰۵ ارتقا دهید
از نسخه 4.15.0x از نسخه 4.15.0x به 4.16.01 ارتقا دهید، سپس از نسخه 4.16.01 به 4.18.01 ارتقا دهید، سپس از نسخه 4.18.01 به 4.18.05 ارتقا دهید

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

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

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

خط‌مشی‌های JWT

خط‌مشی‌های JWT زیر دیگر در نسخه بتا نیستند؛ اکنون در GA هستند:

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

این «انتشار ویژگی» شامل تغییرات زیر در نرم‌افزار پشتیبانی‌شده است:

  • اکنون از Red Hat Enterprise Linux (RHEL) 6.9 پشتیبانی می‌شود
  • اکنون از Oracle Linux 6.9 پشتیبانی می‌شود
  • اکنون از CentOS 6.9 پشتیبانی می‌شود
  • ‫RHEL/CentOS/Oracle Linux 7.2 دیگر پشتیبانی نمی‌شود

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

تغییرات پیکربندی نصب تجربه جدید Edge

نسخه ۴.۱۸.۰۵ تجربه «New Edge» حاوی تغییراتی در فایل پیکربندی از نسخه ۴.۱۸.۰۱ است. دارایی‌های جدید در نصب تغییرات پیکربندی از Edge 4.18.01 توضیح داده شده است.

اکنون می‌توان گزینه‌های تلاش مجدد مسیریاب را در سطح میزبان مجازی تنظیم کرد

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

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

بُعد Analytics جدید و تغییر در بُعد x_forwarded_for_ip

نحوه تنظیم بُعد x_forwarded_for_ip در Edge Analytics تغییر کرده است. قبلاً، اگر چندین نشانی IP در سرایند X-Forwarded-For وجود داشت، ابعاد x_forwarded_for_ip فقط آخرین نشانی IP فهرست‌شده را دربرمی‌گرفت. مشتریان اغلب از بُعد x_forwarded_for_ip برای تعیین نشانی IP کارخواهی که درخواست API را به Edge ارسال می‌کند استفاده می‌کردند.

با این نسخه پخش، بُعد x_forwarded_for_ip اکنون حاوی فهرست کامل نشانی‌های IP در سرایند X-Forwarded-For است.

هشدار: سرصفحه X-Forwarded-For این پتانسیل را دارد که توسط نشانی IP که دسترسی آن رد شده است جعل شود، به‌جز آخرین نشانی در سرصفحه که نشانی IP است که Edge از آخرین دست‌دهی TCP خارجی دریافت کرده است. برای تعیین نشانی IP مشتری اصلی که درخواست «میانای برنامه‌سازی کاربردی» را به Edge ارسال می‌کند، این نسخه بُعد جدیدی به Edge Analytics اضافه می‌کند: ax_resolved_client_ip.

اکنون می‌توانید از بُعد ax_resolved_client_ip در گزارش سفارشی یا در شرط فیلتر در گزارش سفارشی برای تعیین نشانی IP مشتری که درخواست API را ارسال می‌کند استفاده کنید. برای اطلاعات بیشتر درباره بُعد ax_resolved_client_ip، به مرجع سنجه‌ها، ابعاد، و فیلترهای Analytics مراجعه کنید.

این تغییر همچنین بر نحوه مدیریت سرصفحه X-Forwarded-For توسط خط‌مشی AccessControl تأثیر می‌گذارد. در این نسخه پخش، Edge به‌طور خودکار سرصفحه X-Forwarded-For HTTP را با نشانی IP تکی که از آخرین دست‌دهی TCP خارجی (مثل نشانی IP مشتری یا مسیریاب) دریافت کرده است تکمیل می‌کند. در نسخه‌های قبلی، Edge سرایند X-Forwarded-For اچ‌تی‌تی‌پی را با نشانی IP تکی که از دست‌دهی TCP خارجی اولین (مثل IP کارخواه یا رهیاب) دریافت کرده بود تنظیم می‌کرد. برای اطلاعات بیشتر، درباره سرایند HTTP «X-Forwarded-For» را ببینید.

نسخه‌های پخش گنجانده‌شده

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

میانای کاربر Edge مدیریت/زمان اجرای لبه درگاه
18.04.04
18.03.02
18.02.14
17.11.06 		18.04.06
18.04.04
18.03.02*
18.02.02
18.01.05
 18.04.25.01
18.04.25.00
18.04.23.00
18.03.28.00
18.03.05.00
18.02.15.00
18.01.31.00
17.12.20.00
* رفع اشکال ۷۴۶۲۲۴۹۹ در نسخه Edge for Private Cloud 4.18.05 گنجانده نشده است.

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

بازنشستگی‌ها

این بخش ویژگی‌هایی را که در این «انتشار ویژگی» بازنشسته شده‌اند شرح می‌دهد.

API BaaS

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

داشبورد پایش (نسخه بتا)

«داشبورد پایش» (نسخه بتا) بازنشسته شده است و دیگر پشتیبانی نخواهد شد. درنتیجه، اجزای زیر دیگر بخشی از نصب نیستند:

  • apigee-influxdb
  • apigee-telegraf
  • apigee-grafana

برای ادامه دریافت سنجه‌های «مسیریاب»، «پردازشگر پیام»، و گره، Apigee توصیه می‌کند که از JMX برای ادغام داده‌های Edge for Private Cloud با ابزارهای پایش خودتان استفاده کنید. برای اطلاعات بیشتر، چه چیزی را پایش کنیم و چگونه پایش کنیم را ببینید.

اگر نصب موجود را به نسخه ۴.۱۸.۰۵ ارتقا دهید، باید «داشبورد پایش» را حذف نصب کنید. ‫Apigee تضمین نمی‌کند که این ویژگی همچنان طبق انتظار عمل کند.

منسوخ‌سازی‌ها

ویژگی‌های زیر در این «نسخه ویژگی» منسوخ شدند.

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

فروشگاه ایمن Apigee (گاوصندوق‌ها)

فروشگاه امن Apigee که با نام «گاوصندوق» نیز شناخته می‌شود، درحال منسوخ شدن است و در سپتامبر ۲۰۱۸ بازنشسته خواهد شد.

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

افزودن مسیرها در زبانه «عملکرد» پراکسی میانای برنامه‌سازی کاربردی

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

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

خصوصیت SMTPSSL برای درگاه «خدمات توسعه‌دهندگان»

برای تنظیم پروتکل مورداستفاده سرور SMTP متصل به درگاه، اکنون به‌جای خصوصیت SMTPSSL از خصوصیت SMTP_PROTOCOL استفاده می‌کنید. مقادیر معتبر SMTP_PROTOCOL عبارت‌اند از «standard»،‏ «ssl»، و «tls».

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

رفع اشکال‌ها

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

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

نشت حافظه در «پردازنده‌های پیام»

نشت حافظه برطرف شده است. وقتی Qpidd متوقف شد، این خطا در «پردازنده‌های پیام» رخ داد.
69711616

آسیب‌پذیری امنیتی در jackson-databind

کتابخانه jackson-databind به نسخه 2.7.9.1 به‌روزرسانی شده است تا از نقص واسریال‌سازی جلوگیری شود.
65550638

جلوگیری از تغییر نشانی ایمیل کاربر

دیگر نمی‌توانید نشانی ایمیل کاربر را در محتوای پیام ارسالی به میانای برنامه‌سازی کاربردی مدیریت تغییر دهید. «میانای برنامه‌سازی کاربردی مدیریت» اکنون زبان نشانه‌گذاری توسعه‌پذیر را در بدنه درخواست غیرمجاز می‌کند.

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

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

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

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

راهکار موقت:

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

HEAD درخواست به هدف‌های Node.js معلقه است

درخواست‌های HEAD به هدف Node.js می‌تواند معلق بماند و اتصال‌ها را در حالت انتظار قرار دهد.

راهکار موقت:

برای دور زدن این مشکل، یک مدیریت‌کننده برای درخواست‌های HEAD تعریف کنید تا صریحاً پاسخ خالی برگرداند.
79949124

گزینه ایجاد پراکسی معکوس ازطریق «میانای برنامه‌سازی کاربردی باز» نمایش داده می‌شود

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

راهکار موقت:

هیچ‌کدام.
79757554

نام‌های میزبان حل‌وفصل نمی‌شوند

پس‌از نصب یا ارتقا دادن Edge for Private Cloud، نام‌های میزبان ممکن است به نشانی‌هایشان تبدیل نشوند.

راهکار موقت:

برای حل کردن این مشکل، مؤلفه Edge UI را بازراه‌اندازی کنید:

/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
76087166

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

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

DataAccessException: Error while accessing datastore;
Please retry later

نتیجه این است که «سرور مدیریت» ممکن است شروع نشود زیرا درحال تلاش برای اتصال به گره‌های Cassandra در هر دو dc-1 و dc-2 است. اگر گره Cassandra غیرفعال باشد، DataAccessExceptions رخ می‌دهد. این امر همچنین ممکن است منجر به اختلال در ترافیک «میانای برنامه‌سازی کاربردی» شود، به‌طوری‌که «پردازشگرهای پیام» هنگام تلاش برای بازیابی KVM، DataAccessExceptions را گزارش می‌کنند.

توجه داشته باشید که وضعیت موردانتظار این است که «سرور مدیریت» به عناصر مخزن داده در مناطق متصل نشود.

راهکار موقت

راهکار موقت این است که انواع گره Cassandra زیر را در مرکز داده دردسترس‌نبود ثبت‌نام لغو کنید و سپس آن‌ها را پس‌از دردسترس قرار گرفتن مجدد گره‌های Cassandra ثبت‌نام کنید:

  • kms-datastore
  • dc-datastore
  • keyvaluemap-datastore

برای لغو ثبت و ثبت مجدد این انواع گره Cassandra:

  1. بااستفاده از فرمان curl زیر، «شناسه‌های یکتای» گره‌های Cassandra را دریافت کنید: 
    curl -u ADMIN_EMAIL:ADMIN_PW \
  "http://MS_IP:MS_PORT/v1/servers?region=REGION&pod=GATEWAY_POD \
  &type=CASSANDRA_NODE_TYPE"

    مکان:

    • ‫ADMIN_EMAIL و ADMIN_PW اطلاعات اعتباری حساب Apigee شما است.
    • ‫MS_IP و MS_PORT نشانی IP و شماره درگاه «سرور مدیریت» هستند.
    • ‫REGION نام مرکز داده‌ای است که «سرور مدیریت» در آن قرار دارد.
    • ‫GATEWAY_POD نام واحد است که به‌طور پیش‌فرض «دروازه» است. ممکن است آن را به نام دیگری تغییر داده باشید، بنابراین پیاده‌سازی‌تان را بررسی کنید.
    • ‫CASSANDRA_NODE_TYPE یکی از kms-datastore،‏ dc-datastore، و keyvaluemap-datastore است.

    برای مثال: 

    curl -u nickdanger@google.com:myP@$$w0rD
  "http://192.168.0.1:8080/v1/servers?region=dc-1&pod=gateway&type=dc-datastore"

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

    {
  "internalIP" : "POD_IP_ADDRESS",
  "isUp" : [true|false],
  "pod" : "GATEWAY_POD",
  "reachable" : [true|false],
  "region" : "dc-1",
  "tags" : {
    "property" : [ ]
  },
  "type" : [ "kms-datastore", "dc-datastore", "keyvaluemap-datastore" ],
    "uUID" : "POD_UUID"
}

    برای مثال: 

    {
  "internalIP" : "192.168.1.11",
  "isUp" : false,
  "pod" : "gateway",
  "reachable" : false,
  "region" : "dc-1",
  "tags" : {
    "property" : [ ]
  },
  "type" : "dc-datastore",
  "uUID" : "13cee956-d3a7-4577-8f0f-1694564179e4"
}

    مقادیر فیلد uUID را در پاسخ یادداشت کنید. از این موارد برای لغو ثبت گره‌ها استفاده خواهید کرد.

  2. مرحله یک را برای هر نوع گره Cassandra تکرار کنید: kms-datastore، dc-datastore، و keyvaluemap-datastore. حتماً شناسه‌های UUID برگشتی را یادداشت کنید.
  3. ثبت گره‌ها را بااستفاده از فرمان زیر لغو کنید: 
    curl -u ADMIN_EMAIL:ADMIN_PW "http://MS_IP:MS_PORT/v1/servers/UUID" -X DELETE

    که در آن UUID شناسه UUID برگشتی در پاسخ فرمان قبلی است.

  4. مرحله ۳ را برای هر شناسه UUID که در مراحل ۱ و ۲ جمع‌آوری کرده‌اید تکرار کنید.
  5. بااستفاده از فرمان زیر، گره‌ها را دوباره ثبت کنید: 
    curl -u ADMIN_EMAIL:ADMIN_PW "http://MS_IP:MS_PORT/v1/servers -d \
  "Type=kms-datastore&Type=dc-datastore&Type=keyvaluemap-datastore& \
  Type=counter-datastore&Type=cache-datastore&InternalIP=POD_IP_ADDRESS& \
  region=REGION&pod=GATEWAY_POD" -H \
  'content-type: application/x-www-form-urlencoded' -X POST

توجه داشته باشید که این عملیات گره‌ها را در Zookeeper ثبت و لغو ثبت می‌کند و هیچ تأثیری بر خوشه Cassandra ندارد. برای کسب اطلاعات بیشتر درباره این فرمان‌ها، به‌روزرسانی ثبت‌های انبار داده را ببینید.
72379834

پیام خطای اجازه هنگام توقف apigee-postgresql ظاهر می‌شود

وقتی از فرمان apigee-seriver apigee-postgresql stop برای توقف apigee-postgresql استفاده می‌کنید، ممکن است پیامی ببینید که می‌گوید apigee-serive نمی‌تواند به دایرکتوری خانه کاربر تغییر کند. می‌توانید این پیام را نادیده بگیرید.

راهکار موقت:

موجود نیست
68722102

خط‌مشی MessageLogging (ثبت پیام) شامل اطلاعات اضافی در پیام گزارش

عنصر FormatMessage خط‌مشی MessageLogging قالب پیام گزارش‌شده را کنترل می‌کند. وقتی FormatMessage=false، پیام ثبت‌شده نباید شامل هیچ‌گونه اطلاعات تولیدشده توسط Apigee باشد. بااین‌حال، حتی اگر FormatMessage=false را تنظیم کنید، پیام گزارش همچنان شامل اطلاعات زیر است:

  • امتیاز اولویت
  • مُهر زمان

راهکار موقت:

هیچ‌کدام.

مرحله بعدی

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

تاسیسات جدید:
نمای کلی نصب جدید
تاسیسات موجود:
ارتقا از 4.18.01
از 4.17.05 یا 4.17.09 ارتقا دهید
ارتقا از 4.17.01
ارتقا از 4.16.09
از 4.16.01 یا 4.16.05 ارتقا دهید