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

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

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

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

Обзор версии приложения

В этой версии есть несколько важных функций, которые помогут вам лучше контролировать и защищать свои API, в том числе:

• Общие потоки поддерживают развертывание без простоев.
• Теперь можно удалять данные о монетизации для организации.
• Дополнительные новые функции описаны ниже.

Что касается устаревших функций, то хранилища больше не поддерживаются.

Ниже описаны все новые функции, обновления и исправления ошибок, включенные в этот выпуск.

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

В этом выпуске были упразднены или удалены следующие функции: Подробнее о правилах прекращения поддержки Microsoft Edge…

Снято с учета: добавление путей на вкладке "Эффективность" прокси-сервера API

До этого выпуска вы могли перейти к прокси-серверу API в интерфейсе управления, открыть вкладку "Эффективность" и создать разные пути для сравнения на основе диаграмм на вкладке "Эффективность" прокси-сервера и на панели "Бизнес-транзакции". Эта функция больше не поддерживается и недоступна в интерфейсе. В качестве альтернативы можно использовать статью сообщества Apigee Alternative to Business Transactions API (Альтернатива API бизнес-транзакций). (EDGEUI-902)

Удалено: URL buildInfo для портала сервисов для разработчиков

В предыдущих версиях портала, чтобы определить его версию, нужно было открыть в браузере следующий URL:

http://yourportal.com/buildInfo

В версии 4.17.05 эта ссылка была удалена. Чтобы узнать версию, откройте в Drupal пункт меню Отчеты > Отчет о статусе. Версия портала указана в таблице в строке Профиль установки.

Прекращение поддержки защищенного хранилища Apigee (сейфов)

Безопасное хранилище Apigee, также известное как хранилище секретов, будет удалено через год после даты объявления об этом, указанной на странице устаревших функций. Хранилища, в которых зашифрованно хранятся пары "ключ-значение", создаются с помощью API управления, а доступ к ним во время выполнения осуществляется с помощью функций в модуле Node.js apigee-access.

Вместо защищенного хранилища используйте зашифрованные карты "ключ-значение" (KVM), как описано в разделе Работа с картами "ключ-значение". Зашифрованные KVM так же безопасны, как и хранилища, но предоставляют больше возможностей для создания и извлечения данных. (MGMT-3848)

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

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

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

Добавлен новый обязательный параметр конфигурации SMTP для установки

Теперь в файле конфигурации установки Edge необходимо использовать параметр SMTPMAILFROM. Этот параметр указывает адрес электронной почты, который используется, когда Edge отправляет автоматические письма, например когда пользователь запрашивает сброс пароля. Подробнее о том, как установить компоненты Edge на узле…

(EDGEUI-1020)

Теперь можно задать время ожидания, используемое интерфейсом Edge для вызовов управления Edge API.

Теперь вы можете указать время ожидания API, которое используется интерфейсом Edge для управления тем, как долго интерфейс ожидает возврата вызова API управления. Тайм-аут определяется следующими свойствами:

• conf_apigee_apigee.feature.apitimeout задает время в секундах, в течение которого интерфейс ожидает возврата вызова к серверной части, независимо от действий пользователя. Если вызов не будет завершен в течение этого времени, в интерфейсе появится сообщение об ошибке из-за превышения времени ожидания. Значение по умолчанию – 180 секунд (3 минуты).
• conf_apigee_play.ws.timeout.idle определяет, как долго интерфейс будет ждать активности на сервере (в миллисекундах). Его можно установить равным значению параметра conf_apigee_apigee_apitimeout или меньше него. Увеличение этого значения не влияет на работу функции. Значение по умолчанию – 180 000 миллисекунд (3 минуты).
• conf_apigee_play.ws.timeout.connection определяет, сколько времени интерфейс ожидает установления подключения. Его можно установить равным значению параметра conf_apigee_apigee_apitimeout или меньше него. Увеличение этого значения не влияет на работу функции. Значение по умолчанию – 120 000 миллисекунд (2 минуты).

Подробнее о том, как задать время ожидания, используемое интерфейсом Edge для вызовов API управления Edge…

(EDGEUI-816)

В маршрутизаторы добавлен тайм-аут повторной попытки обработчика сообщений

Добавлен тайм-аут, чтобы маршрутизаторы прекращали повторные попытки отправить запрос обработчикам сообщений и возвращали сообщение об ошибке.

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

(APIRT-2912)

Добавлена процедура изменения системного администратора по умолчанию

Добавлена документация о том, как изменить системного администратора по умолчанию.

Подробнее об управлении пользователями, ролями и разрешениями…

(DOS-4895)

Добавлена документация о разделении задач установки Edge между пользователем с правами root и пользователем без таких прав

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

Подробнее об установке Edge…

(DOS-4573)

Добавлено свойство для установки имени хоста для ссылок в сгенерированных письмах

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

https://domain/login

Домен определяется Edge автоматически и обычно подходит для организации. Однако если интерфейс Edge находится за балансировщиком нагрузки, автоматически сгенерированное доменное имя может быть неправильным. В этом случае вы можете использовать свойство conf_apigee_apigee.emails.hosturl, чтобы явно задать доменное имя в сгенерированном URL.

Подробнее о том, как задать имя хоста для ссылок в сгенерированных письмах…

(EDGEUI-1044)

Как задать базовый URL, который будет отображаться в интерфейсе Edge для прокси-сервера API

В интерфейсе Edge отображается URL прокси-сервера API на основе настроек виртуального хоста, соответствующего месту развертывания прокси-сервера. На этом экране может быть указан номер порта маршрутизатора виртуального хоста.

