Примечания к выпуску 4.18.05 Edge для частного облака

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

В этом разделе описана версия 4.18.05 Edge для частного облака.

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

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

Новые функции ○ Правила JWT теперь общедоступны.
○ Теперь поддерживается RedHat Enterprise Linux 6.9.
○ Теперь поддерживается Oracle Linux 6.9.
○ Теперь поддерживается CentOS 6.9.
○ Изменения в конфигурации установки нового интерфейса Edge.
○ Теперь параметры повторных попыток маршрутизатора можно задавать на уровне виртуального хоста.
Включенные релизы
○ Edge UI:
   18.04.04
   18.03.02
   18.02.14
   17.11.06 		○ Edge Management/Runtime:
   18.04.06
   18.04.04
   18.03.02
   18.02.02
   18.01.05
 ○ Portal:
   18.04.25.01
   18.04.25.00
   18.04.23.00
   18.03.28.00
   18.03.05.00
   18.02.15.00
   18.01.31.00
   17.12.20.00
Устаревшие функции ○ API BaaS
○ Панель управления мониторингом (бета-версия)
Устаревшие функции ○ Защищенные хранилища Apigee (сейфы) заменены на KVM.
○ Добавление путей на вкладке "Производительность" прокси-сервера API.
○ Свойство SMTPSSL для портала Developer Services.
Исправление ошибок ○ Запретить изменение адреса электронной почты пользователя (65550638).
○ Уязвимость системы безопасности в jackson-databind (69711616).
○ Утечка памяти в процессорах сообщений (71612599).
Известные проблемы

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

○ Резервная копия Message Processor не содержит нужный набор файлов (121095148).
○ Зависают запросы HEAD к целевым объектам Node.js (79993247).
○ Отображается вариант создания обратного прокси через Open API (79949124).
○ Не удается разрешить имена хостов (79757554).
○ Исключения DataAccessExceptions в конфигурациях с несколькими центрами обработки данных (76087166).
○ При остановке apigee-postgresql появляется сообщение об ошибке разрешений (72379834).
○ Правило MessageLogging включает дополнительную информацию в сообщение в журнале (68722102).

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

Ниже вы найдете подробную информацию по каждому из этих вопросов.

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

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

С версии 4.18.01 Выполнить прямой переход с версии 4.18.01 на 4.18.05.
С версии 4.17.09 Выполнить прямой переход с версии 4.17.09 на 4.18.05.
От 4.17.05 Выполнить прямой переход с версии 4.17.05 на 4.18.05.
От 4.17.01 Переход с версии 4.17.01 на 4.18.01, а затем с версии 4.18.01 на 4.18.05
С 4.16.09 Переход с версии 4.16.09 на 4.18.01, а затем с версии 4.18.01 на 4.18.05
С 16.05.2024 Переход с версии 4.16.05 на 4.18.01, а затем с версии 4.18.01 на 4.18.05.
С версии 4.16.01 Переход с версии 4.16.01 на 4.18.01, а затем с версии 4.18.01 на 4.18.05.
От 4.15.0x Перейдите с версии 4.15.0x на 4.16.01, а затем с 4.16.01 на 4.18.01, а после этого с 4.18.01 на 4.18.05.

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

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

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

Правила использования JWT

Следующие правила JWT больше не находятся на этапе бета-тестирования и теперь доступны всем пользователям:

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

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

  • Теперь поддерживается Red Hat Enterprise Linux (RHEL) 6.9
  • Теперь поддерживается Oracle Linux 6.9
  • Теперь поддерживается CentOS 6.9
  • Прекращена поддержка RHEL/CentOS/Oracle Linux 7.2

Подробнее о поддерживаемом ПО и его версиях…

Изменения в конфигурации установки нового интерфейса Edge

В версии 4.18.05 нового интерфейса Edge внесены изменения в файл конфигурации по сравнению с версией 4.18.01. Новые свойства описаны в разделе Изменения конфигурации установки в Edge 4.18.01.

