Вы просматриваете документацию Apigee Edge .
Перейдите в документацию Apigee X.info
Hosted Targets позволяет запускать приложения Node.js в нативной среде выполнения, размещенной на сервере Apigee. Цель Hosted Targets проста: позволить развертывать приложения в нативной, безопасной, масштабируемой и изолированной среде, где прокси-серверы Edge API могут вызывать их в качестве целевых сервисов.
Как показано на следующем рисунке, прокси-сервер Edge API вызывает приложение Node.js, развернутое в среде Hosted Targets. Обратите внимание, что среда Hosted Targets находится в рамках организации Apigee:environment.
Для обеспечения взаимодействия прокси-сервера Edge API с правильно настроенным и развернутым приложением Hosted Targets требуется простая настройка в поле Target Endpoint прокси-сервера. Для начала перейдите к руководствам по Hosted Targets .
Какие среды выполнения приложений поддерживает Hosted Targets?
В настоящее время развертывание приложений Node.js на размещенных целевых серверах возможно только.
Установка размещенных целевых объектов
Функция Hosted Targets доступна во всех организациях Edge Public Cloud. Для использования Hosted Targets ничего устанавливать не нужно.
Проверка включения функции «Размещенные целевые объекты».
Чтобы убедиться, что в вашей организации включена функция Hosted Targets, получите данные о вашей организации и убедитесь, что свойство features.isEdgeFunctionsEnabled установлено в значение true. Это свойство доступно только для чтения.
Например:
https://api.enterprise.apigee.com/v1/organizations/myorg
{ "createdAt":1507572884047, "createdBy":"jdoe@apigee.com", "displayName":"myorg", "environments":[ "prod", "dev", "test", "portal" ], "lastModifiedAt":1507578673194, "lastModifiedBy":"jdoe@apigee.com", "name":"jdoe", "properties":{ "property":[ { "name":"features.isSmbOrganization", "value":"false" }, { "name":"self.service.virtual.host.enabled", "value":"true" }, { "name":"features.isCpsEnabled", "value":"true" }, { "name":"features.isEdgeFunctionsEnabled", "value":"true" } ] }, "type":"paid" }
Что вам нужно знать о размещенных целевых объектах
Hosted Targets позволяет запускать приложения Node.js в нативной среде, не зависящей от каких-либо специфических для Apigee технологий выполнения. Вы можете отлаживать и тестировать свое приложение локально перед развертыванием и быть уверенными, что развернутая версия будет работать точно так же, как и локально. Во время развертывания вы можете выбрать любую версию среды выполнения приложения для запуска вашего приложения в Hosted Targets. Например, вы можете специально выбрать запуск приложения Node.js в среде версии 8.10.0.
Пределы
Ограничения на использование размещенных целевых объектов см. в разделе «Ограничения продуктов Apigee» .
Основные шаги, которые необходимо выполнить.
Если вы знакомы с разработкой Edge-прокси, вам нужно освоить всего несколько простых шагов для успешного использования Hosted Targets. По сути, вы создаете, развертываете и управляете Edge-прокси для Hosted Targets так же, как и для любого другого Edge-прокси Apigee .
Для использования Hosted Targets необходимо выполнить следующие задачи. В руководствах подробно описана каждая из этих задач.
- Разрабатывайте и тестируйте своё Node.js-приложение локально.
- Создайте файл манифеста в корневом каталоге вашего проекта приложения. Манифест представляет собой YAML-файл, содержащий информацию, необходимую для сборки и развертывания приложения.
- Добавьте свое приложение в прокси-сервер Edge в качестве размещенного ресурса.
- В поле Target Endpoint прокси-сервера добавьте пустой тег
<HostedTarget/>. Этот тег указывает Edge развернуть приложение Node.js в среде Hosted Targets. Например:
<?xml version="1.0" encoding="UTF-8"?>
<TargetEndpoint name="default">
<PreFlow name="PreFlow">
<Request />
<Response />
</PreFlow>
<PostFlow name="PostFlow">
<Request />
<Response />
</PostFlow>
<Flows />
<HostedTarget />
</TargetEndpoint>Область применения приложений, размещаемых на целевых серверах.
Приложения Hosted Targets ограничены средой организации Edge. Эта область действия аналогична той, что используется для любого прокси-сервера Edge.
Могут ли приложения, размещенные на целевых серверах, получать доступ к данным прокси-сервера?
Приложения, размещенные на целевых серверах, в настоящее время не имеют доступа к среде выполнения прокси-сервера. Это означает, что вы не можете получить прямой доступ к переменным потока, кэшам и другим сущностям из приложений, размещенных на целевых серверах.
При использовании встроенного Node.js (традиционная поддержка Node.js на основе Trireme в Edge) вы можете использовать apigee-access для доступа к переменным потока и другим сущностям в Edge. Однако Hosted Targets не поддерживает модуль apigee-access для развертывания Node.js. См. также: Можно ли обойти отсутствие apigee-access?
Перенос существующего кода приложения на размещенные целевые платформы.
В настоящее время автоматизированного пути миграции с традиционного встроенного приложения Node.js на основе Trireme на Hosted Targets не существует. Однако вы можете вручную преобразовать существующий код приложения в формат Hosted Targets. Пример см. в разделе «Миграция существующего прокси-сервера Node.js на прокси-сервер Hosted Targets» .