4.15.07.00 - یادداشت‌های انتشار Apigee Edge برای Private Cloud

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

در روز سه‌شنبه، 8 سپتامبر 2015، ما یک ویژگی اصلی از Apigee Edge را برای Private Cloud منتشر کردیم.

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

• ابر: 15.04.15 ، 15.04.29 ، 15.05.27 ، 15.06.10 و 15.06.24
• ابر خصوصی: 4.15.04.01

کدام نسخه Edge را می توانید به 4.15.07.00 ارتقا دهید

بسته به نسخه فعلی Edge، می توانید یکی از موارد زیر را انجام دهید:

• به طور مستقیم به 4.15.07.00 ارتقا دهید
• به صورت تدریجی ارتقا دهید، یعنی باید از نسخه فعلی خود به نسخه دیگری از Edge ارتقا دهید و سپس به 4.15.07.00 ارتقا دهید.

برای اطلاعات بیشتر، ببینید کدام Edge را برای نسخه‌های Private Cloud می‌توانید به 4.15.07.00 ارتقا دهید .

قبل از ارتقا از نسخه 4.15.01.x یا از نسخه قبلی

1. نسخه Cassandra SSTable را بررسی کنید:
   1. دایرکتوری را به /<install-root>/apigee4/data/cassandra/data تغییر دهید.
   2. دستور Find را اجرا کنید،
      > پیدا کردن -name *-ic-*
      اگر از Cassandra 1.2 SSTable استفاده می کنید، نتایج باید مجموعه ای از فایل های .db را برگرداند.
   3. این دستور Find را اجرا کنید:
      > پیدا کردن -نام *-hf-*
      نتایج باید خالی باشند، به این معنی که هیچ فایل .db با فرمت hf نیست. اگر هیچ فایلی با فرمت hf مشاهده نکردید، کار شما تمام شده است و می توانید به 4.15.07.00 ارتقا دهید.
      
      فرمت hf برای Cassandra 1.0 SSTables است. اگر فایل های *.db با فرمت hf دارید، باید SSTable را همانطور که در ادامه این روش توضیح داده شد ارتقا دهید.
2. اگر فایل های *.db با فرمت hf پیدا کردید، SSTable را با اجرای دستور زیر بر روی هر گره Cassandra ارتقا دهید تا زمانی که همه گره های Cassandra را ارتقا دهید:
   > /<install-root>/apigee4/share/apache-cassandra/bin/nodetool -h localhost upgradesstables -a
3. مرحله 1 را تکرار کنید تا بررسی کنید که تمام فایل های *.db در قالب ic نسخه Cassandra 1.2 هستند.
4. مراحل 1 تا 3 را در هر گره Cassandra در نصب Edge خود تکرار کنید.
5. به Edge 4.15.07.00 ارتقا دهید.
6. پس از ارتقاء 4.15.07.00، فایل های *.db را بررسی کنید تا مطمئن شوید که همه آنها به sstable سبک C* 2.0 ارتقا یافته اند:
   > cd /<install-root>/apigee4/data/cassandra/data
   > پیدا کردن -name *-jb-*
   اگر Cassandra 2.0 را اجرا می کنید، این دستور باید مجموعه ای از فایل های .db را برگرداند.

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

در ادامه ویژگی ها و پیشرفت های جدید در این نسخه آورده شده است.

نصب و ارتقاء

ارتقاء و حذف مؤلفه انتخابی

اسکریپت‌های apigee-upgrade.sh و apigee-uninstall.sh اکنون به شما امکان می‌دهند اجزای Edge را برای ارتقا یا حذف نصب انتخاب کنید. قبلاً، تمام اجزای گره را ارتقا یا حذف نصب می کرد. (OPDK-1377، OPDK-1175)

ارتقاء عقبگرد

اگر apigee-upgrade.sh در حین ارتقاء خراب شود، اکنون می توانید از اسکریپت apigee-rollback.sh برای بازگرداندن ارتقاء استفاده کنید. پس از رفع هرگونه مشکل ارتقاء، می توانید ارتقا را دوباره امتحان کنید. (OPDK-1275)

گزینه های اسکریپت نصب کننده کوتاه شده

اسکریپت های نصب دیگر گزینه های طولانی مانند --help را ندارند. آنها اکنون فقط گزینه های تک حرفی مانند -h را انتخاب می کنند. (OPDK-1356)