Настройки повторных попыток маршрутизатора теперь можно задавать на уровне виртуального хоста

Теперь вы можете задать параметры повторных попыток для связи маршрутизатора с Message Processor на виртуальном хосте. Это позволяет более точно управлять трафиком, чем предыдущие варианты, которые можно было задать только на уровне маршрутизатора.

Подробнее о свойствах конфигурации виртуального хоста…

Новый параметр Аналитики и изменение параметра x_forwarded_for_ip

Изменился способ, которым Edge устанавливает параметр x_forwarded_for_ip в Edge Analytics. Ранее, если в заголовке X-Forwarded-For было несколько IP-адресов, параметр x_forwarded_for_ip содержал только последний из них. Клиенты часто использовали параметр x_forwarded_for_ip, чтобы определить IP-адрес клиента, отправляющего запрос к API в Edge.

В этом выпуске параметр x_forwarded_for_ip теперь содержит полный список IP-адресов в заголовке X-Forwarded-For.

Предупреждение. Заголовок X-Forwarded-For может быть подделан IP-адресом, которому запрещен доступ, за исключением последнего адреса в заголовке, который является IP-адресом, полученным Edge от последнего внешнего рукопожатия TCP. Чтобы определить исходный IP-адрес клиента, который отправляет запрос к API в Edge, в этом выпуске в Edge Analytics добавлен новый параметр: ax_resolved_client_ip.

Теперь вы можете использовать измерение ax_resolved_client_ip в специальном отчете или в условии фильтра в специальном отчете, чтобы определить IP-адрес клиента, отправившего запрос к API. Подробнее о параметрах, показателях и фильтрах Аналитики ax_resolved_client_ip…

Это изменение также влияет на то, как правило AccessControl обрабатывает заголовок X-Forwarded-For. В этой версии Edge автоматически заполняет заголовок HTTP X-Forwarded-For одним IP-адресом, полученным в результате последнего внешнего рукопожатия TCP (например, IP-адресом клиента или маршрутизатора). В предыдущих версиях Edge устанавливал HTTP-заголовок X-Forwarded-For с одним IP-адресом, полученным в результате первого внешнего TCP-подключения (например, IP-адресом клиента или маршрутизатора). Подробнее о заголовке HTTP X-Forwarded-For…

Включенные релизы

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

Интерфейс Edge Управление периферийными устройствами/среда выполнения Портал
18.04.04
18.03.02
18.02.14
17.11.06 		18.04.06
18.04.04
18.03.02*
18.02.02
18.01.05
 18.04.25.01
18.04.25.00
18.04.23.00
18.03.28.00
18.03.05.00
18.02.15.00
18.01.31.00
17.12.20.00
* Исправление ошибки 74622499 не включено в версию Edge для частного облака 4.18.05.

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

Упразднение

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

API BaaS

API BaaS больше не поддерживается. Подробнее о прекращении поддержки, выводе из эксплуатации и изменениях в CPS…

Панель мониторинга (бета-версия)

Панель мониторинга (бета-версия) больше не поддерживается. В результате следующие компоненты больше не входят в установку:

  • apigee-influxdb
  • apigee-telegraf
  • apigee-grafana

Чтобы и дальше получать показатели маршрутизатора, Message Processor и узла, Apigee рекомендует использовать JMX для интеграции данных Edge Private Cloud с вашими инструментами мониторинга. Подробнее о том, что отслеживать и как это делать…

Если вы обновляете существующую установку до версии 4.18.05, вам следует удалить панель мониторинга. Apigee не гарантирует, что он продолжит работать должным образом.

Прекращение поддержки

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

Подробнее о прекращении поддержки, выводе из эксплуатации и изменениях в CPS…

Защищенное хранилище Apigee

Безопасное хранилище Apigee, также известное как хранилище секретов, больше не поддерживается и будет отключено в сентябре 2018 г.

Вместо защищенного хранилища используйте зашифрованные карты "ключ-значение" (KVM), как описано в разделе Работа с картами "ключ-значение". Зашифрованные KVM так же безопасны, как и хранилища, но предоставляют больше возможностей для создания и извлечения данных.

