4.16.05 - Edge for Private Cloud release notes

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

31 мая 2016 г. мы выпустили новую версию Apigee Edge для частного облака.

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

• Облако: 16.02.17, 16.03.02, 16.03.09 (интерфейс), 16.03.16 (интерфейс), 16.03.23 (интерфейс), 16.03.30

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

Новые функции и улучшения

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

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

Руководства по установке и эксплуатации перенесены в онлайн

Теперь вы можете ознакомиться с руководством по установке и эксплуатации Edge для частного облака в версии 4.18.01.

Обновления программного обеспечения

В этой версии есть следующие обновления ПО:

• Java JDK 1.8. Чтобы использовать новейшие функции Java, этот выпуск совместим с Java 1.8. В вашей среде должна быть установлена Oracle JDK 1.8 или OpenJDK 8.
  В рамках обновления до Java 8 некоторые шифры TLS больше не доступны в Oracle JDK 1.8. Полный список можно найти в разделе Default Disabled Cipher Suites (Шифры, отключенные по умолчанию) на странице http://docs.oracle.com/javase/8/docs/technotes/guides/security/SunProviders.html.
• Cassandra 2.1.13 – обновление с Cassandra 2.0.15.

Установка, обновление, откат

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

• Новый процесс обновления с версии 4.16.01. В этой версии утилита apigee-migrate заменена на утилиту update.sh, которая позволяет обновить установленную версию с 4.16.01 до 4.16.05. См. раздел Обновление Apigee Edge 4.16.01 до версии 4.16.05.
• Bootstrap
  • bootstrap.sh (версия 4.16.01) теперь называется bootstrap_4.16.05.sh в версии 4.16.05.
  • Вам больше не нужно указывать uname:pword, чтобы скачать bootstrap_4.16.05.sh.
• Откат. Чтобы выполнить откат обновления до версии 4.16.05, удалите версию компонента 4.16.05 и установите предыдущую версию. Утилита rollback.sh, которая использовалась ранее, удалена. Подробнее о процессе отката версии 4.16.05…
• setup.sh и update.sh могут записывать файл журнала в /tmp. По умолчанию утилиты setup.sh и update.sh записывают информацию журнала в /opt/apigee/var/log/apigee-setup. Если у пользователя, запустившего утилиту, нет доступа к этому каталогу, журнал будет записан в каталог /tmp. Если у пользователя нет доступа к /tmp, утилита не будет работать.
• Процедура обновления API BaaS. В версии 4.16.01 для переноса API BaaS требовалось переустановить его. Новая утилита update.sh позволяет обновлять API BaaS на месте. См. раздел Обновление Apigee Edge 4.16.01 до версии 4.16.05.

Администрирование

Ниже перечислены новые функции для администрирования и настройки частного облака.

• Проверка установки - Утилиту apigee-validate, которая используется для тестирования установки Edge Private Cloud, теперь можно запустить с сервера управления. Раньше скрипт нужно было запускать в обработчике сообщений. Подробнее о том, как проверить установку…
• Название региона – может быть любым. В предыдущих версиях название имело формат dc-#, где # – целое число.
• Поды шлюза могут иметь любое название. В предыдущих версиях контейнер должен был называться gateway.
• Администрирование на основе скриптов. Новая утилита командной строки apigee-adminapi.sh позволяет выполнять те же задачи по настройке Edge, что и при вызовах Edge Management API. Подробнее об утилите apigee-adminapi.sh…
• Настройка SSL для виртуального хоста в фоновом режиме. Теперь при создании организации или среды можно передавать свойства для настройки SSL на виртуальном хосте. Подробнее о том, как зарегистрировать организацию…

Сервисы API

Ниже перечислены новые функции сервисов Edge API, которые были добавлены в предыдущих облачных версиях продукта.

Префикс фиксированной длины для ведения журналов сообщений syslog (Cloud 16.03.30)

