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, доступном на 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

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

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

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

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

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

Вы просматриваете документацию 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 Router на 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, доступном на ftp-сайте Apigee: ftp://ftp.apigee.com/ .

Альфа -выпуск инструмента мониторинга и панели инструментов

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

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

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

Edge Platform

Управление пользовательским интерфейсом (облако 15.09.30)

Несколько страниц в пользовательском интерфейсе управления получили обновление. (MGMT-2627)

API Services

Перепроектированный прокси -мастер 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 (облако 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 (Cloud 16.01.20)

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

X-forwarded-для HTTP Header (Cloud 15.09.30)

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

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

JavaScript доступ к свойствам политики (Cloud 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)

Аудиты на уровне организации (Cloud 15.07.08)

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

Администратор организации Самоуничтожение от роли (Cloud 15.07.08)

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

Индикатор прогресса Proxy Proxy Proxy Proxy (облако 15.07.08)

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

Поведение и конфигурацию кэша (облако 15.07.22)

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

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

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

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

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

SSL с журналом сообщений в Syslog (Cloud 15.07.22)

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

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

Для получения дополнительной информации см. Политику регистрации сообщений . (Apirt-942)

Управление пользовательским интерфейсом (Cloud 15.07.22)

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

скручивание в трассировке (облако 15.09.02)

При проведении прокси -вызова API, который делает запрос на целевой сервер, вы можете просматривать запрос на целевой сервер как команду Curl. Выберите стадию «Запрос, отправленный на целевой сервер» на диаграмме карты транзакций, затем нажмите кнопку «Показать Curl» в столбце «Запрос, отправленный на целевой сервер» на панели сведений о фазе. (MGMT-2589)

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

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

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

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

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

При добавлении политики PopuLateCache в API-прокси-редактор, элемент <timoTinsec> для истечения срока действия кэша предварительно заполняется значением 3600 секунд (1 час). Предыдущий дефолт составил 300 секунд (5 минут). (MGMT-2622)

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

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

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

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

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

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

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

Монетизация

Редактировать имена пакетов API (Cloud 16.01.20)

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

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

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

Название плана и идентификатор тарифов в отчетах об резюме (облако 15.09.02)

При получении отчета о сводном доходах с помощью API управления вы можете добавить в отчет в отчете. Чтобы сделать это, добавьте «Proceplan» в качестве атрибута Groupby в вызове API, как описано в Create Reports . (Обратите внимание, что эта функция еще не доступна в пользовательском интерфейсе отчета о монетизации.) В подробном отчетах существующие имя плана и идентификационные столбцы теперь расположены рядом с передней частью отчета вместе с другими столбцами группировки. (DEVRT-1740)

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

Функция sum () на метриках времени отклика (облако 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» Параметр запроса:? SELECT = SUM (total_response_time). (АКСАПП-2006)

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

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

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

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

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

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

Городская буровая оболочка на Geomap (Cloud 15.07.22)

Analytics Geomap включает в себя «городскую» тренировку для Соединенных Штатов и Канады. Когда вы нажимаете на штат или провинцию на карте, отображается список городов, в которых родились звонки. (MGMT-2282)

| (Pipe) и = символы в Analytics Custom Reports (Cloud 15.09.02)

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

Прокси -путь суффикс измерение (облако 15.09.30)

Новый суффикс Proxy Path (Proxy_Pathsuffix) доступен в Analytics Custom Reports и вызовах API. Суффикс Proxy Path - это часть URL -адреса прокси API, который поступает после базового пути, такой как путь, созданный для условных потоков. (AXAPP-1902)

Отчеты показывают, что идентификаторы разработчика не отображают имена (Cloud 15.09.30)

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

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

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

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

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

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

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

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

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

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

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

В четверг, 24 марта 2016 года, мы выпустили новую версию Apigee Edge для 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
• Частное облако: 4.15.07.01 , 4.15.07.03

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

Устаревания

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

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

Аналитика: Custom Reports View Dashboard несколько отчетов (Cloud 15.09.30)

Конкретная функция Desports Desports , которая предоставляет представление до четырех пользовательских отчетов, устанавливается и будет удалена в будущем. (MGMT-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

Где установка-DIR может быть расположен в любом месте, с дефолтом /Opt . Например:

/opt/apigee4

Для версии 4.16.01, вы должны установить Edge в следующий каталог:

/opt/apigee

Обратите также, что каталог Apigee4 был изменен на Apigee .

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

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

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

См. Руководство по установке Edge, доступное на сайте Apigee FTP: ftp://ftp.apigee.com/ , для получения информации о том, как добавить псевдоним хоста в существующий виртуальный хост для большего.

Код с конфигурацией

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

/opt/apigee/customer/application

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

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

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

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

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

Сценарии конфигурации края были заменены

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

• Команды, которые вы запускаете через утилиты Apige, такие как Apigee-Service, Apigee-All, Apigee-Setup, Apiee-Provision или Apigee-Migrate Utilities.
  Например, сценарии All-START.SH и All-STOP.SH были заменены следующими командами:
  >/opt/apigee/apigee-service/bin/apigee-all Start
  >/opt/apigee/apigee-service/bin/apigee-all
• Команды, которые вы запускаете на краевых компонентах напрямую. Например, в предыдущих выпусках вы использовали сценарий chpasswd-openldap.sh, используемый для изменения пароля OpenLDAP. Этот сценарий был заменен следующей командой, которую вы запускаете на компоненте Apigee-Openldap:
  >/opt/apigee/apigee-service/bin/apigee-service apigee-openldap rade-ldap-password -o Oldpword -n Newpword

См. Руководство по операциям Apigee Edge, доступное на сайте Apigee FTP: ftp://ftp.apigee.com/ , для получения дополнительной информации о том, как вы теперь выполняете конфигурацию через команды.

Новый краевой маршрутизатор

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

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

Подробнее см. Приложение A: о маршрутизаторе Nginx, в руководстве по установке Edge, доступно на сайте Apigee FTP: FTP://ftp.apigee.com/ ,

Baas Load Balancer удален

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

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

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

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

Оргтул удален

Orgtool может запросить Edge Installation, чтобы получить информацию об организации. Этот инструмент теперь удален. Теперь вы используете звонки Edge UI или API, чтобы получить информацию об организации.

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

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

Альфа -выпуск инструмента мониторинга и панели инструментов

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

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

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

Edge Platform

Управление пользовательским интерфейсом (облако 15.09.30)

Несколько страниц в пользовательском интерфейсе управления получили обновление. (MGMT-2627)

API Services

Перепроектированный прокси -мастер 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 (облако 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 (Cloud 16.01.20)

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

X-forwarded-для HTTP Header (Cloud 15.09.30)

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

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

JavaScript доступ к свойствам политики (Cloud 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)

Аудиты на уровне организации (Cloud 15.07.08)

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

Администратор организации Самоуничтожение от роли (Cloud 15.07.08)

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

Индикатор прогресса Proxy Proxy Proxy Proxy (облако 15.07.08)

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

Поведение и конфигурацию кэша (облако 15.07.22)

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

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

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

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

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

SSL с журналом сообщений в Syslog (Cloud 15.07.22)

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

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

Для получения дополнительной информации см. Политику регистрации сообщений . (Apirt-942)

Управление пользовательским интерфейсом (Cloud 15.07.22)

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

скручивание в трассировке (облако 15.09.02)

При проведении прокси -вызова API, который делает запрос на целевой сервер, вы можете просматривать запрос на целевой сервер как команду Curl. Выберите стадию «Запрос, отправленный на целевой сервер» на диаграмме карты транзакций, затем нажмите кнопку «Показать Curl» в столбце «Запрос, отправленный на целевой сервер» на панели сведений о фазе. (MGMT-2589)

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

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

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

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

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

При добавлении политики PopuLateCache в API-прокси-редактор, элемент <timoTinsec> для истечения срока действия кэша предварительно заполняется значением 3600 секунд (1 час). Предыдущий дефолт составил 300 секунд (5 минут). (MGMT-2622)

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

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

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

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

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

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

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

Монетизация

Редактировать имена пакетов API (Cloud 16.01.20)

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

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

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

Название плана и идентификатор тарифов в отчетах об резюме (облако 15.09.02)

При получении отчета о сводном доходах с помощью API управления вы можете добавить в отчет в отчете. Чтобы сделать это, добавьте «Proceplan» в качестве атрибута Groupby в вызове API, как описано в Create Reports . (Обратите внимание, что эта функция еще не доступна в пользовательском интерфейсе отчета о монетизации.) В подробном отчетах существующие имя плана и идентификационные столбцы теперь расположены рядом с передней частью отчета вместе с другими столбцами группировки. (DEVRT-1740)

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

Функция sum () на метриках времени отклика (облако 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» Параметр запроса:? SELECT = SUM (total_response_time). (АКСАПП-2006)

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

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

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

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

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

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

Городская буровая оболочка на Geomap (Cloud 15.07.22)

Analytics Geomap включает в себя «городскую» тренировку для Соединенных Штатов и Канады. Когда вы нажимаете на штат или провинцию на карте, отображается список городов, в которых родились звонки. (MGMT-2282)

| (Pipe) и = символы в Analytics Custom Reports (Cloud 15.09.02)

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

Прокси -путь суффикс измерение (облако 15.09.30)

A new Proxy Path Suffix (proxy_pathsuffix) dimension is available in analytics Custom Reports and API calls. Proxy path suffix is the part of an API proxy URL that comes after the base path, such as the path created for conditional flows. (AXAPP-1902)

Reports show developer IDs not display names (Cloud 15.09.30)

When making Edge analytics API calls with the /stats API that returns developers, the developer display name is returned along with developer ID. Previously, only developer ID was returned. (AXAPP-1759)

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

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

Private Cloud 4.16.01

The following table lists the bugs fixed since the Edge for Private Cloud 4.16.01 release. To obtain these fixes, follow the instructions to update your 4.16.01 installation to the latest RPMs and support files as described in Update Apigee Edge 4.16.01.x to latest 4.16.01 release .

Cloud 16.01.20

Cloud 15.07.08

Cloud 15.07.22

Cloud 15.08.05

Cloud 15.09.02

Cloud 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