نصب SmartDocs

هنگام نصب SmartDocs با اسکریپت setup-smartdocs.sh، از شما خواسته می شود که وارد سازمان، محیط و میزبان مجازی شوید، که اطمینان حاصل می کند که SmartDocs در محل مورد انتظار نصب شده است. قبلاً، این مقادیر در اسکریپت کدگذاری شده بودند. (OPDK-1310)

اجرای update-cass-pwd-in-config.sh بدون درخواست

اگر متغیرهای محیطی ENABLE_CASS_AUTH، CASS_USERNAME و CASS_PASSWORD را تنظیم کنید، اسکریپت update-cass-pwd-in-config.sh می‌تواند بدون درخواست اجرا شود. (OPDK-1309)

پلت فرم لبه

در زیر ویژگی‌های جدید پلتفرم Edge موجود در این نسخه آورده شده است.

OpenJDK 1.7 توسط Edge Private Cloud پشتیبانی می شود

این نسخه از Edge از Oracle JDK 1.7 و OpenJDK 7 پشتیبانی می کند و پشتیبانی از JDK 1.6 را حذف کرده است. (OPDK-1187)

پشتیبانی از سیستم عامل

Apigee Edge برای Private Cloud پشتیبانی سیستم عامل خود را گسترش داده و شامل Red Hat Enterprise Linux 6.6 و 7.0 (64 بیتی)، CentOS 6.5، 6.6 و 7.0 (64 بیتی) و Oracle Linux 6.5 می شود.

Cassandra 2.0.15 موجود در OPDK 15.07

این نسخه Cassandra 2.0.15 را نصب می کند. اگر برای نسخه قبلی ارتقا می دهید، نسخه Cassandra شما به روز می شود. (OPDK-1197)

پشتیبانی SHA2 برای هش کردن توکن OAuth

برای محافظت بهتر از نشانه‌های OAuth در صورت نقض امنیت پایگاه داده، Edge از الگوریتم‌های SHA2 برای هش کردن توکن‌های OAuth (علاوه بر SHA1) پشتیبانی می‌کند. با ویژگی‌های جدید در سطح سازمان، می‌توانید هش را برای توکن‌های جدید فعال و پیکربندی کنید و همچنین هش‌سازی قدیمی را روی هر توکنی که قبل از این ویژگی جدید وجود داشته است، حفظ کنید. قبلاً در Edge for Private Cloud، خاصیتی به نام hash.oauth.tokens.enabled در فایل keymanagement.properties (در سرور مدیریت و پردازشگرهای پیام شما) هش خودکار SHA1 توکن های OAuth را فعال می کرد. این ویژگی اکنون منسوخ شده است.

اگر قبلاً از ویژگی hash.oauth.tokens.enabled برای فعال کردن هش SHA1 استفاده کرده‌اید، اسکریپت ارتقاء برای این نسخه به طور خودکار ویژگی‌های جدید در سطح سازمان را برای شما ایجاد می‌کند. برای تأیید پس از ارتقا، یک GET به عنوان سرپرست سیستم با این API انجام دهید: https://{host}:{port}/v1/o/{your_org}.

• برای اطلاعات در مورد فعال کردن هش توکن در سازمانتان با ویژگی های جدید، به «هش کردن نشانه ها در پایگاه داده» در مبحث درخواست نشانه های دسترسی مراجعه کنید.
• برای اطلاعات در مورد هش انبوه نشانه‌های موجود، به راهنمای عملیات Edge for Private Cloud مراجعه کنید. (APIRT-1389)

ساختار دایرکتوری مسطح برای فایل های لاگ

می‌توانید Edge را برای ذخیره فایل‌های گزارش در یک ساختار دایرکتوری مسطح با تنظیم یک ویژگی enable.flat.directory.structure روی true در فایل message-logging.properties پیکربندی کنید. برای اطلاعات بیشتر، به سیاست ثبت پیام مراجعه کنید. (APIRT-1394)

عملکرد حافظه پنهان محیطی

