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

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

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

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

Обзор релиза

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

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

Что касается устаревания, хранилища были объявлены устаревшими.

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

Устаревания и вывод из эксплуатации

Следующие функции были устарели или прекращены в этом выпуске. Подробнее см. в политике прекращения поддержки Edge .

Упразднено: Добавление путей на вкладке «Производительность» прокси-API

До этого выпуска можно было перейти к прокси-серверу API в интерфейсе управления, открыть вкладку «Производительность» и создать различные пути для сравнения на основе диаграммы на вкладке «Производительность» прокси-сервера и на панели мониторинга бизнес-транзакций. Эта функция теперь упразднена и больше не доступна в интерфейсе. Альтернативу этой функции см. в следующей статье сообщества Apigee: Альтернатива API бизнес-транзакций (EDGEUI-902).

Упразднено: URL-адрес buildInfo для портала Developer Services

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

http://yourportal.com/buildInfo

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

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

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

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

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

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

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

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

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

(EDGEUI-1020)

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

Теперь вы можете указать длительность тайм-аута API, используемого Edge UI, чтобы контролировать время ожидания возврата вызова управления 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 UI для вызовов управления Edge API .

(EDGEUI-816)

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

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

Дополнительные сведения см. в разделе Настройка маршрутизатора для повторных попыток подключения к обработчику сообщений .

(APIRT-2912)

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

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

Более подробную информацию см. в разделе Управление пользователями, ролями и разрешениями .

(ДОС-4895)

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

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

Более подробную информацию см. в разделе Обзор установки Edge .

(ДОС-4573)

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

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

https://domain/login

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

Дополнительную информацию см. в разделе Настройка имени хоста для ссылок в создаваемых электронных письмах .

(EDGEUI-1044)

Настройка базового URL-адреса, отображаемого Edge UI для прокси-сервера API

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

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

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

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

<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 UI, будет выглядеть следующим образом: « http:// DNS_name_or_IP :9005/ », тогда как фактическая настройка псевдонима хоста — « http://myCo.com ».

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

Подробнее см. в разделе Настройка доступа TLS к API для частного облака .

(EDGEUI-5008)

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

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

Подробнее см. в разделе Включение ведения журнала отладки .

(APIRT-4018)

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

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

В этом выпуске Edge содержатся новые инструкции по установке и синтаксис команд для утилиты apigee-analytics-collector . В этом выпуске для установки утилиты apigee-analytics-collector вместо npm используется apigee-service , а сама утилита вызывается через 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
• Ссылки на ресурсы
• Целевые серверы

(МГМТ-3840)

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

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

(МГМТ-3485)

Монетизация

Удаление данных монетизации для организации

Вы можете захотеть удалить данные о монетизации вашей организации в следующих сценариях:

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

Для получения дополнительной информации см. Удаление данных о монетизации из вашей организации . (DEVRT-2581)

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

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

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

(DEVRT-2383)

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

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

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

Cloud 17.04.12 (UI)

Cloud 17.04.05 (UI)

Облако 17.03.29 (UI)

Облако 17.03.15.01 (UI)

Cloud 17.03.15 (UI)

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

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

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

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

Cloud 17.02.15 (UI)

Cloud 17.02.13 (среда выполнения API)

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

Cloud 17.01.18 (UI)

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

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