Как добавить пути на вкладке "Эффективность" прокси-сервера API

До этого выпуска вы могли перейти к прокси-серверу API в интерфейсе управления, открыть вкладку Эффективность и создать разные пути для сравнения на основе диаграмм на вкладке Эффективность прокси-сервера и на панели управления Бизнес-транзакции.

Эта функция больше не поддерживается и недоступна в интерфейсе. Альтернативу этой функции можно найти в разделе Альтернатива Business Transactions API.

Свойство SMTPSSL для портала Developer Services

Чтобы задать протокол, используемый SMTP-сервером, подключенным к порталу, теперь нужно использовать свойство SMTP_PROTOCOL вместо свойства SMTPSSL. Допустимые значения параметра SMTP_PROTOCOL: "standard", "ssl" и "tls".

Подробнее об установке портала Developer Services…

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

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

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

Утечка памяти в процессорах сообщений

Устранена утечка памяти. Она возникла в процессорах сообщений, когда был остановлен процесс Qpidd.
69711616

Уязвимость в системе безопасности jackson-databind

Библиотека jackson-databind обновлена до версии 2.7.9.1, чтобы устранить ошибку десериализации.
65550638

Как запретить пользователю менять адрес электронной почты

Теперь вы не можете изменить адрес электронной почты пользователя в полезной нагрузке сообщения, отправленного в Management API. Кроме того, API управления теперь не допускает XML в теле запроса.

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

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

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

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

Решение

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

Запросы HEAD к целевым объектам Node.js зависают

Запросы HEAD к целевому объекту Node.js могут зависать, оставляя подключения в ожидании.

Решение

Чтобы обойти эту проблему, определите обработчик для запросов HEAD, чтобы явно возвращать пустой ответ.
79949124

Отображается вариант "Создать обратный прокси-сервер с помощью Open API"

В мастере прокси-сервера сейчас есть возможность создать новый прокси-сервер с помощью Open API. В Edge для частного облака это сделать нельзя.

Решение

Нет.
79757554

Не удается распознать имена хостов

После установки или обновления Edge для частного облака имена хостов могут не разрешаться в адреса.

Решение

Чтобы устранить эту проблему, перезапустите компонент 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, когда процессоры сообщений сообщают об ошибке DataAccessExceptions при попытке получить значения KVM.

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

Временное решение

Чтобы обойти эту проблему, отмените регистрацию следующих типов узлов Cassandra в недоступном центре обработки данных, а затем зарегистрируйте их снова, когда узлы Cassandra станут доступны:

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

Чтобы отменить регистрацию и повторно зарегистрировать эти типы узлов Cassandra:

  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 – название пода, по умолчанию "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. Повторите шаг 1 для каждого типа узла Cassandra: 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. Подробнее об обновлении регистраций хранилищ данных…
72379834

При остановке apigee-postgresql появляется сообщение об ошибке, связанной с разрешениями

При использовании команды apigee-seriver apigee-postgresql stop для остановки apigee-postgresql может появиться сообщение о том, что apigee-serive не может перейти в домашний каталог пользователя. Это сообщение можно игнорировать.

Решение

Н/Д
68722102

Правило MessageLogging, включающее дополнительную информацию в сообщение журнала

Элемент FormatMessage правила MessageLogging определяет формат регистрируемого сообщения. Если задано значение FormatMessage=false, в регистрируемом сообщении не должно быть информации, сгенерированной Apigee. Однако даже если вы зададите значение FormatMessage=false, сообщение в журнале будет содержать следующую информацию:

  • Оценка приоритета
  • Временная метка

Решение

Нет.

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

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

New installations:
New installation overview
Existing installations:
Upgrade from 4.18.01
Upgrade from 4.17.05 or 4.17.09
Upgrade from 4.17.01
Upgrade from 4.16.09
Upgrade from 4.16.01 or 4.16.05