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

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

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

Со времени предыдущего ежеквартального выпуска Edge for Private Cloud (4.15.07.00) были выпущены следующие выпуски, которые включены в этот выпуск функций:

• Облако: 15.07.08 , 15.07.22 , 15.08.05 , миграция Nginx , 15.09.02 , 15.09.30 , 16.01.20
• Частное облако: 15.07.01 , 15.07.03.

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

Устаревания

Частное облако 4.15.07.03

curl http:// <qpid_IP>:8083/v1/servers/self/queues

Аналитика: представление нескольких отчетов на панели пользовательских отчетов (Cloud 15.09.30)

Специальная функция панели пользовательских отчетов , обеспечивающая просмотр до четырех пользовательских отчетов, устарела и будет удалена в будущем выпуске. (МГМТ-2673). Все остальные аспекты пользовательских отчетов по-прежнему будут доступны.

Невозможно переопределить длину имени организации в частном облаке.

Вы больше не можете переопределить длину имени организации в 20 символов, установив:

• APIGEE_ORG_NAME_LENGTH=25

• APIGEE_ENV_NAME_LENGTH=25

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

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

Частное облако

Добавлена ​​поддержка RedHat, CentOS и Oracle 6.7–7.2.

В этом выпуске добавлена ​​поддержка RedHat Enterprise Linux, CentOS и Oracle Linux версий с 6.7 по 7.2.

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

Установка на основе RPM

В этом выпуске Edge используется механизм установки на основе RPM, который значительно упрощает процедуры установки и миграции.

Новый базовый каталог

Структура каталогов для версии Edge 4.16.01 изменилась. В предыдущих выпусках Edge вы устанавливали Edge в базовый каталог:

/<install-dir>/apigee4

Где каталог установки может находиться где угодно, по умолчанию /opt . Например:

/opt/apigee4

Для версии 4.16.01 необходимо установить Edge в следующий каталог:

/opt/apigee

Также обратите внимание, что каталог apigee4 был изменен на apigee .

Местоположение вашего каталога данных не затрагивается. Он может находиться в /opt/apigee или в другом месте.

Новое требование к виртуальному хосту

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

Дополнительную информацию о том, как добавить псевдоним хоста к существующему виртуальному хосту, см. в Руководстве по установке Edge, доступном на ftp-сайте Apigee: ftp://ftp.apigee.com/ .

Код с конфигом

В Edge версии 4.16.01 вы больше не используете файлы .properties в каталоге /<install-dir>/apigee4/conf для настройки компонентов Edge. Начиная с версии 4.16.01 вы по-прежнему настраиваете компоненты Edge с помощью файлов .properties, но теперь они расположены в каталоге:

/opt/apigee/customer/application

Для каждого компонента Edge, установленного на узле, в этом каталоге будет файл .properties. Чтобы настроить компонент, отредактируйте соответствующий файл .properties, чтобы либо изменить значение существующего свойства, либо добавить новое свойство и значение. Если файл еще не существует, вы можете его создать.

В отличие от предыдущих версий Edge, файлы .properties для Edge 4.16.01 не содержат всех свойств компонента. Одним из изменений в этом выпуске является то, что файлы .properties содержат только переопределения значений свойств по умолчанию.

Преимущество этой архитектуры заключается в том, что при переходе на более позднюю версию Edge установщик Edge никогда не перезаписывает файлы в /opt/apigee/customer/application . Это исключает вероятность того, что Edge случайно перезапишет ваши настройки.

При миграции установщик Edge проверяет существующие файлы .properties и копирует изменения значений свойств по умолчанию в каталог /opt/apigee/token . Таким образом, вам не придется вносить какие-либо изменения после миграции.

Дополнительную информацию см. в Руководстве по эксплуатации Apigee Edge, доступном на ftp-сайте Apigee: ftp://ftp.apigee.com/ .

Скрипты настройки Edge заменены.

Скрипты конфигурации, которые вы использовали в предыдущих выпусках Edge, были удалены и заменены:

• Команды, которые вы запускаете с помощью утилит Apigee, таких как утилиты apigee-service, apigee-all, apigee-setup, apiee-provision или apigee-migrate.
  Например, сценарии all-start.sh и all-stop.sh заменены следующими командами:
  > /opt/apigee/apigee-service/bin/apigee-all start
  > /opt/apigee/apigee-service/bin/apigee-all остановить
• Команды, которые вы запускаете непосредственно на компонентах Edge. Например, в предыдущих выпусках вы использовали сценарий chpasswd-openldap.sh, используемый для изменения пароля OpenLDAP. Этот сценарий был заменен следующей командой, которую вы запускаете в компоненте apigee-openldap:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-openldap изменить-ldap-пароль -o oldPword -n newPword

Дополнительную информацию о том, как теперь выполнять настройку с помощью команд, см. в Руководстве по эксплуатации Apigee Edge, доступном на ftp-сайте Apigee: ftp://ftp.apigee.com/ .

Новый пограничный маршрутизатор

Этот выпуск Edge для частного облака включает новую архитектуру маршрутизатора, основанную на маршрутизаторе Nginx. Маршрутизатор Nginx заменяет маршрутизатор Netty, используемый в выпусках Edge до 4.16.01.

Маршрутизаторы Nginx имеют те же требования к оборудованию и портам, что и маршрутизатор Netty, поэтому никаких изменений в существующих узлах не требуется.

Дополнительную информацию см. в Приложении A: О маршрутизаторе Nginx в Руководстве по установке Edge, доступном на FTP-сайте Apigee: ftp://ftp.apigee.com/ ,

Балансировщик нагрузки BaaS удален.

Внутренний балансировщик нагрузки был удален с портала API BaaS. Теперь вам необходимо использовать собственный балансировщик нагрузки между порталом API BaaS и тремя узлами стека API BaaS.

В качестве альтернативы балансировщику нагрузки вы можете использовать DNS с циклическим перебором. В этом сценарии вы создаете запись DNS с несколькими записями A, соответствующими IP-адресам стека BaaS. Во время поиска DNS DNS-сервер автоматически возвращает значения записи A в циклическом порядке.

Новая документация, описывающая, как добавить узлы Cassandra и ZooKeeper, а также как добавить центр обработки данных к существующему центру обработки данных.

ZIP-файл документации на ftp-сайте Apigee теперь содержит «Scaling Edge для частного облака», описывающий, как добавить узлы Cassandra и ZooKeeper, а также как добавить центр обработки данных к существующему центру обработки данных.

Инструмент организации удален.

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

Как выполнять задания в 4.16.01

В следующей таблице показано, как вы выполняли задачи в версии 4.15.07.03 и как вы выполняете их сейчас в версии 4.16.01. Дополнительную информацию см. в руководстве Edge Operations Guide , доступном на ftp-сайте Apigee: ftp://ftp.apigee.com/ .

Альфа-версия инструмента мониторинга и информационной панели

В этот выпуск включена альфа-версия нового инструмента мониторинга и информационной панели для Edge. Этот инструмент позволяет вам понять состояние различных компонентов (маршрутизаторы, процессоры сообщений, ZooKeeper, Cassandra), а также коды ошибок http для различных организаций и сред в вашем развертывании. Вы также можете сделать снимок данных своей информационной панели и поделиться им с Apigee, чтобы помочь разрешить инциденты в службе поддержки.

Документация, включая инструкции по установке, включена в ZIP-файл документа Edge 4.16.01, доступный на ftp-сайте Apigee: ftp://ftp.apigee.com/ .

Однако прежде чем вы сможете установить и использовать панель мониторинга, вы должны заполнить Соглашение об ознакомлении с Apigee, включенное в ZIP-файл документа, и вернуть его в Apigee, отправив его по электронной почте на адресorders@apigee.com .

Пограничная платформа

Рестайлинг интерфейса управления (Cloud 15.09.30)

Несколько страниц пользовательского интерфейса управления получили обновленный внешний вид. (МГМТ-2627)