برای مدیریت و استفاده بهتر حافظه نهان، تنظیمات "حداکثر عناصر در حافظه" در منابع کش محیطی منسوخ شده است. کل عناصر موجود در تمام منابع کش (از جمله کش پیش فرض) به کل حافظه اختصاص داده شده به کش بستگی دارد. به طور پیش‌فرض، کل حافظه اختصاص داده شده برای حافظه پنهان در یک پردازشگر پیام معین، 40 درصد از کل حافظه موجود است که توسط تنظیمات ویژگی cache در فایل cache.properties پردازشگر پیام شما تعیین می‌شود. تنها زمانی که حافظه کش کافی وجود نداشته باشد یا عناصر منقضی شوند، عناصر از حافظه پنهان خارج می شوند.

برای بازگشت به رفتار قدیمی استفاده از ویژگی "Maximum Elements in Memory" برای مدیریت حافظه پنهان، ویژگی overrideMaxElementsInCacheResource=false در فایل cache.properties تنظیم کنید. (APIRT-1140)

خدمات API

در زیر ویژگی های خدمات API جدید موجود در این نسخه آورده شده است.

ویرایشگر پروکسی جدید به عنوان پیش فرض

ویرایشگر پروکسی API جدید به طور پیش فرض در رابط کاربری مدیریت فعال است. ویرایشگر جدید شامل بسیاری از پیشرفت‌ها در قابلیت استفاده است، از جمله نماهای جامع‌تر جریان‌های شرطی و نقاط پایانی در صفحه نمای کلی، تمام پیکربندی‌ها در صفحه توسعه، افزودن بصری‌تر جریان‌های شرطی، نقاط پایانی و خط‌مشی‌ها، نماهای کامل‌تر XML به جای قطعه‌های کوچک، جستجویی که نام فایل ها و متن و موارد دیگر را می خزد. (MGMT-2279)

سیاست اطلاعات جدید حذف OAuth v2.0

یک خط مشی جدید "حذف اطلاعات OAuth v2.0" به شما امکان می دهد نشانه های دسترسی OAuth v2 و کدهای مجوز را حذف کنید. این خط مشی جایگزین عملکردی می شود که قبلاً توسط API مدیریت ارائه شده بود. برای اطلاعات بیشتر، به حذف سیاست اطلاعات OAuthV2 مراجعه کنید. (MGMT-2257)

سیاست اطلاعات جدید حذف OAuth v1.0

یک خط مشی جدید "حذف اطلاعات OAuth v1.0" به شما امکان می دهد نشانه های درخواست OAuth v1.0، نشانه های دسترسی و کدهای تایید کننده را حذف کنید. این خط مشی جایگزین عملکردی می شود که قبلاً توسط API مدیریت ارائه شده بود. برای اطلاعات بیشتر، به حذف سیاست اطلاعات OAuth V1 مراجعه کنید. (APIRT-1351)

سیاست کنترل دسترسی

خط‌مشی کنترل دسترسی بهبود یافته است تا زمانی که آدرس‌های IP در هدر X-FORWARDED-FOR HTTP وجود دارد، امکان ارزیابی دقیق‌تر آدرس‌های IP برای فهرست‌بندی مجاز و رد فهرست‌بندی را فراهم می‌کند.

با فعال بودن بررسی چند آدرس IP در هدر (برای تنظیم feature.enableMultipleXForwardCheckForACL با پشتیبانی تماس بگیرید)، یک عنصر <ValidateBasedOn> جدید در خط مشی به شما امکان می دهد نسبت به اولین IP، آخرین IP یا تمام IP های موجود در هدر بررسی کنید. برای اطلاعات بیشتر، به سیاست کنترل دسترسی مراجعه کنید.

موجودیت های جدید در خط مشی Access Entity

خط مشی Access Entity دسترسی به موجودیت‌های جدید زیر را فراهم می‌کند: مصرف‌کننده کلید-اسکوپ، کد مجوز، توکن درخواست، و تأییدکننده. برای اطلاعات بیشتر، به خط مشی موجودیت دسترسی مراجعه کنید.

سیاست جمع آوری آمار: تبدیل خودکار نام آمار به حروف کوچک

هنگام ایجاد یک مجموعه تجزیه و تحلیل سفارشی در ویرایشگر پراکسی API (صفحه توسعه > ابزارها > مجموعه تجزیه و تحلیل سفارشی)، متغیر جمع کننده (آمار) "Name" باید با حروف کوچک باشد. اگر نام را با حروف بزرگ وارد کنید، ابزار به طور خودکار نام Statistic را در خط مشی Statistics Collector به حروف کوچک تبدیل می کند. (MGMT-740)

