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 for Private Cloud версии 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) теперь называется 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 — Модули Gateway могут иметь любое имя. В предыдущих версиях модуль должен был называться «gateway».
• Администрирование на основе скриптов — новая утилита командной строки apigee-adminapi.sh позволяет выполнять те же задачи по настройке Edge, что и с помощью вызовов API управления Edge. См. раздел Использование утилиты apigee-adminapi.sh .
• Автоматическая настройка SSL для виртуального хоста . При создании организации или среды теперь можно передавать свойства для настройки SSL на виртуальном хосте. См. раздел «Внедрение организации» .

API-сервисы

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

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

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

Новые элементы LocalTargetConnection доступны для TargetEndpoint прокси-сервера API, позволяя указать имя прокси-сервера 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 для частного облака 4.16.05

Облако 16.03.30

Cloud 16.03.16 UI

Cloud 16.03.09 UI

Облако 16.03.02

Облако 16.02.17

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

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

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

Полезные данные JSON в политиках назначения сообщений, вызова Java и вызова сбоев

Политики «Назначить сообщение», «Вызов Java» и «Вызвать ошибку» позволяют генерировать содержимое сообщения с помощью элемента <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 для частного облака вы сможете без проблем использовать фигурные скобки для переменных в сообщениях 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