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

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

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

Начиная с предыдущего выпуска функционала Edge for Private Cloud (4.16.01), были выпущены следующие версии, которые включены в данный релиз:

• Облако: 16.02.17 , 16.03.02 , 16.03.09 (UI), 16.03.16 (UI) , 16.03.23 (UI) , 16.03.30

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

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

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

Для получения более подробной информации и инструкций см. документацию Edge for Private Cloud.

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

Теперь вы можете получить доступ к руководству по установке и эксплуатации 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. Полный список см. в разделе «Отключенные по умолчанию наборы шифров» http://docs.oracle.com/javase/8/docs/technotes/guides/security/SunProviders.html .
• Cassandra 2.1.13 — Обновление с Cassandra 2.0.15.

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

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

• Новый процесс обновления с версии 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) в версии 4.16.05 теперь называется bootstrap_4.16.05.sh .
  • Для загрузки файла bootstrap_4.16.05.sh больше не нужно указывать uname:pword .
• Откат — Чтобы откатить обновление до версии 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, что и при обращении к API управления Edge. См. раздел «Использование утилиты apigee-adminapi.sh» .
• Настройка SSL на виртуальном хосте в автоматическом режиме — теперь при создании организации или среды можно передавать свойства для настройки SSL на виртуальном хосте. См. раздел «Подключение организации» .

API-сервисы

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

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

В политике ведения журнала сообщений появился новый элемент <FormatMessage> в конфигурации Syslog. Установив <FormatMessage>true</FormatMessage> , сообщения Syslog начинаются с фиксированного количества символов, что позволяет фильтровать данные, вставляемые Apigee. Для получения дополнительной информации см. Политику ведения журнала сообщений . (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 UI)

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

Облако 16.03.30

Пользовательский интерфейс Cloud 16.03.16

Пользовательский интерфейс Cloud 16.03.09

Облако 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}"}

• В конфигурации элемента Payload используйте атрибуты variablePrefix и variableSuffix для указания переменной в JSON-данных. Например:
  

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

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

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

Если маршрутизатор Edge Router не запускает 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