حذف کلاسیک Trace در ویرایشگر پروکسی API

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

دسترسی به انجمن Apigee از منوی راهنمای رابط کاربری مدیریت

می‌توانید از منوی راهنمای مدیریت رابط کاربری به انجمن Apigee دسترسی پیدا کنید.

پیام های خطا در رابط کاربری مدیریت

در زیر پیشرفت های پیام خطا در رابط کاربری مدیریت آمده است:

• رابط کاربری مدیریت برای گروه بندی و نمایش همه پیام های خطا در رابط کاربری برای کل جلسه ورود استفاده می شود، مگر اینکه آنها را رد کرده باشید. با این به‌روزرسانی، پیام‌های خطا وقتی از صفحه‌ای که در آن رخ داده‌اند دور می‌شوید، به‌طور خودکار پاک می‌شوند. (MGMT-2254)
• رابط کاربری مدیریت دیگر پیام های خطای تکراری را سرکوب نمی کند. (MGMT-2242)

عملکرد UI و بهبود خطا

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

پیوندهای نقش در صفحه کاربران سازمان در رابط کاربری مدیریت

در صفحه کاربران سازمان در رابط کاربری مدیریت (مدیر > کاربران سازمان)، نام نقش‌ها اکنون پیوند داده شده است و به شما امکان می‌دهد به سرعت به صفحات نقش بروید. (MGMT-1055)

متغیرهای هدف جدید در جریان پیام

متغیرهای جدید در جریان پیام، اطلاعات URL کامل تری را برای نقاط پایانی و سرورهای هدف فراهم می کنند:

• TargetEndpoint: request.url جایگزین target.basepath.with.query می شود.
• TargetServer: loadbalancing.targetserver جایگزین targetserver.name می شود. همچنین، target.basepath تنها زمانی پر می شود که عنصر <Path> در عنصر HTTPTargetConnection <LoadBalancer> TargetEndpoint استفاده شود.

پشتیبانی از نمایش نام سرور (SNI).

Edge از استفاده از نشانگر نام سرور به سمت جنوب (از پردازشگر پیام تا نقاط پایانی هدف) پشتیبانی می کند. اگر می‌خواهید از SNI استفاده کنید، با پشتیبانی Apigee تماس بگیرید.

جاوا 1.7 مورد نیاز است.

با SNI، که توسعه‌ای از TLS/SSL است، چندین هدف HTTPS را می‌توان از یک آدرس IP و پورت یکسان بدون نیاز به استفاده از یک گواهی از همه آن اهداف استفاده کرد.

هیچ پیکربندی خاص Edge مورد نیاز نیست. اگر محیط شما برای SNI به سمت جنوب پیکربندی شده است (Edge cloud به طور پیش فرض است)، Edge از آن پشتیبانی می کند.

Edge به طور خودکار نام میزبان را از URL درخواست استخراج می کند و آن را به درخواست SSL handshake اضافه می کند. به عنوان مثال، اگر میزبان هدف https://example.com/request/path باشد، Edge پسوند server_name را مانند شکل زیر اضافه می کند:

برای اطلاعات بیشتر در مورد SNI، به http://en.wikipedia.org/wiki/Server_Name_Indication مراجعه کنید.

"الگوریتم امضا" در جزئیات گواهینامه های SSL

یک فیلد جدید "Signature Algorithm" به جزئیات گواهی SSL اضافه شده است که در رابط کاربری مدیریت (Admin > Certificates SSL) و API مدیریت ( دریافت جزئیات گواهی از فروشگاه کلید یا Truststore ) قابل مشاهده است. این فیلد بسته به نوع الگوریتم هش مورد استفاده برای تولید گواهی، «sha1WithRSAEncryption» یا «sha256WithRSAEncryption» را نشان می‌دهد.

نمایش گواهی‌های SSL که نزدیک به انقضا هستند

صفحه گواهی‌های SSL در رابط کاربری مدیریت (Admin > گواهی‌های SSL) نشان می‌دهد که بسته به انتخاب شما در قسمت کشویی منقضی جدید، چه زمانی گواهی‌های SSL در 10، 15، 30 یا 90 روز منقضی می‌شوند.

