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

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

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

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

مرور کلی انتشار

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

• جریان‌های اشتراکی از استقرار بدون قطعی پشتیبانی می‌کنند.
• حذف داده‌های کسب درآمد برای یک سازمان اکنون پشتیبانی می‌شود.
• ویژگی‌های جدید اضافی که در زیر توضیح داده شده‌اند.

در مورد منسوخ شدن، گاوصندوق‌ها منسوخ شده‌اند.

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

استهلاک و بازنشستگی

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

منسوخ شده: اضافه کردن مسیرها در تب عملکرد پروکسی API

تا این نسخه، می‌توانستید در رابط کاربری مدیریت، به یک پروکسی API بروید، به تب Performance بروید و مسیرهای مختلفی را برای مقایسه مبتنی بر نمودار در تب Performance پروکسی و در داشبورد Business Transactions ایجاد کنید. این ویژگی اکنون منسوخ شده و دیگر در رابط کاربری موجود نیست. برای جایگزینی برای این قابلیت، به مقاله زیر از انجمن Apigee مراجعه کنید: Alternative to Business Transactions API (EDGEUI-902)

منسوخ شده: آدرس اینترنتی buildInfo برای پورتال خدمات توسعه‌دهندگان

در نسخه‌های قبلی پورتال، برای تعیین نسخه پورتال خود، آدرس اینترنتی زیر را در مرورگر باز می‌کردید:

http://yourportal.com/buildInfo

در نسخه ۴.۱۷.۰۵ این لینک حذف شد. برای تعیین نسخه، در دروپال، منوی Reports > Status report را باز کنید. نسخه پورتال در جدول ردیفی با عنوان Install profile نمایش داده می‌شود.

منسوخ شدن فروشگاه امن Apigee (خزانه‌ها)

مخزن امن Apigee که با نام "vaults" نیز شناخته می‌شود، منسوخ شده است و یک سال پس از تاریخ اعلام منسوخ شدن که در صفحه Deprecations and Redispensions نشان داده شده است، منسوخ خواهد شد. Vaults که ذخیره‌سازی رمزگذاری شده جفت‌های کلید/مقدار را فراهم می‌کنند، با API مدیریت ایجاد می‌شوند و در زمان اجرا با توابعی در ماژول apigee-access Node.js قابل دسترسی هستند.

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

ویژگی‌ها و به‌روزرسانی‌های جدید

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

ابر خصوصی

پارامتر پیکربندی SMTP مورد نیاز جدید به نصب اضافه شد

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

(EDGEUI-1020)

اکنون می‌توان زمان انقضای مورد استفاده توسط رابط کاربری اج را برای تماس‌های مدیریتی رابط برنامه‌نویسی اج تنظیم کرد.

اکنون می‌توانید مدت زمان وقفه API مورد استفاده توسط رابط کاربری Edge را مشخص کنید تا مدت زمان انتظار رابط کاربری برای بازگشت یک فراخوانی مدیریت API را کنترل کنید. ویژگی‌های زیر این وقفه را تعریف می‌کنند:

• conf_apigee_apigee.feature.apitimeout زمانی را بر حسب ثانیه تنظیم می‌کند که رابط کاربری صرف نظر از هرگونه فعالیتی که روی آن انجام می‌شود، منتظر بازگشت یک فراخوانی به backend می‌ماند. اگر فراخوانی در این مدت زمان تکمیل نشود، رابط کاربری خطای timeout را نمایش می‌دهد. مقدار پیش‌فرض ۱۸۰ ثانیه (۳ دقیقه) است.
• conf_apigee_play.ws.timeout.idle مدت زمانی را که رابط کاربری (UI) برای فعالیت روی سرور، بر حسب میلی‌ثانیه، منتظر می‌ماند، تعیین می‌کند. می‌توان آن را روی همان مقدار conf_apigee_apigee_apitimeout یا روی مقداری کمتر تنظیم کرد. تنظیم آن روی مقدار بزرگتر هیچ تاثیری ندارد. مقدار پیش‌فرض ۱۸۰۰۰۰ میلی‌ثانیه (۳ دقیقه) است.
• conf_apigee_play.ws.timeout.connection مدت زمانی را که رابط کاربری برای برقراری اتصال منتظر می‌ماند، تعیین می‌کند. این مقدار می‌تواند برابر با مقدار conf_apigee_apigee_apitimeout یا کمتر از آن باشد. تنظیم آن روی مقدار بزرگتر هیچ تاثیری ندارد. مقدار پیش‌فرض ۱۲۰۰۰۰ میلی‌ثانیه (۲ دقیقه) است.

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