В правиле "Ведение журнала сообщений" появился новый элемент <FormatMessage> в конфигурации Syslog. Установив значение <FormatMessage>true</FormatMessage>, вы сможете отфильтровать данные, добавленные Apigee, поскольку сообщения Syslog будут начинаться с фиксированного количества символов. Подробнее о правилах ведения журналов сообщений… (APIRT-1398)

Подстановочный знак в базовом пути прокси-сервера API (интерфейс Cloud 16.03.09)

В интерфейсе управления поддерживается использование одного или нескольких подстановочных знаков /*/ в базовых путях прокси-сервера API. Например, если базовый путь – /team/*/members, клиенты могут вызывать ваш прокси с помощью https://[host]/team/blue/members или https://[host]/team/green/members, и вам не придется создавать новый прокси для поддержки новых команд. Обратите внимание, что метод /**/ использовать нельзя. (MGMT-3154)

Цепочка прокси-серверов API (Cloud 16.03.02, интерфейс Cloud 16.03.09)

Edge поддерживает цепочки локальных прокси-серверов API, которые позволяют одному прокси-серверу API вызывать другой прокси-сервер API, развернутый в организации Edge, без дополнительных сетевых издержек. Раньше для цепочки прокси-серверов API требовался вызов http(s) к другому прокси-серверу API, который пересылал запрос через балансировщик нагрузки, маршрутизатор и обработчик сообщений.

В TargetEndpoint прокси API доступны новые элементы LocalTargetConnection, позволяющие указать имя прокси API, имя определенного ProxyEndpoint в прокси API или просто базовый путь к локальному ресурсу прокси API (например, /v1/myresource). В интерфейсе редактора прокси-сервера эти параметры также доступны при добавлении или обновлении TargetEndpoint.

Цепочка прокси-серверов также доступна в правилах вызова сервисов.

Подробнее о том, как объединять прокси API в цепочки… Новые элементы LocalTargetConnection также перечислены в схеме XML по адресу https://github.com/apigee/api-platform-samples/blob/master/schemas/configuration/configuration_schemas.xsd. (MGMT-3049, MGMT-3050)

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

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

Edge for Private Cloud 4.16.05

Cloud 16.03.30

Интерфейс Cloud 16.03.16

Интерфейс Cloud 16.03.09

Cloud 16.03.02

Облако 16.02.17

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

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

> rm -f /opt/nginx/conf.d/*
> /opt/apigee/apigee-service/bin/apigee-service edge-router restart

Полезные нагрузки JSON в правилах Assign Message, Java Callout и Raise Fault

Правила Assign Message, Java Callout и Raise Fault позволяют создавать контент сообщений с помощью элемента <Set><Payload>. В эти сообщения можно добавлять переменные, значения которых автоматически подставляются во время выполнения. Например, если вы хотите вывести дату из заголовка HTTP, вставьте в письмо {message.header.date}.

Если формат сообщения – JSON, оно будет выглядеть примерно так:

{"The date is: " : "{message.header.date}"}

Однако вы можете заметить, что это неправильный формат JSON. Чтобы обойти эту проблему, выберите один из двух вариантов:

• Чтобы избежать ошибки, поставьте перед открывающей фигурной скобкой обратную косую черту:

  \{"The date is: " : "{message.header.date}"}

• В конфигурации элемента полезной нагрузки используйте атрибуты variablePrefix и variableSuffix, чтобы указать переменную в полезной нагрузке JSON. Пример:
  

  <Payload contentType="application/json" variablePrefix="#" variableSuffix="%">{"The date is: " : "#message.header.date%"}</Payload>

В следующем выпуске Edge для частного облака вы сможете без проблем использовать фигурные скобки для переменных в сообщениях JSON. (APIRT-1160)

Не удалось запустить Nginx на маршрутизаторе или Не удалось запустить маршрутизатор

Если маршрутизатор Edge не может запустить Nginx или не запускается вообще, как показано в файле /opt/apigee/var/log/edge-router/logs/system.log, удалите все файлы в каталоге /opt/nginx/conf.d и перезапустите маршрутизатор:

> rm -f /opt/nginx/conf.d/*
> /opt/apigee/apigee-service/bin/apigee-service edge-router restart