پیکربندی خطای حفاظت از تهدید

به‌طور پیش‌فرض، Edge یک کد وضعیت خطای سرور داخلی HTTP 500 و یک خطای ExecutionFailed را ارسال می‌کند اگر پیامی از خط‌مشی حفاظت از تهدیدات JSON یا XML عبور نکند. شما می توانید این رفتار خطا را با یک ویژگی جدید در سطح سازمان تغییر دهید. هنگام تنظیم ویژگی org features.isPolicyHttpStatusEnabled روی true، رفتار زیر رخ می دهد:

• درخواست: با یک خط مشی حفاظت از تهدید متصل به هر جریان درخواستی، پیام های نامعتبر یک کد وضعیت 400، همراه با یک پیام خطای خط مشی مربوطه را برمی گرداند.
• پاسخ: با یک خط‌مشی حفاظت از تهدید متصل به هر جریان پاسخ، پیام‌های نامعتبر همچنان یک کد وضعیت 500 را برمی‌گردانند و یکی از پیام‌های خطای خط‌مشی مربوطه پرتاب می‌شود (و نه فقط ExecutionFailed).

مشتریان Cloud برای تنظیم ویژگی سازمان باید با پشتیبانی Apigee تماس بگیرند. این ویژگی در نسخه فصلی بعدی Private Cloud برای مشتریان Edge Private Cloud در دسترس خواهد بود.

طرحواره های به روز شده برای نقاط پایانی، پراکسی ها و سایر موجودیت ها

طرحواره های مرجع برای موجودیت های غیر خط مشی مانند TargetEndpoint، ProxyEndpoint، APIProxy و بسیاری دیگر به روز شده اند. https://github.com/apigee/api-platform-samples/tree/master/schemas را ببینید. (APIRT-1249)

خدمات توسعه دهنده

در زیر ویژگی های جدید Developer Services موجود در این نسخه آورده شده است.

در دسترس بودن عمومی SmartDocs

SmartDocs از نسخه بتا به در دسترس بودن عمومی فارغ التحصیل می شود. به روز رسانی ها و ویژگی های جدید عبارتند از:

• پشتیبانی از Swagger 2.0، از جمله وارد کردن بر اساس فایل یا URL، از جمله پشتیبانی از اشیاء امنیتی با نام سفارشی.
• بهبود طراحی بصری در قالب هایی که SmartDocs را تولید می کنند.
• بهبود قابلیت استفاده و گردش کار در پورتال برنامه نویس، از طریق منوی Content > SmartDocs در دروپال در دسترس است.
• آنچه به عنوان احراز هویت "Token سفارشی" شناخته می شود، اکنون "کلید API" نامیده می شود.
• احراز هویت اشیاء "امنیت" تعریف شده در سطح تجدید نظر.
• پیکربندی احراز هویت مشتری در سطح الگو. ویرایش‌های جدید دیگر اعتبار مشتری SmartDocs از پیش پیکربندی شده را بازنشانی نمی‌کنند.

برای توضیحات بیشتر، این پست وبلاگ را ببینید.

برای مستندات SmartDocs، به استفاده از SmartDocs برای مستندسازی APIها مراجعه کنید.

نام برنامه برنامه‌نویس در رابط کاربری مدیریت نمایش داده می‌شود

برنامه‌های توسعه‌دهنده در Edge هم یک نام داخلی دارند که تغییر نمی‌کند و هم یک نام نمایشی که می‌توانید تغییر دهید. در یک صفحه برنامه توسعه‌دهنده در رابط کاربری مدیریت (انتشار > برنامه‌های برنامه‌نویس > نام برنامه)، «نام» داخلی برنامه به همراه «نام نمایشی» نمایش داده می‌شود و شناسایی بصری برنامه‌ها با نام‌های داخلی آن‌ها برای عیب‌یابی و API را آسان‌تر می‌کند. مدیریت

خدمات تجزیه و تحلیل

در زیر ویژگی‌های سرویس Analytics جدید موجود در این نسخه آورده شده است.

محدودیت زمانی داده های حفظ شده

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

نسخه کلاسیک گزارش‌های سفارشی در حال حذف از رابط کاربری مدیریت

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