(EDGEUI-816)

اضافه شدن زمان تلاش مجدد پردازنده پیام به روترها

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

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

(APIRT-2912)

روشی برای تغییر مدیر پیش‌فرض سیستم اضافه شد

اکنون مستنداتی برای تغییر مدیر پیش‌فرض سیستم گنجانده شده است.

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

(داس-۴۸۹۵)

مستنداتی در مورد جداسازی وظایف نصب Edge بین کاربر root و غیر root اضافه شد.

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

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

(داس-۴۵۷۳)

ویژگی اضافه شده برای تنظیم نام میزبان برای لینک‌ها در ایمیل‌های تولید شده

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

https://domain/login

دامنه به طور خودکار توسط Edge تعیین می‌شود و معمولاً برای سازمان صحیح است. با این حال، این احتمال وجود دارد که وقتی رابط کاربری Edge پشت یک متعادل‌کننده بار است، نام دامنه تولید شده به صورت خودکار نادرست باشد. در این صورت، می‌توانید از ویژگی conf_apigee_apigee.emails.hosturl برای تنظیم صریح بخش نام دامنه در URL تولید شده استفاده کنید.

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

(EDGEUI-1044)

تنظیم URL پایه نمایش داده شده توسط رابط کاربری Edge برای یک پروکسی API

رابط کاربری Edge، آدرس اینترنتی (URL) یک پروکسی API را بر اساس تنظیمات میزبان مجازی مربوط به محل استقرار پروکسی نمایش می‌دهد. این نمایش می‌تواند شامل شماره پورت روتر میزبان مجازی باشد.

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

• خاتمه SSL در یک متعادل کننده بار رخ می‌دهد
• نگاشت پورت بین یک متعادل‌کننده بار و روترهای Apigee رخ می‌دهد.
• یک متعادل‌کننده بار که با بازنویسی مسیر پیکربندی شده است

اج برای ابر خصوصی ۴.۱۷.۰۵ و بالاتر از یک ویژگی در میزبان مجازی به نام <BaseUrl> پشتیبانی می‌کند که به شما امکان می‌دهد URL نمایش داده شده توسط رابط کاربری اج را نادیده بگیرید. در اینجا مثالی آورده شده است که شیء میزبان مجازی را با ویژگی جدید <BaseURL> نشان می‌دهد. در این مثال، مقدار " http://myCo.com " در رابط کاربری اج ظاهر می‌شود:

<VirtualHost name="myVHost">
   <HostAliases>
     <HostAlias>DNS_name_or_IP:9005</HostAlias>
   </HostAliases>
   <BaseUrl>http://myCo.com</BaseUrl>
   <Interfaces/>
   <Port>9005</Port>
</VirtualHost>

اگر <BaseUrl> به عنوان پیش‌فرض تنظیم نشده باشد، آدرس اینترنتی پیش‌فرض رندر شده توسط رابط کاربری Edge به صورت " http:// DNS_name_or_IP :9005/ " نمایش داده می‌شود، در حالی که نام مستعار میزبان واقعی " http://myCo.com " است.

همچنین می‌توانید هنگام ایجاد یک سازمان، با استفاده از ویژگی VHOST_BASEURL با ابزار apigee-provision، آدرس اینترنتی پایه را تنظیم کنید.

برای اطلاعات بیشتر به پیکربندی دسترسی TLS به یک API برای ابر خصوصی مراجعه کنید.

(EDGEUI-5008)

مستنداتی در مورد فعال‌سازی ثبت گزارش اشکال‌زدایی اضافه شد.

مستنداتی برای توضیح نحوه فعال/غیرفعال کردن ثبت وقایع اشکال‌زدایی برای اجزای Edge اضافه شده است.

برای اطلاعات بیشتر به فعال کردن ثبت گزارش اشکال‌زدایی مراجعه کنید.

(APIRT-4018)

نصب‌کننده و سینتکس دستور جدید برای ابزار apigee-analytics-collector

تمام مشتریان Edge برای Private Cloud موظفند آمار مربوط به ترافیک پروکسی API را با استفاده از نسخه بتای ابزار خط فرمان apigee-analytics-collector به Apigee ارسال کنند. این ابزار گزارش حجم تماس API را به Apigee ارسال می‌کند.

