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

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

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

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

Обзор выпуска

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

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

Что касается устаревания, хранилища устарели.

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

Амортизация и выход на пенсию

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

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

До этого выпуска вы могли перейти к прокси-серверу API в пользовательском интерфейсе управления, перейти на вкладку «Производительность» и создать различные пути для сравнения на основе диаграмм на вкладке «Производительность» прокси-сервера и на панели мониторинга «Бизнес-операции». Эта функция больше не доступна в пользовательском интерфейсе. Альтернативу этой функции см. в следующей статье сообщества Apigee: https://community.apigee.com/articles/23936/alternative-to-business-transactions-api.html . (ЭДГЕУИ-902)

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

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

http://yourportal.com/buildInfo

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

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

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

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

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

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

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

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

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

(ЭДГЕУИ-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 для вызовов управления Edge API .

(ЭДГЕУИ-816)

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

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

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

(АПИРТ-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 для прокси-сервера 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 .

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

(ЭДГЕУИ-5008)

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

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

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

(АПИРТ-4018)

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

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

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

Дополнительную информацию см. в разделе «Загрузка данных трафика API в Apigee — бета-версия» .

Новый каталог установки по умолчанию после обновления портала служб разработчиков 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 после удаления данных монетизации.

Дополнительную информацию см. в разделе Удаление данных монетизации из вашей организации . (ДЕВРТ-2581)

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

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

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

(ДЕВРТ-2383)

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

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

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

Облако 17.04.12 (UI)

Облако 17.04.05 (UI)

Облако 17.03.29 (UI)

Облако 17.03.15.01 (UI)

Облако 17.03.15 (UI)

Облако 17.03.13.02 (монетизация)

Облако 17.03.13.01 (монетизация)

Облако 17.03.13 (управление API)

Облако 17.03.1 (UI)

Облако 17.02.15 (UI)

Облако 17.02.13 (время выполнения API)

Облако 17.02.13 (управление API)

Облако 17.01.18 (UI)

Облако 17.01.16 (управление API)

Облако 17.01.16 (монетизация)