API-сервисы

Переработанный мастер API-прокси (Cloud 16.01.20)

Мастер API-прокси был переработан. Когда вы нажимаете «+ Прокси API» на странице «Прокси API» в пользовательском интерфейсе управления, новый мастер проведет вас через процесс создания прокси API. Доступны все те же настройки, что и в предыдущем мастере прокси-сервера API. (МГМТ-1376)

Создание прокси-серверов API с документами OpenAPI (Swagger) (Cloud 16.01.20)

В рамках новой разработки мастера прокси-сервера API теперь вы можете создать прокси-сервер API из документа OpenAPI (Swagger). На первой странице мастера прокси-сервера API нажмите «Использовать OpenAPI» при выборе «Обратный прокси» , «Приложение Node.js» или «Нет цели» . В появившемся поле введите URL-адрес вашего документа OpenAPI. Дополнительные сведения см. в разделе Создание простого прокси-сервера API . (МГМТ-1376)

Поддержка WSDL 1.2 для прокси-серверов SOAP (Облако 16.01.20)

Apigee Edge поддерживает WSDL 1.2 при создании прокси-серверов API для вызова сервисов SOAP. (МГМТ-2835)

Переменные SSLInfo в конфигурациях TargetEndpoint (Cloud 16.01.20)

В прокси-сервере API TargetEndpoint вы можете динамически устанавливать сведения SSL/TLS для поддержки гибких требований времени выполнения. В следующем примере настройки SSLInfo в конфигурации TargetEndpoint значения могут быть предоставлены во время выполнения с помощью Java Callout, политики JavaScript или политики назначения сообщения. Используйте любые переменные сообщения, содержащие значения, которые вы хотите установить.

<TargetEndpoint>
...
  <SSLInfo>
    <Enabled>{myvars.ssl.enabled}</Enabled>
    <ClientAuthEnabled>{myvars.ssl.client.auth.enabled}</ClientAuthEnabled>
    <KeyStore>{myvars.ssl.keystore}</KeyStore>
    <KeyAlias>{myvars.ssl.keyAlias}</KeyAlias>
    <TrustStore>{myvars.ssl.trustStore}</TrustStore>
  </SSLInfo>
...
</TargetEndpoint>

Эта функция описана в следующих документах:

• Справочник по настройке прокси API
• https://community.apigee.com/articles/21424/dynamic-sslinfo-for-targetendpoint-using-variable.html

(АПИРТ-1475)

Поддержка алгоритма RSA_SHA256 для политик утверждения SAML (Cloud 16.01.20)

Политики утверждения SAML теперь поддерживают алгоритм RSA_SHA256 в дополнение к RSA_SHA1. (АПИРТ-1779)

Проверка загрузки сертификатов (Облако 16.01.20)

Чтобы предотвратить загрузку просроченных или недействительных сертификатов в хранилища ключей и доверенные хранилища, API управления проверяет сертификаты при загрузке. Сертификаты проверяются, чтобы гарантировать, что размер файла не превышает 50 КБ и формат PEM или DER. Также подтверждается срок действия сертификата. Чтобы переопределить проверку истечения срока действия по умолчанию (чтобы не проверять истечение срока действия сертификата при загрузке), используйте следующий параметр запроса: ?ignoreExpiryValidation=true

Дополнительные сведения см. в разделах «Загрузка файла JAR в хранилище ключей» и «Загрузка сертификата в хранилище доверенных сертификатов» . (SECENG-516) и (APIRT-2213)

Автоматический опрос на странице журналов Node.js (облако 16.01.20)

При просмотре журналов Node.js из редактора прокси-сервера страница журналов Node.js автоматически периодически обновляется, чтобы отображать новые доступные журналы. Нажмите «Остановить автоматическое обновление», чтобы отключить автоматическое обновление. (МГМТ-1692)

HTTP-заголовок X-Forwarded-For (Cloud 15.09.30)