این نسخه از اج شامل دستورالعمل‌های نصب و سینتکس فرمان جدیدی برای ابزار apigee-analytics-collector است. در این نسخه، اکنون به جای npm از apigee-service برای نصب ابزار apigee-analytics-collector استفاده می‌کنید و ابزار apigee-analytics-collector را به جای یک دستور مستقل، از طریق apigee-service فراخوانی می‌کنید.

برای اطلاعات بیشتر به آپلود داده‌های ترافیک API در Apigee - نسخه بتا مراجعه کنید.

دایرکتوری نصب پیش‌فرض جدید پس از به‌روزرسانی پورتال سرویس‌های توسعه‌دهندگان Nginx/Postgres از نصب جدید ۴.۱۷.۰۱

پس از به‌روزرسانی نسخه جدید ۴.۱۷.۰۱ که از Nginx/Postgres استفاده می‌کند، دایرکتوری ریشه از مسیر زیر تغییر کرد:

/opt/apigee/apigee-drupal

به:

/opt/apigee/apigee-drupal/wwwroot

خدمات API

اعتبارسنجی ورودی سختگیرانه‌تر برای موجودیت‌ها

اعتبارسنجی ورودی سختگیرانه‌تری در تمام موجودیت‌های سازمان Apigee Edge اعمال شده است. کاراکترهای مجاز معمولاً حروف الفبا (همه حروف کوچک و بزرگ)، اعداد و زیرخط هستند.

نهادهای تحت تأثیر عبارتند از:

• سازمان‌ها
• محیط‌ها
• پروکسی‌های API
• اصلاحات پروکسی API
• نام‌های سیاست در پروکسی API
• اشکال‌زدایی شناسه‌های پیکربندی ماسک ردیابی
• نام منابع (کد جاوا، xsl، همه منابع)
• فروشگاه‌های کلید
• فروشگاه‌های CRL
• منابع مرجع
• سرورهای هدف

(MGMT-3840)

جریان‌های مشترک، استقرار بدون قطعی

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

فراخوانی زیر، نسخهٔ جریان مشترک مشخص‌شده در URI را مستقر می‌کند، سپس نسخهٔ قبلاً مستقرشده را از حالت مستقر خارج می‌کند (پارامتر کوئری override=true این امکان را فراهم می‌کند):

curl -X POST -H "Content-type:application/x-www-form-urlencoded" \
https://api.enterprise.apigee.com/v1/o/{org_name}/environments/{env-name}/sharedflows/{shared_flow_name}/revisions/{revision_number}/deployments?"override=true" \
-u email:password

(MGMT-3485)

کسب درآمد

حذف داده‌های کسب درآمد برای یک سازمان

ممکن است بخواهید داده‌های کسب درآمد سازمان خود را در سناریوهای زیر حذف کنید:

• سازمان خود را حذف کنید. در این حالت، قبل از حذف سازمان، باید داده‌های کسب درآمد را حذف کنید.
• داده‌های کسب درآمد را از یک سازمان آزمایشی که می‌خواهید دوباره از آن استفاده کنید، پاک کنید. در این صورت، پس از حذف داده‌های کسب درآمد، باید داده‌های Apigee Edge را همگام‌سازی کنید.

برای اطلاعات بیشتر، به حذف داده‌های کسب درآمد از سازمان خود مراجعه کنید. (DEVRT-2581)

API برای فعال کردن کسب درآمد برای یک سازمان اضافه شد

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

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

(DEVRT-2383)

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

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

ابر خصوصی ۴.۱۷.۰۵

ابر ۱۷.۰۴.۱۲ (رابط کاربری)

ابر ۱۷.۰۴.۰۵ (رابط کاربری)

ابر ۱۷.۰۳.۲۹ (رابط کاربری)

ابر ۱۷.۰۳.۱۵.۰۱ (رابط کاربری)

ابر ۱۷.۰۳.۱۵ (رابط کاربری)

ابر ۱۷.۰۳.۱۳.۰۲ (کسب درآمد)

ابر ۱۷.۰۳.۱۳.۰۱ (کسب درآمد)

ابر ۱۷.۰۳.۱۳ (مدیریت API)

کلود ۱۷.۰۳.۱ (رابط کاربری)

ابر ۱۷.۰۲.۱۵ (رابط کاربری)

ابر ۱۷.۰۲.۱۳ (زمان اجرای API)

ابر ۱۷.۰۲.۱۳ (مدیریت API)

فضای ابری ۱۷.۰۱.۱۸ (رابط کاربری)

ابر ۱۷.۰۱.۱۶ (مدیریت API)

ابر ۱۷.۰۱.۱۶ (کسب درآمد)