Примечания к выпуску 4.50.00 Edge for Private Cloud

Вы просматриваете документацию по Apigee Edge.
Перейдите к документации по Apigee X.
Информация

В этом разделе описана версия 4.50.00 выпуска функций Edge для частного облака.

Сводка по выпуску

В таблице ниже приведены основные изменения в этой версии.

Новые функции

В этом выпуске добавлены следующие новые функции:

○ Информация о подключении TLS теперь доступна в прокси API
○ Обновление Zookeeper
○ Доступность портала Drupal 8 и прекращение поддержки Drupal 7

Подробнее о новых функциях…

Обратная совместимость В этой версии Apigee Edge для частного облака появились следующие проблемы, влияющие на обратную совместимость:
     
  • В связи с исправлением проблемы 132443137 (как описано в примечаниях к выпуску общедоступной облачной версии 19.03.01) процессоры сообщений теперь игнорируют заголовки, которые начинаются с X-Apigee-*. Поэтому вам нужно переработать код, в котором используются заголовки X-Apigee-*, и заменить их на поддерживаемые.
  • Изменилось название файлов журнала Cassandra. Сейчас:

    /opt/apigee/var/log/apigee-cassandra/system.log
Включенные релизы

С момента выхода предыдущей версии Edge для частного облака были выпущены следующие версии, которые включены в эту версию:

○ Edge:
   20.04.06 (среда выполнения, управление API, управление монетизацией)
   20.03.27 (интерфейс)
   20.03.16 (аналитика Edge)
   20.03.11 (интерфейс)
   20.02.27 (мониторинг API)
   20.02.24 (интерфейс)
   20.02.03 (мониторинг API)
   20.01.29 (интерфейс)
   20.01.22 (интерфейс)
   20.01.06 (управление API/среда выполнения)
○ Edge (продолжение):
   20.01.06 (интерфейс)
   19.11.13 (отчеты о безопасности API)
   19.10.01 (интерфейс)
   19.09.26 (интерфейс Edge/портал)
   19.08.27 (интерфейс)
   19.08.15 (отчеты о безопасности API)
   19.07.29 (интерфейс)
○ Портал:
   20.05.27.00
   20.04.13.00
   20.03.20.00
   19.12.20.00
   19.11.21.00
   19.09.25.00
Упразднение Нет
Прекращение поддержки

В версии 4.50.00:

  • 4.18.05: версия 4.18.05 Apigee Edge для частного облака больше не поддерживается.

В этом выпуске прекращена поддержка следующих функций:

  • Поддержка прокси-серверов Node.js и защищенных хранилищ
  • Поддержка правил OAuth версии 1
  • Поддержка правил ограничения одновременных запросов
  • Поддержка адаптера Apigee для Istio
  • Поддержка функции раннего доступа к Teams

Более подробную информацию о прекращении поддержки, в том числе о сроках удаления, можно найти в статье Прекращение поддержки и вывод из эксплуатации продуктов Apigee.

Исправление ошибок

В этой версии исправлены следующие ошибки:

○ Процессор сообщений не может загрузить среды, если хранилища ключей настроены с похожими названиями или псевдонимами. (154428338)
○ Конфликт зависимостей QPid при установке исправления (152574421)
○ Ограничитель памяти кеша не учитывает максимальный размер кеша L1 (151449163)
○ Сбои в работе скриптов резервного копирования (150710952)
○ Сервер QPid отправляет лишние сообщения журнала (148231209)
○ Резервная копия Postgresql не сохраняет информацию SSO (147458330)
○ Версия apigee-nginx не обновлена. (146872858)
○ Сообщение "Попробовать новый интерфейс" больше не появляется (145419621)
○ Уязвимость API Apigee SmartDocs (145340106)
○ Сбой скрипта резервного копирования Postgres (145254693)
○ Различные исправления безопасности (142150706)
○ Высокая частота тайм-аутов маршрутизатора для Message Processor (138107618)
○ Сбой скрипта настройки SSO (135616498)
○ Порты JMX (132044907)
○ Периодические ошибки 404 для трафика времени выполнения из-за состояния гонки (130653816)
○ Повреждение OpenLDAP во время обновления (120799182)
○ DataAccessException в конфигурациях с несколькими центрами обработки данных (76087166)
○ Параметр FormatMessage, установленный в значение false в правиле MessageLogging, не работает (68722102)