Для повышения безопасности Edge по умолчанию удаляет заголовок HTTP-запроса X-Forwarded-For , который может содержать один или несколько IP-адресов. Новое поведение по умолчанию означает, что IP-адрес клиента, полученный Edge, будет IP-адресом, который он получил в результате последнего внешнего TCP-квитирования, а не адресом, который потенциально может быть подделан для обхода политики контроля доступа .

Чтобы изменить это поведение по умолчанию и разрешить адресам X-Forwarded-For достигать ваших прокси-серверов API, вы должны установить свойство feature.enableMultipleXForwardCheckForACL=true в своей организации.

Доступ JavaScript к свойствам политики (Облако 15.07.08)

При использовании JavaScript в потоках прокси API вы можете получить доступ к свойствам, определенным в политике JavaScript. Это особенно полезно, если вы хотите использовать в своем коде JavaScript хорошо известные переменные. Например, предположим, что ваша политика JavaScript содержит следующее определение свойства:

<Properties>
    <Property name='source'>response.content</Property>
</Properties>

В вашем JavaScript вы можете получить доступ к ответу на сообщение со ссылкой на свойство source, например:
var source = properties.get('source'); // returns: response.content
или
var source = properties.source
или
var source = properties['source']

Дополнительную информацию см. в разделе Политика JavaScript . (АПИРТ-1460)

Аудит на уровне организации (Облако 15.07.08)

Администраторы организации могут проверять историю действий, предпринятых на уровне организации. В пользовательском интерфейсе управления выберите «Администратор» > «История организации». Дополнительную информацию см. в разделе Аудит: API, продукт и история организации . (МГМТ-2232)

Самоотстранение администратора организации от роли (Облако 15.07.08)

Администраторы организации могут отказаться от роли администратора организации в пользовательском интерфейсе управления, выбрав «Администратор» > «Пользователи организации» и нажав «Удалить» рядом со своим именем. (МГМТ-934)

Индикатор выполнения импорта пакета прокси-сервера API (Cloud 15.07.08)

При загрузке большого пакета прокси-сервера API в пользовательском интерфейсе управления отображается «рабочая» анимация, указывающая, что импорт все еще происходит, что не позволяет вам взаимодействовать с пользовательским интерфейсом управления до завершения импорта. (МГМТ-1285)

Поведение и настройка кэша (Облако 15.07.22)

Для лучшего управления и использования кэша в памяти параметры «Максимальное количество элементов в памяти» для ресурсов кэша среды устарели с версии Edge Cloud 15.06.10. В версии Edge Cloud 15.07.22 этот параметр был удален из пользовательского интерфейса создания кэша в части конфигурации среды пользовательского интерфейса управления Apigee Edge.

Общее количество элементов, присутствующих во всех ресурсах кэша (включая кэш по умолчанию), зависит от общего объема памяти, выделенной для кэша. По умолчанию общий объем памяти, выделенный для кэширования в памяти данного процессора сообщений, составляет 40 % от общего объема доступной памяти. Элементы будут удалены из кэша в памяти только в том случае, если кэш-памяти недостаточно или срок действия элементов истек. (МГМТ-2413, АПИРТ-1140)

Конфигурация целевого сервера в пользовательском интерфейсе управления (Cloud 15.07.22)

Страница API > Конфигурация среды в пользовательском интерфейсе управления теперь позволяет добавлять, редактировать и удалять целевые серверы.

Кроме того, страница была переработана, теперь кэши можно создавать, добавлять и удалять прямо в процессе, а не переходить на новую страницу. Некоторые свойства кэша, включая «Максимальное количество элементов в памяти», больше не доступны в пользовательском интерфейсе, поскольку установка этих свойств больше не влияет на поведение кэша во время выполнения. (МГМТ-280)

SSL с записью сообщений в системный журнал (Облако 15.07.22)

Политика ведения журнала сообщений поддерживает отправку системного журнала сторонним поставщикам управления журналами через SSL/TLS. Используйте следующее в конфигурации политики в качестве прямого дочернего элемента родительского элемента:

<SSLInfo>
    <Enabled>true</Enabled>
