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

install-dir может располагаться где угодно, но по умолчанию — /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 для настройки компонентов 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 Operations Guide , доступном на 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 для частного облака реализована новая архитектура маршрутизатора на основе маршрутизатора 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-сервер автоматически возвращает значения A-записей в циклическом режиме.

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

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

Orgtool удален

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

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

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

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

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

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

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

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

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

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

API-сервисы

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

Мастер настройки прокси-сервера API был переработан. При нажатии кнопки «+ API Proxy» на странице «Прокси-серверы 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_SHA256 в дополнение к RSA_SHA1. (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. KVM в области среды содержат пары «ключ/значение», доступные любому прокси-серверу 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 управления вы можете добавить в отчёт столбцы «Название тарифного плана» и «Идентификатор тарифа». Для этого добавьте «RATEPLAN» в качестве атрибута groupBy в вызове 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)

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

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

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

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

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

В отчетах отображаются идентификаторы разработчиков, а не отображаемые имена (Cloud 15.09.30)

При вызовах API Edge Analytics с помощью 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