عملکرد ویجت Developer Engagement

ویجت قیف در داشبورد اصلی تجزیه و تحلیل (بخش Developer Engagement) برای ارائه عملکرد بهتر بهبود یافته است.

کسب درآمد

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

اعلان‌های ایمیلی طرح را رتبه‌بندی کنید

یک نوع اعلان ایمیل جدید Rate Plan به شما امکان می‌دهد برنامه‌نویسان را در صورت رسیدن به یک تراکنش یا محدودیت دلاری خاص در طرح‌های باندی یا بسته‌بندی نرخی که خریداری کرده‌اند، مطلع کنید. برای جزئیات، به تنظیم اعلان ها با استفاده از الگوهای اعلان مراجعه کنید.

همگام سازی دوره های کارمزد مکرر و پایه تجمیع

در یک طرح نرخ، به طور بالقوه دو دوره زمانی متفاوت وجود داشت:

• دوره کارمزد تکرارشونده، پیکربندی شده در برگه هزینه‌های یک طرح نرخ، که تعیین می‌کند چه زمانی از توسعه‌دهندگان کارمزد تکراری دریافت می‌شود.
• دوره پایه تجمیع، که در کارت نرخ برای طرح‌های Volume Banded یا Bundles تعریف شده است، که تعیین می‌کند چه زمانی استفاده از بسته برای برنامه‌نویسان بازنشانی شده است.

آن دو دوره اکنون با هم هماهنگ شده اند. وقتی هم یک کارمزد تکرارشونده غیر صفر و هم کارت نرخ حجمی یا بسته‌بندی در یک طرح نرخ وجود دارد، دوره کارمزد تکرارشونده برای هر دو استفاده می‌شود. برای مثال، اگر یک کارمزد تکراری ماهانه وجود داشته باشد، بسته‌های کارت نرخ نیز ماهانه بازنشانی می‌شوند (به طور پیش‌فرض در ابتدای ماه).

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

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

ویژگی‌های سفارشی در گزارش‌های درآمد خلاصه

خط‌مشی‌های ثبت تراکنش‌ها به شما امکان می‌دهند به‌صورت اختیاری داده‌های ویژگی سفارشی را از تراکنش‌ها دریافت کنید، و اکنون می‌توانید آن ویژگی‌های تراکنش سفارشی را در گزارش‌های درآمد خلاصه کنید. با افزودن یک ویژگی MINT.SUMMARY_CUSTOM_ATTRIBUTES به سازمان خود، می توانید مشخص کنید که کدام ویژگی های سفارشی برای استفاده در گزارش ها به جداول پایگاه داده اضافه شده اند.

Apigee Edge for Private Cloud مشتریان می توانند پرچم را با تماس API زیر و اعتبارنامه مدیر سیستم تنظیم کنند.

curl -u email:password -X PUT -H "Content-type:application/xml" http://host:8080/v1/o/myorg -d \
"<Organization type="trial" name="MyOrganization">
    <Properties>
        <Property name="features.isMonetizationEnabled">true</Property>
        <Property name="MINT.SUMMARY_CUSTOM_ATTRIBUTES">[&quot;my_attribute_1&quot;,&quot;my_attribute_2&quot;]</Property>
        <Property name="features.topLevelDevelopersAreCompanies">false</Property>
    </Properties>
</Organization>"

توجه داشته باشید که آرایه‌ای از ویژگی‌های سفارشی در فراخوانی API با URL رمزگذاری شده است.

فرآیند ارتقا SmartDocs

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

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

به خاطر داشته باشید که در حالی که می‌توانید SmartDocs را در پورتال توسعه‌دهنده خود رندر و منتشر کنید، SmartDocها از مدل API تولید می‌شوند که در سرویس‌های مدیریت API Edge Apigee زندگی می‌کند. هر تغییری که در یک مدل API در Edge ایجاد می‌کنید در تمام محیط‌های Pantheon شما یکسان خواهد بود (مشابه نحوه وجود توسعه‌دهندگان در محیط‌های Pantheon).

برای ارتقا از SmartDocs بتا به در دسترس بودن عمومی