Подробнее об исправлении ошибок…

Известные проблемы

В этой версии есть следующие известные проблемы:

○ Не удается проверить JWT (159788170).
○ Утечка памяти на серверах рейтинга Mint (137865184).
○ apigee-monit не поддерживается в Amazon Linux 1 (122370980).
○ При резервном копировании процессора сообщений не создается резервная копия нужного набора файлов (121095148).
○ Увеличение доли промахов кеша после обновления (160109014).
○ Ответ HTTP 408 на запрос GET с пустым телом и Content-Encoding: gzip. (159858015)

Подробнее об известных проблемах…

Варианты перехода

В таблице ниже показаны пути обновления для этой версии.

С версии 4.19.01 или 4.19.06 Переход с версии 4.19.01/4.19.06 на 4.50.00
С версии 4.18.05 Перейти с версии 4.18.05 на 4.50.00.

Новые функции

В этом разделе перечислены новые функции, добавленные в этом выпуске. Кроме того, в этот выпуск включены все функции, которые были добавлены в выпуски Edge UI, Edge Management и Portal, перечисленные в разделе Включенные выпуски.

Помимо перечисленных ниже улучшений, в этой версии также повышена удобство использования, производительность, безопасность и стабильность.

Информация о подключении TLS теперь доступна в прокси API

Во время запроса к прокси-серверу API через виртуальный хост, поддерживающий TLS, Edge может собирать информацию о подключении TLS. Теперь ваш прокси-сервер API может получить доступ к этой информации через переменные потока, чтобы выполнить дополнительный анализ и проверку. Подробнее о том, как получить доступ к информации о подключении TLS в прокси-сервере API…

Улучшение смотрителя зоопарка

В этом выпуске используется Zookeeper 3.4.14.

Доступность портала Drupal 8 и прекращение поддержки Drupal 7

Drupal 8 заменил Drupal 7 в качестве рекомендованного Apigee портала для разработчиков для частного облака. Поскольку долгосрочная поддержка Drupal 7 будет прекращена в ноябре 2021 г., модули Apigee для Drupal 7 также не будут поддерживаться с ноября 2021 г. Скрипты установки и обновления для Drupal 7 пока доступны, но их больше не следует использовать. В будущем выпуске они будут удалены.

Чтобы узнать больше о модулях Drupal 8, интегрированных с Apigee, ознакомьтесь со статьей Как создать портал с помощью Drupal 8.

Поддерживаемое ПО

В этом выпуске внесены следующие изменения в поддерживаемое ПО:

Поддержка добавлена Больше не поддерживается

В этом выпуске добавлена поддержка следующих платформ:

  • Red Hat Enterprise Linux (RHEL) 7.8
  • CentOS 7.8
  • Oracle Linux 7.8

В этом выпуске больше не поддерживаются следующие платформы:

  • Red Hat Enterprise Linux (RHEL) 6.10
  • CentOS 6.10
  • Oracle Linux 6.9

Полный список поддерживаемых платформ приведен в разделе Поддерживаемое ПО и его версии.

Исправлены ошибки.

В этом разделе перечислены ошибки личного облака, исправленные в этой версии. Кроме того, в этот выпуск включены все исправления ошибок, которые были добавлены в выпуски Edge UI, Edge Management и Portal, перечисленные в разделе Включенные выпуски.

Идентификатор проблемы Описание
154428338

Процессор сообщений не может загрузить среды, если хранилища ключей настроены с похожими именами или псевдонимами.

Мы устранили конфликт поиска по регулярному выражению при загрузке хранилищ ключей с похожими названиями. Из-за этого Message Processor не мог загрузить среды, связанные с хранилищем ключей, или не запускался, когда во время поиска возвращалось несколько конфликтующих хранилищ ключей.
152574421

Конфликт зависимостей QPid при установке исправления

Теперь установлена правильная версия QPid.
151449163

Ограничитель кеш-памяти не учитывает максимальный размер кеша L1

Ограничитель кеша памяти теперь учитывает максимальный размер кеша L1.
150710952

