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

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

این بخش نسخه 4.19.01 Edge for Private Cloud Feature Release را توضیح می دهد.

خلاصه انتشار

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

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

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

○ عرضه عمومی (GA) رابط کاربری Edge
○ انتشار درآمد عمومی (GA) در رابط کاربری Edge
○ apigee-monit خدمات خوددرمانی و نظارت را اضافه می کند
○ Edge UI دارای ویژگی های پیکربندی TLS جدید است
○ اکنون می‌توانید میزبان‌های مجازی را در رابط کاربری Edge ایجاد، ویرایش و حذف کنید
○ پشتیبانی OpenAPI v3 اضافه شد
○ RedHat Enterprise Linux (RHEL) و CentOS 7.6 اکنون پشتیبانی می شوند
○ Oracle Linux 7.5 اکنون پشتیبانی می شود

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

شامل انتشارات

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

○ لبه:
18.06.08
18.06.06
18.05.21
18.05.10
18.05.09
18.04.23.00		 ○ پورتال:
18.11.28.00
18.10.17.00
18.10.09.00
18.07.16.00
بازنشستگی ها هیچ کدام
تحقیرها Apigee Edge for Private Cloud نسخه 4.17.09 دیگر پشتیبانی نمی شود (منسوخ شده است).

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

رفع اشکال

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

○ Zookeeper با اسکریپت پشتیبان متوقف نشد (122694069)
○ صفحه فرود «هیچ سازمانی» اضافه نشد (120993451)
○ حذف گزارش های سفارشی (120682369)
○ تب Geomap در New Edge تجربه (120681592)
○ گزینه های Zookeeper JVM (120624977)
○ خطاهای تعریف نشده در راهنمای ابزار رخ داده است (80187407)
○ ایجاد پراکسی معکوس از طریق OpenAPI (79949124)
○ بازنشانی رمزهای عبور عدم ارسال لینک (77515655)
○ هدرهای نادرست برای بازنشانی پیوندهای رمز عبور (72799769)
○ استفاده از WSDL برای ایجاد پروکسی های API (69550284)

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

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

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

○ فرمت فایل متادیتا برای نصب apigee-sso (135616498)
○ apigee-monit در Amazon Linux 1 (122370980) پشتیبانی نمی شود
○ پشتیبان‌گیری پردازشگر پیام از مجموعه صحیح فایل‌ها پشتیبان‌گیری نمی‌کند (121095148)
○ نشانه‌های جلسه باطل نشدند (115278838)
○ وقتی JMX auth فعال است، عملیات Cassandra کار نمی کند (113342838)
○ درخواست‌های HEAD به اهداف Node.js متوقف می‌شوند (79993247)
○ حل نشدن نام هاست (79757554)
○ DataAccess Exceptions در تنظیمات چند مرکز داده (76087166)
○ خط مشی MessageLogging شامل اطلاعات اضافی در پیام گزارش (68722102)
○ بازنشانی رمز عبور مدیریت سیستم ناموفق است (65737520)

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

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

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

از 4.18.05 به طور مستقیم از 4.18.05 → 4.19.01 ارتقا دهید
از تاریخ 4.18.01 به طور مستقیم از 4.18.01 → 4.19.01 ارتقا دهید
از تاریخ 4.17.09 به طور مستقیم از 4.17.09 → 4.19.01 ارتقا دهید
از 4.17.05 ارتقاء از 4.17.05 → 4.18.01 ، سپس ارتقاء از 4.18.01 → 4.19.01
از تاریخ 4.17.01 ارتقاء از 4.17.01 → 4.18.01 ، سپس ارتقاء از 4.18.01 → 4.19.01
از تاریخ 4.16.09 ارتقاء از 4.16.09 → 4.18.01 و سپس ارتقاء از 4.18.01 → 4.19.01
از تاریخ 05/4/16 ارتقاء از 4.16.05 → 4.18.01 ، سپس ارتقاء از 4.18.01 → 4.19.01
از تاریخ 4.16.01 ارتقاء از 4.16.01 → 4.18.01 ، سپس ارتقاء از 4.18.01 → 4.19.01
از 4.15.0x از 4.15.0x → 4.16.01 ارتقا دهید، سپس از ارتقا از 4.16.01 → 4.18.01 ارتقا دهید، سپس از 4.18.01 → 4.19.01 ارتقا دهید

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

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

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

عرضه عمومی (GA) رابط کاربری Edge

رابط کاربری Apigee Edge آخرین سرویس رابط کاربری مدیریتی ما است. قبلاً در بتا بود. با Apigee Edge for Private Cloud نسخه 4.19.01، رابط کاربری Edge بخشی از نسخه عمومی است.

برای استفاده از Edge UI، باید SAML را فعال کنید و سپس Edge UI را روی گره خودش نصب کنید.

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

انتشار درآمد عمومی (GA) در رابط کاربری Edge

نسخه GA از کسب درآمد در رابط کاربری تجربه New Edge اکنون در دسترس است.

اکنون می‌توانید تمام وظایف کسب درآمد را برای Apigee Edge برای Private Cloud در رابط کاربری New Edge تجربه کنید، از جمله موارد زیر:

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

apigee-monit خدمات خوددرمانی و نظارت را اضافه می کند

Apigee Edge for Private Cloud اکنون شامل apigee-monit است، ابزاری مبتنی بر ابزار منبع باز monit . apigee-monit به صورت دوره ای خدمات Edge را نظرسنجی می کند. اگر سرویسی در دسترس نباشد، apigee-monit سعی می کند آن را دوباره راه اندازی کند.

