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

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

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

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

• ابر: 16.02.17،‏ 16.03.02،‏ ۱۶.۰۳.۰۹ (واسط کاربر)، ۱۶.۰۳.۱۶ (واسط کاربر)،‏ ۱۶.۰۳.۲۳ (واسط کاربر)،‏ 16.03.30

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

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

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

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

«راهنمای نصب و عملیات» به‌صورت آنلاین دردسترس است

اکنون می‌توانید به راهنمای «نصب و عملیات Edge برای ابر خصوصی» در نسخه ۴.۱۸.۰۱ دسترسی پیدا کنید.

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

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

• Java JDK 1.8 - برای بهره‌مندی از جدیدترین ویژگی‌های Java، این نسخه با Java 1.8 سازگار است. ‫Oracle JDK 1.8 یا OpenJDK 8 در محیط شما الزامی است.
  به‌عنوان بخشی از به‌روزرسانی به Java 8، برخی‌از رمزهای TLS دیگر در Oracle JDK 1.8 دردسترس نیستند. برای فهرست کامل، بخش «مجموعه‌های رمز منسوخ‌شده پیش‌فرض» http://docs.oracle.com/javase/8/docs/technotes/guides/security/SunProviders.html را ببینید.
• Cassandra 2.1.13 - از Cassandra 2.0.15 به‌روزرسانی شده است.

نصب، ارتقا، برگرداندن

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

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

مدیریت

ویژگی‌های جدید برای مدیریت و پیکربندی «ابر خصوصی» در زیر آمده است.

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

سرویس‌های API

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

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

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

کارت عام در «مسیر پایه» میانای برنامه‌سازی کاربردی (Cloud 16.03.09 UI)

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

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

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

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

زنجیره پراکسی در خط‌مشی‌های «خدمات پیامک» نیز دردسترس است.

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

اشکالات رفع شد

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

‫Edge for Private Cloud نسخه 4.16.05

Cloud 16.03.30

Cloud 16.03.16 UI

Cloud 16.03.09 UI

Cloud 16.03.02

Cloud 16.02.17

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

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

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

پایه‌بارهای JSON در خط‌مشی‌های «اختصاص پیام»، «ندای جاوا»، و «ایجاد خطا»

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

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

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

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

• آکولاد باز را با یک خط مورب معکوس فرار دهید:

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

• در پیکربندی عنصر «پایه‌بار»، از ویژگی‌های variablePrefix و variableSuffix برای نشان دادن متغیر در پایه‌بار JSON استفاده کنید. برای مثال:
  

  <Payload contentType="application/json" variablePrefix="#" variableSuffix="%">{"The date is: " : "#message.header.date%"}</Payload>

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

«مسیریاب» نمی‌تواند Nginx را شروع کند یا «مسیریاب» نمی‌تواند شروع کند

اگر «رهیاب لبه» نتواند 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