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

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

В четверг, 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
• Частное облако: 4.15.07.01 , 4.15.07.03

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

Амортизация

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

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

Аналитика: Пользовательские отчеты. Панель мониторинга для просмотра нескольких отчетов (Cloud 15.09.30)

Функция панели мониторинга пользовательских отчетов , позволяющая просматривать до четырех пользовательских отчетов, устаревает и будет удалена в будущей версии (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 устанавливался в базовый каталог:

/<install-dir>/apigee4

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

/opt/apigee4

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

/opt/apigee

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

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

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

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

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

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

В версии Edge 4.16.01 для настройки компонентов Edge больше не используются файлы .properties, расположенные в каталоге /<install-dir>/apigee4/conf . Начиная с версии 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 stop
• Команды, которые вы запускаете непосредственно в компонентах Edge. Например, в предыдущих версиях для изменения пароля OpenLDAP использовался скрипт chpasswd-openldap.sh. Этот скрипт был заменен следующей командой, которую вы запускаете в компоненте apigee-openldap:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-openldap change-ldap-password -o oldPword -n newPword

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

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

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

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

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

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

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

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

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

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

Orgtool удален

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

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

В следующей таблице показано, как вы выполняли задачи в версии 4.15.07.03 и как вы выполняете их сейчас в версии 4.16.01. Более подробную информацию см. в Руководстве по операциям на периферии сети, доступном на 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)

В интерфейсе управления обновлен внешний вид нескольких страниц. (MGMT-2627)

API-сервисы

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

Мастер создания API-прокси был переработан. При нажатии кнопки "+ API-прокси" на странице "API-прокси" в пользовательском интерфейсе управления новый мастер проведет вас через процесс создания API-прокси. Все те же настройки, что и в предыдущем мастере создания API-прокси, доступны. (MGMT-1376)

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

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

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

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

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

В API-прокси TargetEndpoint можно динамически задавать параметры SSL/TLS для поддержки гибких требований во время выполнения. В следующем примере того, как параметр SSLInfo устанавливается в конфигурации TargetEndpoint, значения могут быть предоставлены во время выполнения с помощью вызова Java, политики 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-прокси
• Динамическая информация SSLInfo для TargetEndpoint с использованием ссылки на переменную.

(APIRT-1475)

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

В политиках утверждений SAML теперь, помимо RSA_SHA1, поддерживается алгоритм RSA_SHA256. (APIRT-1779)

Проверка загружаемых сертификатов (Cloud 16.01.20)

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

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

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

При просмотре логов Node.js из редактора прокси страница логов Node.js автоматически периодически обновляется, отображая список доступных новых логов. Нажмите «Остановить автоматическое обновление», чтобы отключить автоматическое обновление. (MGMT-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 (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 . (APIRT-1460)

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

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

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

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

Индикатор хода импорта пакета API-прокси (Cloud 15.07.08)

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

Поведение и конфигурация кэша (Cloud 15.07.22)

Для более эффективного управления и использования кэша в оперативной памяти параметр «Максимальное количество элементов в памяти» для ресурсов кэша среды был признан устаревшим начиная с версии Edge Cloud 15.06.10. В версии Edge Cloud 15.07.22 этот параметр был удален из пользовательского интерфейса создания кэша в разделе «Конфигурация среды» пользовательского интерфейса управления 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 внесли ряд мелких исправлений ошибок и улучшений в пользовательский интерфейс управления.

cURL в Trace (Cloud 15.09.02)

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

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

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

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

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

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

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

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

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

При просмотре API-продукта в пользовательском интерфейсе управления отображается список приложений для разработчиков, связанных с этим продуктом. Для повышения производительности пользовательского интерфейса список приложений для разработчиков не отображается при редактировании API-продукта. (MGMT-2869)

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

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

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

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

Монетизация

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

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

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

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

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

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

Аналитические сервисы

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

В пользовательских отчетах и ​​вызовах API аналитики теперь доступна агрегатная функция "sum" для целевого времени ответа, общего времени ответа и времени ответа конечной точки. Например, в 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). (AXAPP-2006)

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

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

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

На панели управления пользовательского интерфейса в столбчатой ​​диаграмме «Приложения для разработчиков» приложения для разработчиков отображаются по отображаемому имени, а не по внутреннему имени. (MGMT-2853)

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

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

Детализация по городам на GeoMap (Cloud 15.07.22)

Аналитическая геокарта включает в себя детализированный список городов для США и Канады. При нажатии на штат или провинцию на карте отображается список городов, из которых были совершены звонки. (MGMT-2282)

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

В определениях пользовательских отчетов Analytics поддерживается использование символов | (вертикальная черта) и =. Ранее для этих символов требовалось использовать кодировку %7C и %3D. (MGMT-2504)

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

В пользовательских отчетах и ​​вызовах API в аналитике появилась новая функция — суффикс пути прокси (proxy_pathsuffix). Суффикс пути прокси — это часть URL-адреса прокси API, которая следует за базовым путем, например, за путем, созданным для условных потоков. (AXAPP-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