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

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

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

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

Прекращение поддержки

Private Cloud 4.15.07.03

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

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

/<install-dir>/apigee4

где install-dir может быть любым каталогом, по умолчанию /opt. Пример:

/opt/apigee4

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

/opt/apigee

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

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

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

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

Информацию о том, как добавить псевдоним хоста к существующему виртуальному хосту, можно найти в руководстве по установке Edge , доступном на сайте Apigee FTP: 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 для частного облака представлена новая архитектура маршрутизатора на основе Nginx Router. Маршрутизатор Nginx заменяет маршрутизатор Netty, который использовался в версиях Edge до 4.16.01.

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

Дополнительную информацию можно найти в приложении А "О маршрутизаторе 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 теперь содержит раздел "Масштабирование 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.

Платформа Edge

Изменение стиля интерфейса управления (облачная версия 15.09.30)

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

Сервисы API

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

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

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

В рамках нового дизайна мастера создания прокси-сервера API теперь можно создавать прокси-сервер API на основе документа OpenAPI (Swagger). На первой странице мастера прокси-сервера API нажмите Use OpenAPI (Использовать OpenAPI), когда выбираете Reverse Proxy (Обратный прокси), Node.js App (Приложение Node.js) или No Target (Без цели). В появившемся поле введите 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)

В TargetEndpoint прокси-сервера API можно динамически задавать параметры 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
• Динамическая информация SSL для TargetEndpoint с использованием ссылки на переменную

(APIRT-1475)

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

Теперь правила утверждений SAML поддерживают алгоритм RSA_SHA256 в дополнение к RSA_SHA1. (APIRT-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 автоматически обновляется с определенной периодичностью, чтобы показывать новые доступные журналы. Нажмите "Остановить автоматическое обновление". (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)

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

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

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

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

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

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

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

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

Настройка целевого сервера в интерфейсе управления (облако 15.07.22)

На странице APIs > Environment Configuration (API > Конфигурация среды) в интерфейсе управления теперь можно добавлять, изменять и удалять целевые серверы.

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

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

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

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

Подробнее о правилах ведения журналов сообщений… (APIRT-942)

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

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

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

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

Специальные символы для деидентифицирования данных (Cloud 15.09.02)

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

Карты пар "ключ-значение" в интерфейсе управления (облако 15.09.30)

Теперь в интерфейсе управления 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)

При создании сводного отчета о доходе с помощью Management API вы можете добавить в него столбцы "Название тарифного плана" и "Идентификатор тарифного плана". Для этого добавьте "RATEPLAN" в качестве атрибута groupBy в вызов API, как описано в разделе Создание отчетов. (Эта функция пока недоступна в интерфейсе отчета о монетизации.) В подробных отчетах столбцы с названием и идентификатором тарифного плана теперь находятся в начале отчета вместе с другими столбцами группировки. (DEVRT-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: ?select=sum(total_response_time). (AXAPP-2006)

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

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

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

На панели управления диаграмма "Приложения разработчика" содержит список приложений разработчика с указанием отображаемых, а не внутренних названий. (MGMT-2853)

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

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

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

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

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

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

Параметр "Суффикс пути прокси-сервера" (Cloud 15.09.30)

В специальных отчетах Аналитики и вызовах API теперь доступен новый параметр "Суффикс пути прокси-сервера" (proxy_pathsuffix). Суффикс пути прокси-сервера – это часть URL прокси-сервера API, которая следует за базовым путем, например путь, созданный для условных потоков. (AXAPP-1902)

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

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

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

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

Private Cloud 4.16.01

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

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