</SSLInfo>

Дополнительные сведения см. в разделе Политика ведения журнала сообщений . (АПИРТ-942)

Пользовательский интерфейс управления (Облако 15.07.22)

Инженеры Apigee внесли различные мелкие исправления ошибок и улучшили удобство использования пользовательского интерфейса управления.

cURL в трассировке (облако 15.09.02)

При отслеживании вызова прокси-сервера API, который отправляет запрос на целевой сервер, вы можете просмотреть запрос к целевому серверу как команду cURL. Выберите этап «Запрос отправлен на целевой сервер» на диаграмме «Карта транзакций», затем нажмите кнопку «Показать завиток» в столбце «Запрос отправлен на целевой сервер» на панели «Сведения о этапе». (МГМТ-2589)

Специальные символы маскировки данных (Облако 15.09.02)

При использовании маскировки данных для маскировки конфиденциальных данных в полезных нагрузках JSON теперь можно маскировать специальные символы, такие как $, * и {. (АПИРТ-1727)

Карты ключевых значений в интерфейсе управления (Cloud 15.09.30)

Теперь вы можете создавать карты ключевых значений (KVM) на уровне среды и управлять ими в пользовательском интерфейсе управления Edge. KVM в области среды содержат пары ключ/значение, которые доступны любому прокси-серверу API в среде, например тестовой или рабочей. В меню пользовательского интерфейса управления перейдите в раздел API > Конфигурация среды > выберите нужную среду > вкладка «Карты значений ключей» . Дополнительные сведения см. в разделе Создание и редактирование карт значений ключей среды . (МГМТ-1393)

Срок действия политики PopulateCache по умолчанию в пользовательском интерфейсе управления (Cloud 15.09.30)

При добавлении политики PopulateCache с помощью редактора прокси API элемент <TimeoutInSec> для срока действия кэша предварительно заполняется значением 3600 секунд (1 час). Предыдущее значение по умолчанию составляло 300 секунд (5 минут). (МГМТ-2622)

Услуги для разработчиков

Производительность страницы продукта API, приложения для разработчиков не указаны (Cloud 16.01.20)

При просмотре продукта API в пользовательском интерфейсе управления отображаются приложения разработчика, связанные с этим продуктом. Чтобы повысить производительность пользовательского интерфейса, список приложений разработчика не отображается при редактировании продукта API. (МГМТ-2869)

Ключевой столбец на странице приложений разработчика (облако 15.08.05)

В организациях с большим количеством приложений для разработчиков (тысячи) отображение столбца «Ключ» на странице «Приложения для разработчиков» (показывает количество ключей на одно приложение) может снизить производительность отображения. Чтобы улучшить производительность отображения в этой ситуации, обратитесь в службу поддержки Apigee и установите следующее свойство уровня организации: features.appsNoCredentialsEnabled = true . Это свойство удаляет столбец «Ключ». Однако обратите внимание, что удаление столбца «Ключ» также удаляет возможность поиска по потребительскому ключу и секрету. (МГМТ-2486)

Индикатор прогресса на странице сведений о разработчике (Cloud 15.09.30)

Когда страница «Сведения о разработчике» загружается в пользовательском интерфейсе управления, в разделе «Приложения» на странице отображается индикатор выполнения, если приложения все еще загружаются. Это улучшает предыдущее поведение, когда раздел «Приложения» отображался пустым при загрузке приложений. (МГМТ-2667)

Монетизация

Изменение названий пакетов API (Cloud 16.01.20)

Вы можете обновить имя пакета API в любой момент жизненного цикла монетизации, даже если пакет API содержит опубликованный тарифный план. (ДЕВРТ-2177)

В пользовательских атрибутах разрешены десятичные дроби (Cloud 16.01.20).

При использовании плана «Тариф с настраиваемым атрибутом» настраиваемый атрибут в заголовке сообщения, который используется в качестве множителя для транзакции, теперь может иметь десятичное значение до четырех знаков после запятой. Дополнительные сведения об этом типе плана см. в разделе Указание сведений о пользовательском атрибуте прейскуранта (DEVRT-2191).

Название и идентификатор тарифного плана в сводных отчетах (Облако 15.09.02)

При создании сводного отчета о доходах с помощью API управления вы можете добавить в отчет столбцы «Название тарифного плана» и «Идентификатор плана». Для этого добавьте «RATEPLAN» в качестве атрибута groupBy в вызове API, как описано в разделе «Создание отчетов» . (Обратите внимание, что эта функция пока недоступна в пользовательском интерфейсе отчета о монетизации.) В подробных отчетах столбцы имени и идентификатора существующего тарифного плана теперь расположены в начале отчета вместе с другими столбцами группировки. (ДЕВРТ-1740)

Аналитические услуги

Функция sum( ) для показателей времени ответа (Cloud 16.01.20)

В пользовательских отчетах аналитики и вызовах API агрегатная функция «sum» теперь доступна для целевого времени ответа, общего времени ответа и end_point_response_time. Например, в API /stats (http://docs.apigee.com/management/apis/get/organizations/%7Borg_name%7D/environments/%7Benv_name%7D/stats/%7Bdimension_name%7D-0) вы теперь можно использовать следующий параметр запроса «выбрать»: ?select=sum(total_response_time). (АКСАПП-2006)

Отчет об анализе задержки: сортировка имен прокси-серверов API (Cloud 16.01.20)

В пользовательском интерфейсе отчета «Анализ задержки» (только для корпоративных планов Apigee Edge) прокси-серверы API перечислены в алфавитном порядке в раскрывающемся списке «Прокси». (МГМТ-2858)

Приложения разработчика на информационной панели отображаются по отображаемому имени (Cloud 16.01.20)

На информационной панели пользовательского интерфейса управления на гистограмме «Приложения разработчика» перечислены приложения разработчика по отображаемому имени, а не по внутреннему имени. (МГМТ-2853)

Новый виджет даты/времени в пользовательских отчетах (Cloud 16.01.20)

Был улучшен виджет выбора даты и времени на странице настраиваемых отчетов в пользовательском интерфейсе управления. (МГМТ-2881)

Детализация города на GeoMap (Облако 15.07.22)

Аналитическая GeoMap включает детализацию «Город» для США и Канады. Если щелкнуть штат или провинцию на карте, отобразится список городов, из которых исходили звонки. (МГМТ-2282)

| (труба) и = символы в пользовательских отчетах аналитики (Cloud 15.09.02)

Определения пользовательских отчетов Analytics поддерживают использование | (труба) и = символы. До этого для этих символов необходимо было использовать кодировку %7C и %3D. (МГМТ-2504)

Размер суффикса пути прокси (Cloud 15.09.30)

Новое измерение «Суффикс пути прокси» (proxy_pathsuffix) доступно в пользовательских отчетах аналитики и вызовах API. Суффикс пути прокси — это часть URL-адреса прокси-сервера API, которая идет после базового пути, например пути, созданного для условных потоков. (АКСАПП-1902)

В отчетах показаны идентификаторы разработчиков, а не имена (Cloud 15.09.30).

При выполнении вызовов API аналитики Edge с помощью API /stats, который возвращает разработчиков, отображаемое имя разработчика возвращается вместе с идентификатором разработчика. Раньше возвращался только идентификатор разработчика. (AXAPP-1759)

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

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

Частное облако 4.16.01

В следующей таблице перечислены ошибки, исправленные после выпуска Edge for Private Cloud 4.16.01. Чтобы получить эти исправления, следуйте инструкциям по обновлению установки 4.16.01 до последних RPM и файлов поддержки, как описано в разделе Обновление Apigee Edge 4.16.01.x до последней версии 4.16.01 .

Облако 16.01.20

Облако 15.07.08

Облако 15.07.22

Облако 15.08.05

Облако 15.09.02

Облако 15.09.30

Private Cloud 4.15.07.03

Private Cloud 4.15.07.01

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

Этот релиз имеет следующие известные проблемы.

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