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

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

این بخش نسخه ۴.۱۹.۰۶ از ویژگی Edge برای فضای ابری خصوصی را شرح می‌دهد.

خلاصه انتشار

جدول زیر خلاصه‌ای از تغییرات این نسخه را نشان می‌دهد:

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

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

○ پشتیبانی از LDAP برای SSO
○ پشتیبانی از استقرار HTTP
○ تجزیه و تحلیل قابل اتصال
○ پشتیبانی از رک کاساندرا
○ پشتیبانی از IPv6
○ نصب ساده و روان مرورگر اج جدید
○ حذف تراکنش‌های INVALID_TSC (کسب درآمد)

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

سازگاری با نسخه‌های قبلی

مشکلات زیر که بر سازگاری با نسخه‌های قبلی تأثیر می‌گذارند، در این نسخه از Apigee Edge برای فضای ابری خصوصی معرفی شده‌اند:

  • با توجه به رفع مشکل ۱۳۲۴۴۳۱۳۷ (همانطور که در یادداشت‌های انتشار Public Cloud در تاریخ ۱۹.۰۳.۰۱ توضیح داده شده است)، پردازشگرهای پیام اکنون هدرهایی را که با X-Apigee-* شروع می‌شوند، نادیده می‌گیرند. در نتیجه، شما باید هر کدی را که از هدرهای X-Apigee-* استفاده می‌کند، اصلاح کرده و آن هدرها را با هدرهای پشتیبانی شده جایگزین کنید.

  • نام فایل‌های لاگ کاساندرا تغییر کرده است. اکنون به صورت زیر است:

    /opt/apigee/var/log/apigee-cassandra/system.log
نسخه‌های منتشر شده

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

○ لبه:
۱۹.۰۷.۲۳ (رابط کاربری)
۱۹.۰۳.۰۱
۱۹.۰۲.۱۹
۱۹.۰۲.۰۴
۱۹.۰۱.۲۳
۱۹.۰۱.۱۴
۱۸.۱۲.۰۴
۱۸.۰۸.۳۱
۱۸.۰۷.۳۱		 ○ پورتال:
۱۹.۰۷.۰۸
۱۹.۰۵.۲۳
۱۹.۰۵.۰۸
۱۹.۰۴.۱۸
۱۹.۰۳.۲۰
۱۹.۰۲.۲۷
۱۹.۰۲.۲۱
۱۹.۰۲.۰۴
۱۹.۰۱.۱۶
بازنشستگی هیچکدام
منسوخ‌شده‌ها

با انتشار نسخه ۴.۱۹.۰۶، موارد زیر منسوخ شده‌اند:

  • ۴.۱۸.۰۱: نسخه ۴.۱۸.۰۱ از Apigee Edge برای فضای ابری خصوصی اکنون منسوخ شده است.

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

رفع اشکالات

این نسخه شامل رفع اشکالات زیر است:

○ UseStringDeduplication تنظیم نشده است (140270474)
○ خطاهای MP (111445518)
○ خرابی‌های کاساندرا با JMX (113342838)
○ ارتقاء ۱۳ گره‌ای (۱۳۸۹۳۱۳۳۷)
○ پروکسی‌هایی با نام مشابه (119802562)
○ عدم بارگذاری کی‌استورها (۱۱۸۸۵۱۷۹۰)
○ تجزیه و تحلیل ناموفق بود (110988191)
○ خرابی‌های پشتیبان‌گیری (110785400)
○ درخواست‌های HEAD به Node.js (79993247)
○ پشتیبان‌گیری/بازیابی apigee-postgres (70291825)
○ تنظیم مجدد رمز عبور sysadmin (65737520)

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

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

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

○ ضرابخانه در ابتدا تراکنش‌ها را رتبه‌بندی نمی‌کند (141628497)
○ نشت حافظه سرورهای رتبه‌بندی مینت (۱۳۷۸۶۵۱۸۴)
○ فرمت فایل متادیتا برای نصب apigee-sso (۱۳۵۶۱۶۴۹۸)
○ apigee-monit در آمازون لینوکس ۱ (۱۲۲۳۷۰۹۸۰) پشتیبانی نمی‌شود
○ پشتیبان‌گیری پردازشگر پیام، مجموعه صحیحی از فایل‌ها را پشتیبان‌گیری نمی‌کند (121095148)
○ استثنائات دسترسی به داده‌ها در پیکربندی‌های چند مرکز داده (76087166)
○ سیاست ثبت پیام شامل اطلاعات اضافی در پیام ثبت (۶۸۷۲۲۱۰۲)

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

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

جدول زیر مسیرهای ارتقاء این نسخه را نشان می‌دهد:

از ۱۹/۴/۰۱ ارتقاء مستقیم از ۴.۱۹.۰۱ → ۴.۱۹.۰۶
از ۱۸/۴/۰۵ ارتقاء مستقیم از ۴.۱۸.۰۵ → ۴.۱۹.۰۶
از ۱۸/۴/۰۱ ارتقاء مستقیم از ۴.۱۸.۰۱ → ۴.۱۹.۰۶

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

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

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

پشتیبانی از استقرار HTTP

به طور پیش‌فرض، اج از RPC برای استقرار پروکسی‌های API استفاده می‌کند. اگرچه این حالت برای اکثر نصب‌ها بسیار خوب کار می‌کند، اما توپولوژی‌های بزرگتر با تعداد زیادی MP ممکن است هنگام برقراری تعداد زیادی تماس همزمان از طریق RPC، دچار وقفه شوند.

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

برای اطلاعات بیشتر، به فعال کردن استقرار HTTP مراجعه کنید.

پشتیبانی رک کاساندرا

Apigee اکنون با آگاه‌سازی Cassandra در Apigee Edge برای رک‌های Private Cloud، راهنمایی‌های کلی برای عملیات مقیاس‌پذیری Cassandra ارائه می‌دهد.

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

تجزیه و تحلیل قابل اتصال

به طور پیش‌فرض، داده‌های تحلیلی جمع‌آوری‌شده توسط پردازنده پیام برای پردازش در Qpid و Postgres بارگذاری می‌شوند. سپس می‌توانید داده‌های تحلیلی را در رابط کاربری Edge مشاهده کنید.

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

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

نصب ساده و روان New Edge

نصب تجربه New Edge با یک اسکریپت جدید ساده شده است.

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

پشتیبانی از LDAP IDP

احراز هویت کاربران با رابط کاربری Edge و فراخوانی‌های API مدیریت Edge اکنون علاوه بر SAML از LDAP نیز پشتیبانی می‌کند. پشتیبانی LDAP شامل روش‌های اتصال مستقیم و اتصال غیرمستقیم می‌شود.

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

پشتیبانی از IPv6

به طور پیش‌فرض، تمام فراخوانی‌های API زمان اجرا به Apigee Edge برای Private Cloud از IPv4 استفاده می‌کنند. می‌توانید با یک ویژگی جدید، پشتیبانی از IPv6 را به روتر اضافه کنید.

برای اطلاعات بیشتر، به استفاده از IPv6 در روتر مراجعه کنید.

تراکنش‌های INVALID_TSC را حذف کنید (کسب درآمد)

اکنون می‌توانید هنگام استفاده از قابلیت کسب درآمد، تراکنش‌های INVALID_TSC را از اضافه شدن به پایگاه داده Postgres مستثنی کنید.

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

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

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

پشتیبانی اضافه شد دیگر پشتیبانی نمی‌شود

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

  • لینوکس ردهت انترپرایز (RHEL) 6.10
  • سنت او اس ۶.۱۰
  • اوراکل لینوکس ۶.۹

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

  • لینوکس ردهت انترپرایز (RHEL) 6.9
  • سنت او اس ۶.۹
  • اوراکل ۶.۸

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

رفع اشکالات

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

شناسه مسئله توضیحات
۱۴۰۲۷۰۴۷۴

UseStringDeduplication تنظیم نشده است

UseStringDeduplication برای اجزای edge-message-processor در محیط‌های عملیاتی تنظیم نمی‌شد.
۱۱۱۴۴۵۵۱۸

خطاهای نماینده مجلس

پردازنده‌های پیام هر 5 دقیقه یکبار پیام خطای زیر را ثبت می‌کردند: 
2019-06-29 00:02:05,775 Apigee-Timer-6 ERROR CMgmt -
  ConnectorServiceImpl.refreshToken() : Connector Management API auth token
  generation failed: 0 null
۱۱۳۳۴۲۸۳

شکست‌های کاساندرا با JMX

عملیات کاساندرا هنگام فعال بودن JMX auth کار نمی‌کرد
۱۳۸۹۳۱۳۳۷

ارتقاء ۱۳ گره‌ای

ارتقاء سیستم‌های ۱۳ گره‌ای از نسخه‌های ۱۷.۰۹، ۱۸.۰۱ و ۱۸.۰۵ با شکست مواجه شد.
۱۱۹۸۰۲۵۶۲

پروکسی‌هایی با نام مشابه

اگر دو کاربر در یک سازمان، پروکسی‌هایی با نام‌های یکسان ایجاد کنند، پروکسی دوم جایگزین پروکسی اول می‌شود. این اتفاق تنها زمانی رخ می‌دهد که کاربران مختلف نتوانند پروکسی دیگر را ببینند.
۱۱۸۸۵۱۷۹۰

فروشگاه‌های کلید بارگیری نمی‌شوند

وقتی بیش از ۱۰۰ ذخیره کلید برای یک سازمان/محیط وجود داشت، بخش ذخیره کلید و مرجع در رابط کاربری Edge بارگذاری نمی‌شد. در عوض، رابط کاربری Internal Error (Error Fetching Keystores) را نمایش می‌داد.
۱۱۰۹۸۸۱۹۱