В большинстве случаев URL, отображаемый в интерфейсе Edge, является правильным URL для отправки внешних запросов к прокси-серверу. Однако в некоторых конфигурациях отображаемый URL неправильный. Например, URL, который показывается пользователю, может не соответствовать фактическому URL, используемому для внешних запросов к прокси-серверу, из-за следующих настроек:

• Завершение SSL-подключения происходит на балансировщике нагрузки.
• Сопоставление портов происходит между балансировщиком нагрузки и маршрутизаторами Apigee.
• Балансировщик нагрузки, настроенный с перезаписью пути

В Edge для частного облака версии 4.17.05 и более поздних поддерживается атрибут виртуального хоста <BaseUrl>, который позволяет переопределить URL, отображаемый в интерфейсе Edge. Ниже приведен пример объекта виртуального хоста с новым атрибутом <BaseURL>. В этом примере значение http://myCo.com отображается в интерфейсе Edge следующим образом:

<VirtualHost name="myVHost">
   <HostAliases>
     <HostAlias>DNS_name_or_IP:9005</HostAlias>
   </HostAliases>
   <BaseUrl>http://myCo.com</BaseUrl>
   <Interfaces/>
   <Port>9005</Port>
</VirtualHost>

Если тег <BaseUrl> не задан (это значение по умолчанию), то URL по умолчанию, который отображается в интерфейсе Edge, будет выглядеть так: http://DNS_name_or_IP:9005/, а фактический псевдоним хоста будет http://myCo.com.

Вы также можете задать базовый URL при создании организации, используя свойство VHOST_BASEURL с утилитой apigee-provision.

Подробнее о том, как настроить доступ к API для частного облака с использованием TLS…

(EDGEUI-5008)

Добавлена документация о том, как включить ведение журнала отладки

Добавлена документация о том, как включить или отключить ведение журнала отладки для компонентов Edge.

Подробнее о том, как включить журнал отладки…

(APIRT-4018)

Новый установщик и синтаксис команд для утилиты apigee-analytics-collector

Все клиенты Edge для частного облака должны отправлять в Apigee статистику трафика прокси API с помощью бета-версии утилиты командной строки apigee-analytics-collector. Эта утилита отправляет отчет об объеме вызовов API в Apigee.

В этом выпуске Edge содержатся новые инструкции по установке и синтаксис команд для утилиты apigee-analytics-collector. В этом выпуске для установки утилиты apigee-analytics-collector вместо npm используется apigee-service, а для вызова утилиты apigee-analytics-collector вместо отдельной команды используется apigee-service.

Подробнее о загрузке данных о трафике API в Apigee (бета-версия)…

Новый каталог установки по умолчанию после обновления портала Developer Services Nginx/Postgres с новой установки 4.17.01

После обновления новой установки версии 4.17.01, в которой используются Nginx/Postgres, корневой каталог изменился с:

/opt/apigee/apigee-drupal

кому:

/opt/apigee/apigee-drupal/wwwroot

Сервисы API

Более строгая проверка входных данных для объектов

Во всех объектах организации Apigee Edge теперь действует более строгая проверка входных данных. Обычно это буквы (в любом регистре), цифры и символы подчеркивания.

Затронутые объекты:

• Организации
• Среды
• Прокси API
• Ревизии прокси-сервера API
• Названия правил в прокси-сервере API
• Идентификаторы конфигураций масок трассировки для отладки
• Названия ресурсов (вызов Java, XSL, все ресурсы)
• Хранилища ключей
• CRLstores
• Ссылки на ресурсы
• Целевые серверы

(MGMT-3840)

Развертывание общих потоков без простоев

Если вы хотите развернуть общие потоки и при этом свести к минимуму или полностью исключить отклонение входящего трафика, воспользуйтесь API управления развертыванием без простоев. Процесс почти идентичен развертыванию прокси API без простоев с помощью Management API. Единственное отличие – ресурс API управления.

Следующий вызов развертывает версию общего потока, указанную в URI, а затем отменяет развертывание предыдущей версии (это позволяет сделать параметр запроса override=true):

curl -X POST -H "Content-type:application/x-www-form-urlencoded" \
https://api.enterprise.apigee.com/v1/o/{org_name}/environments/{env-name}/sharedflows/{shared_flow_name}/revisions/{revision_number}/deployments?"override=true" \
-u email:password

(MGMT-3485)

Монетизация

Как удалить данные о монетизации для организации

Удалить данные о монетизации для организации может потребоваться в следующих случаях:

• Удалить организацию. В этом случае вам нужно удалить данные о монетизации, прежде чем удалять организацию.
• Удалить данные монетизации из тестовой организации, которую вы хотите использовать повторно. В этом случае после удаления данных монетизации необходимо синхронизировать данные Apigee Edge.

Подробнее о том, как удалить данные о монетизации из организации… (DEVRT-2581)

Добавлен API для включения монетизации для организации

Теперь вы можете включить монетизацию для организации с помощью API.

Подробнее о том, как включить монетизацию для организации…

(DEVRT-2383)

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

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

Private Cloud 4.17.05

Cloud 17.04.12 (интерфейс)

Cloud 17.04.05 (интерфейс)

Cloud 17.03.29 (интерфейс)

Cloud 17.03.15.01 (интерфейс)

Cloud 17.03.15 (интерфейс)

Cloud 17.03.13.02 (монетизация)

Cloud 17.03.13.01 (монетизация)

Cloud 17.03.13 (управление API)

Cloud 17.03.1 (интерфейс)

Cloud 17.02.15 (интерфейс)

Cloud 17.02.13 (API runtime)

Cloud 17.02.13 (управление API)

Cloud 17.01.18 (интерфейс)

Cloud 17.01.16 (управление API)

Cloud 17.01.16 (монетизация)