1. نسخه 15.05.27 را در برنامه نویس خود یا محیط های آزمایشی در Pantheon به روز کنید و آزمایش کنید.
2. یک مدل جدید برای جایگزینی هر مدل API موجودی که استفاده می کردید ایجاد کنید.
   • اگر اسناد Swagger یا WADL را وارد کرده اید، آنها را دوباره در یک ویرایش جدید وارد کنید.
   • اگر مدل API خود را از طریق ماژول SmartDocs حفظ کرده اید، به عنوان SmartDocs JSON صادر کنید و با استفاده از پیوست فایل به مدل جدید خود وارد کنید.
3. ویژگی های امنیتی بازبینی مدل خود را تنظیم کنید. در صفحه Content > SmartDocs > Model ، تنظیمات امنیتی را انتخاب کنید.
   
4. هر گونه احراز هویت از پیش پیکربندی شده را در صفحه تنظیمات مدل ( محتوا > SmartDocs ) با کلیک روی تنظیمات در ستون عملیات بررسی کنید.
   
5. هر قالب سفارشی را برای استفاده از نسخه 6 دارایی های CSS و JS به روز کنید و تغییراتی را برای منعکس کردن نام اشیاء جدید مانند authSchemes و apiSchema ایجاد کنید. برای اطلاعات در مورد به‌روزرسانی الگوهای SmartDocs، به استفاده از SmartDocs برای مستندسازی APIها مراجعه کنید.
6. نسخه مدل خود را دوباره رندر و منتشر کنید.
7. پس از تأیید اعتبار اسناد جدید، پورتال تولید خود را به نسخه 15.05.27 به روز کنید.

اگر مشتری سازمانی Edge هستید و در مورد فرآیند ارتقا سؤال یا نگرانی دارید، لطفاً به marsh@apigee.com و cnovak@apigee.com ایمیل بزنید. در غیر این صورت، لطفا از انجمن Apigee برای بهترین پاسخ استفاده کنید.

تغییرات و پیشرفت های ویژگی های آینده

این بخش پیش نمایش تغییرات و پیشرفت های مورد انتظار ویژگی های آینده است:

به رفتار خط مشی کش پاسخ تغییر دهید

در نسخه بعدی (که مشخص می شود)، رفتار پیش فرض عنصر <ExcludeErrorResponse> خط مشی Response Cache تغییر خواهد کرد.

رفتار فعلی: عنصر <ExcludeErrorResponse> در خط مشی کش پاسخ به طور پیش فرض نادرست است. این بدان معناست که به طور پیش‌فرض، پاسخ‌هایی با هر کد وضعیت HTTP احتمالی (از جمله 3xx) توسط خط‌مشی کش پاسخ ذخیره می‌شوند.

رفتار آینده: عنصر <ExcludeErrorResponse> در خط مشی Response Cache به طور پیش فرض درست است. این بدان معناست که به طور پیش‌فرض، تنها پاسخ‌هایی با کدهای وضعیت HTTP 200 تا 205 در حافظه پنهان ذخیره می‌شوند. برای لغو این رفتار و ذخیره پاسخ‌ها برای همه کدهای وضعیت، باید عنصر <ExcludeErrorResponse> را به طور صریح روی true تنظیم کنید.

راه‌حل فعلی: برای نسخه‌های Private Cloud 4.15.07.00 و نسخه‌های قدیمی‌تر، اگر می‌خواهید پاسخ‌ها را فقط با کدهای وضعیت 200 تا 205 در حافظه پنهان ذخیره کنید، باید به صراحت عنصر <ExcludeErrorResponse> را روی true تنظیم کنید.

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

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

مسائل شناخته شده

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

> source /{install-dir}/apigee4/bin/apigee-env.sh 

> VER=`basename $(find $SHARE_DIR/installer/monetization -name "mint-*.zip") | cut -d "-" -f 2,3,4` 

> sed -i "s/^MONETIZATION_VERSION=.*/MONETIZATION_VERSION=$VER/" /install-dir/apigee4/bin/apigee-env.sh 

> rm /install-dir/apigee4/share/monetization 

************************************** 
In order to complete the monetization upgrade please run: 
sudo /opt/apigee4/share/monetization/schema/migration/MOPDK4.15.04.00/
365-create-notification-condition.sh 
************************************** 

connect.ranges.denied=10.0.0.0/8,192.168.0.0/16,127.0.0.1/32

<install_dir>/apigge4/bin/apigee-service message-processor restart