Скрипты резервного копирования не работают

Процедура резервного копирования была обновлена на основе новых скриптов.
148231209

Сервер QPid отправляет дополнительные сообщения журнала

Сервер QPid больше не отправляет лишние сообщения журнала.
147458330

Резервная копия Postgresql не сохраняет информацию SSO

Резервные копии Postgresql теперь содержат информацию SSO.
146872858

Версия apigee-nginx не обновлена.

Версия apigee-nginx теперь обновляется правильно.
145419621

Сообщение "Попробуйте новый интерфейс" больше не появляется

В интерфейсе больше не показывается сообщение "Попробуйте новый интерфейс".
145340106

Уязвимость Apigee SmartDocs API

Обновлен прокси-сервер Apigee SmartDocs для устранения уязвимости. Дополнительную информацию и необходимые действия можно найти в инструкции по установке SmartDocs.
145254693

Сбой скрипта резервного копирования Postgres

Скрипт резервного копирования Postgres теперь работает правильно.
142150706

Различные исправления системы безопасности

Исправлены проблемы с безопасностью, в том числе #111390246.
138107618

Высокая частота тайм-аутов при передаче данных от маршрутизатора к Message Processor

Мы уже устранили эту проблему.
135616498

Сбой скрипта настройки SSO

Исправлена проблема, из-за которой при использовании URL со схемой file:// не удавалось выполнить скрипт настройки SSO.
132044907

Порты JMX

Порты JMX должны быть открыты только для внутренних серверов, но не для внешнего доступа.
130653816

Периодические ошибки 404 для трафика во время выполнения из-за состояния гонки

Устранена проблема с состоянием гонки во время начальной загрузки MP, из-за которой некоторые прокси-серверы не развертывались правильно.
120799182

Повреждение OpenLDAP во время обновления

Мы уже устранили эту проблему.
76087166

Исключение DataAccessException в конфигурациях с несколькими центрами обработки данных

Если в конфигурации с несколькими центрами обработки данных один из них становится недоступен, ошибка DataAccessException больше не появляется.
68722102

Параметр FormatMessage со значением false в правиле MessageLogging не работает

Теперь в правиле MessageLogging можно задать значение false для параметра FormatMessage.

Известные проблемы

В таблице ниже перечислены известные проблемы в этом выпуске.

Идентификатор проблемы Описание
159788170

Не удалось проверить JWT

Проверка JWT не выполняется для ключей RSA размером менее 2048 бит.

Решение

Убедитесь, что размер ключей составляет не менее 2048 бит.
137865184

Утечка памяти на серверах рейтинга Mint

Когда в mxgroup регистрируется новый экземпляр Qpid, очереди создаются без потребителей, в результате чего глубина очереди увеличивается до тех пор, пока не будут использованы все доступные ресурсы.

Решение

Нет.
122370980

apigee-monit не поддерживается в Amazon Linux 1

Решение

Нет.
121095148

Резервная копия Message Processor не содержит нужные файлы

Решение

Запустите резервное копирование ещё раз. На этот раз будет скопирован правильный набор файлов.

160109014

Увеличение доли промахов кеша после обновления

После обновления до версии 4.50.00 прокси-серверы могут показывать более высокий процент промахов кеша. В журналах MP могут появляться сообщения об ошибках, похожие на приведенные ниже.

InvalidClassException when fetching cps cache entry from second level - com.apigee.jsonparser.LinkedJSONObject; local class incompatible: stream classdesc serialVersionUID = -8575741446425131573, local class serialVersionUID = 752634431212433936. Considering it as cache miss.

Решение

Нет. Ожидается, что со временем коэффициент попадания в кеш стабилизируется.

159858015

Ответ HTTP 408 на GET-запрос с пустым телом и Content-Encoding: gzip.

API-клиент получит ответ 408 Timeout, если отправит GET-запрос с заголовком Content-Encoding: gzip и пустым телом запроса.

Решение

Не указывайте заголовок Content-Encoding при выполнении запросов GET с пустым телом.

Дальнейшие действия

Чтобы начать работу с Edge for Private Cloud 4.50.00, воспользуйтесь следующими ссылками:

Новые установки:
Обзор новой установки
Существующие установки:
Пути обновления