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

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

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

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

Обзор релиза

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

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

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

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

Амортизация и списание активов

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

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

До этой версии вы могли перейти к API-прокси в пользовательском интерфейсе управления, перейти на вкладку «Производительность» и создать различные пути для сравнения на основе диаграмм на вкладке «Производительность» прокси и на панели мониторинга «Бизнес-транзакции». Эта функция теперь недоступна в пользовательском интерфейсе. Альтернативный вариант этой функциональности см. в следующей статье сообщества Apigee: Альтернатива 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 для установки.

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

(EDGEUI-1020)

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

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

• Параметр conf_apigee_apigee.feature.apitimeout задает время в секундах, в течение которого пользовательский интерфейс ожидает ответа от бэкэнда, независимо от активности на нем. Если вызов не завершается в течение этого времени, пользовательский интерфейс выдает ошибку тайм-аута. Значение по умолчанию — 180 секунд (3 минуты).
• Параметр conf_apigee_play.ws.timeout.idle задает время ожидания пользовательского интерфейса в миллисекундах до появления активности на сервере. Его можно установить на то же значение, что и conf_apigee_apigee_apitimeout , или на меньшее значение. Установка большего значения не дает никакого эффекта. Значение по умолчанию — 180000 миллисекунд (3 минуты).
• Параметр conf_apigee_play.ws.timeout.connection задает время ожидания пользовательского интерфейса для установления соединения. Его можно установить на то же значение, что и conf_apigee_apigee_apitimeout , или на меньшее значение. Установка большего значения не дает никакого эффекта. Значение по умолчанию — 120000 миллисекунд (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 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: " 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 используется apigee-service вместо 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
• Ссылки на источники
• Целевые серверы

(MGMT-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

(MGMT-3485)

Монетизация

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

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

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

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

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

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

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

(DEVRT-2383)

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

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

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

Cloud 17.04.12 (UI)

Cloud 17.04.05 (UI)

Cloud 17.03.29 (UI)

Cloud 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 (UI)

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)

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