تجزیه و تحلیل انجام نشد

تجزیه و تحلیل برای محیطی که داده‌های آن از Microgateway با تاریخی در آینده تنظیم شده بود، با شکست مواجه شد.
۱۱۰۷۸۵۴۰۰

خرابی‌های پشتیبان‌گیری

ZooKeeper، Cassandra و OpenLDAP به طور متناوب در پشتیبان‌گیری صحیح از داده‌های خود با خطای زیر مواجه می‌شدند: File changed as we read it.
۷۹۹۹۳۲۴۷

درخواست‌های HEAD به Node.js

درخواست‌های HEAD به یک هدف Node.js ممکن است قطع شوند، که باعث می‌شود اتصالات در حالت انتظار باقی بمانند.
۷۰۲۹۱۸۲۵

پشتیبان‌گیری/بازیابی apigee-postgres

اجرای دستور پشتیبان‌گیری/بازیابی apigee-postgres اکنون از داده‌های همه اجزا پشتیبان تهیه می‌کند.
۶۵۷۳۷۵۲۰

تنظیم مجدد رمز عبور sysadmin

تنظیم مجدد رمز عبور مدیر سیستم برای سرور مدیریت که حاوی کاراکترهای خاص باشد، ناموفق خواهد بود.

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

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

شناسه مسئله توضیحات
۱۴۱۶۲۸۴۹۷

ضرابخانه در ابتدا معاملات را رتبه‌بندی نمی‌کند

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

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

راه حل:

هر پردازنده پیام (MP) را مجدداً راه اندازی کنید، که می‌تواند با موارد زیر انجام شود:
apigee-service edge-message-processor restart

پس از فعال شدن کسب درآمد، راه‌اندازی مجدد MPها باعث می‌شود Edge در هنگام راه‌اندازی، پیکربندی را از ZooKeeper بارگذاری کند. این اتفاق در هر راه‌اندازی مجدد رخ می‌دهد، به این معنی که مشکل فقط در ابتدا اعمال می‌شود.

۱۳۷۸۶۵۱۸۴

نشت حافظه سرورهای رتبه‌بندی مینت

وقتی یک نمونه Qpid جدید در یک mxgroup ثبت می‌شود، صف‌ها بدون مصرف‌کننده ساخته می‌شوند که منجر به افزایش عمق صف تا زمانی می‌شود که از تمام منابع موجود استفاده کند.

راه حل:

هیچ کدام.
۱۳۵۶۱۶۴۹۸

قالب فایل فراداده برای نصب apigee-sso

هنگام نصب apigee-sso و استفاده از فایل metadata.xml به جای URL، اگر فایل metadata.xml شامل خط جدید (CRLF) در انتهای فایل نباشد، فایل metadata.xml به طور کامل خوانده نمی‌شود.

راه حل:

برای حل این مشکل، می‌توانید یکی از کارهای زیر را انجام دهید:

  • یک CRLF به انتهای فایل metadata.xml اضافه کنید.

    یا

  • از یک مکان مبتنی بر URL برای ابرداده استفاده کنید
۱۲۲۳۷۰۹۸۰

apigee-monit در آمازون لینوکس ۱ پشتیبانی نمی‌شود

راه حل:

هیچ کدام.
۱۲۱۰۹۵۱۴۸

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

راه حل:

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

۷۶۰۸۷۱۶۶

خطای DataAccessException در پیکربندی‌های مختلف مرکز داده

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

DataAccessException: Error while accessing datastore;
Please retry later

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

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

راه حل

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

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

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

  1. با استفاده از دستور curl زیر، UUID های گره‌های کاساندرا را دریافت کنید:
    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 نام مرکز داده‌ای است که سرور مدیریت (Management Server) در آن قرار دارد.
    • GATEWAY_POD نام پاد است که به طور پیش‌فرض "gateway" است. با این حال، ممکن است آن را به چیز دیگری تغییر نام داده باشید، بنابراین پیاده‌سازی خود را بررسی کنید.
    • 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. مرحله اول را برای هر نوع گره کاساندرا تکرار کنید: 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 ندارند. برای اطلاعات بیشتر در مورد این دستورات، به بخش «به‌روزرسانی ثبت‌های فروشگاه داده» مراجعه کنید.

۶۸۷۲۲۱۰۲

سیاست ثبت پیام شامل اطلاعات اضافی در پیام ثبت

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

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

راه حل:

هیچ کدام.

مرحله بعدی

برای شروع کار با Edge برای Private Cloud 4.19.06، از لینک‌های زیر استفاده کنید:

تاسیسات جدید:
نمای کلی نصب جدید
تاسیسات موجود:
مسیرها را ارتقا دهید