برای اطلاعات در مورد نصب، پیکربندی و استفاده از apigee-monit ، به Self healing with apigee-monit مراجعه کنید.

ویژگی های پیکربندی جدید TLS

رابط کاربری Edge از ویژگی های پیکربندی جدید TLS پشتیبانی می کند که می توانید از آنها برای تنظیم موارد زیر استفاده کنید:

  • پروتکل پیش فرض TLS
  • لیست پروتکل های TLS پشتیبانی شده
  • الگوریتم های TLS پشتیبانی شده
  • رمزهای TLS پشتیبانی می شود

برای اطلاعات بیشتر، به تنظیم ویژگی های اختیاری TLS مراجعه کنید.

هاست های مجازی را در رابط کاربری Edge ایجاد، ویرایش و حذف کنید

عملکرد خود سرویس گسترش یافته است به طوری که اکنون می توانید میزبان های مجازی را در یک مرورگر ایجاد، ویرایش و حذف کنید (فقط Edge UI).

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

پشتیبانی OpenAPI v3 اضافه شد

این نسخه پشتیبانی برای ایجاد یک پروکسی از طریق OpenAPI نسخه 3 (فقط Edge UI) اضافه کرده است.

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

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

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

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

  • Red Hat Enterprise Linux (RHEL) 7.6
  • CentOS 7.6
  • اوراکل لینوکس 7.6

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

  • RHEL/CentOS/Oracle نسخه 7.3
  • RHEL/CentOS نسخه 6.8
  • اوراکل لینوکس 6.7

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

رفع اشکال

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

شناسه شماره توضیحات
122694069

Zookeeper توسط اسکریپت پشتیبان متوقف نشد

فرآیند Zookeeper قبل از این اصلاح توسط اسکریپت پشتیبان متوقف نمی شد.
120993451

صفحه فرود "هیچ سازمانی" اضافه شد

توسعه دهندگانی که با کاربری وارد می شوند که هیچ سازمان مرتبطی ندارد، دیگر به صفحه ای که وجود ندارد فرستاده نمی شوند. یک صفحه فرود جدید برای این کاربران اضافه شده است.
120682369

حذف گزارش های سفارشی

کاربران نمی‌توانند گزارش‌های سفارشی را در تجربه New Edge حذف کنند.
120681592

تب Geomap در تجربه New Edge

هنگامی که کاربران در تجربه New Edge به برگه Geomap پیمایش کردند، تجربه New Edge با خطا مواجه شد.
120624977

گزینه های Zookeeper JVM

تنظیم گزینه های JVM با استفاده از Code with Config برای Zookeeper کار نمی کند.
80187407

خطاهای تعریف نشده در راهنمای ابزار رخ داده است

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

ایجاد پراکسی معکوس از طریق OpenAPI

استفاده از دکمه OpenAPI هنگام ایجاد پراکسی کار نمی کند.
77515655

بازنشانی رمز عبور و عدم ارسال لینک

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

هدرهای نادرست برای بازنشانی پیوندهای رمز عبور

حتی پس از اینکه کاربر خاصیت trustxforwarded را روی true تنظیم کرد، سرصفحه‌های درخواست حاصل از HTTPS استفاده نمی‌کردند.
69550284

استفاده از WSDL برای ایجاد پروکسی های API

تولید پروکسی API هنگام استفاده از WSDL ناموفق بود.

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

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

شناسه شماره توضیحات
135616498

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

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

راه حل:

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

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

    یا

  • از یک مکان مبتنی بر URL برای ابرداده استفاده کنید
122370980

apigee-monit در Amazon Linux 1 پشتیبانی نمی شود

راه حل:

هیچ کدام.
121095148

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

راه حل:

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

115278838

نشانه‌های جلسه باطل نشدند

هنگامی که کاربر روی دکمه Apigee Edge Logout کلیک می کند، نشانه های جلسه در سرور باطل نمی شوند.

راه حل:

از تجربه New Edge با SAML استفاده کنید.

113342838

وقتی JMX auth فعال است، عملیات Cassandra کار نمی کند

راه حل:

هر زمان که دستور nodetool را فراخوانی می کنید، نام کاربری و رمز عبور خود را اضافه کنید.

79993247

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

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

راه حل:

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

79757554

نام هاست حل نمی شود

پس از نصب یا ارتقاء Edge برای 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 متصل شود. DataAccessExceptions در صورتی رخ می دهد که یک گره Cassandra خراب باشد. این همچنین ممکن است منجر به اختلال در ترافیک API شود، جایی که پردازنده‌های پیام هنگام تلاش برای بازیابی KVM، DataAccessExceptions گزارش می‌کنند.

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

راه حل

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

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

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

  1. UUID گره های Cassandra را با استفاده از دستور curl زیر دریافت کنید: 
    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. مرحله یک را برای هر نوع گره کاساندرا تکرار کنید: 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. مرحله 3 را برای هر UUID که در مراحل 1 و 2 جمع آوری کرده اید تکرار کنید.
  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 ندارد. برای اطلاعات بیشتر درباره این دستورات، به‌روزرسانی ثبت‌های فروشگاه داده را ببینید.

68722102

خط مشی MessageLogging شامل اطلاعات اضافی در پیام گزارش

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

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

راه حل:

هیچ کدام.
65737520

بازنشانی رمز عبور مدیریت سیستم ناموفق بود

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

راه حل:

رمز عبور را در یک فایل داده تعریف کنید که سپس به نقطه پایانی /users در مدیریت API ارسال می کنید. برای اطلاعات بیشتر، به تنظیم مجدد رمز عبور مدیریت سیستم مراجعه کنید.

مرحله بعدی

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

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