Общие сведения о размещенных целевых страницах

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

Размещенные целевые сервисы позволяют запускать приложения Node.js в собственной среде выполнения, размещенной в Apigee. Цель размещенных целевых сервисов проста: позволить вам развертывать приложения в собственной, безопасной, масштабируемой и изолированной среде, в которой прокси API Edge могут вызывать их как целевые сервисы.

Как показано на рисунке ниже, прокси-сервер API Edge вызывает приложение Node.js, развернутое в среде Hosted Targets. Обратите внимание, что среда Hosted Targets ограничена организацией и средой Apigee.

Чтобы прокси-сервер Edge API взаимодействовал с правильно созданным и развернутым приложением Hosted Targets, требуется простая конфигурация в конечной точке целевого сервиса прокси-сервера. Чтобы начать работу, ознакомьтесь с руководствами по размещенным целевым страницам.

Какие среды выполнения приложений поддерживает размещенный целевой сервис?

В настоящее время на размещенные целевые платформы можно развертывать только приложения Node.js.

Как установить размещенные цели

Размещенные цели доступны во всех организациях Edge Public Cloud. Для использования размещенных целей ничего устанавливать не нужно.

Как проверить, включены ли размещенные целевые страницы

Чтобы проверить, включены ли в вашей организации размещенные целевые страницы, получите информацию об организации и убедитесь, что для свойства 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"
  }
  

Что нужно знать о размещенных целях

Целевые сервисы, размещенные в облаке, позволяют запускать приложения Node.js в собственной среде, которая не зависит от технологий выполнения, используемых в Apigee. Вы можете отлаживать и тестировать приложение локально, прежде чем развертывать его, и быть уверенным, что развернутая версия будет работать точно так же, как и локальная. При развертывании вы можете выбрать любую версию среды выполнения приложения для запуска приложения на размещенных целевых устройствах. Например, вы можете запустить приложение Node.js в среде v8.10.0.

Ограничения

Ограничения на использование размещенных целевых сервисов приведены в статье Ограничения продуктов Apigee.

Основные действия

Если вы знакомы с разработкой прокси-серверов Edge, вам нужно будет выполнить всего несколько простых шагов, чтобы успешно использовать размещенные цели. По сути, вы создаете, развертываете и управляете прокси-серверами Edge для размещенных целевых сервисов так же, как и любыми другими прокси-серверами Apigee Edge.

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

• Разработайте и протестируйте приложение Node.js в локальной среде.
• Создайте файл манифеста в корневом каталоге проекта приложения. Манифест – это файл YAML, в котором указана информация, необходимая для сборки и развертывания приложения.
• Добавьте приложение в прокси-сервер Edge как ресурс размещенного типа.
• В конечной точке целевого сервиса прокси-сервера добавьте пустой тег <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

Приложения Hosted Targets относятся к определенной организации и среде Edge. Область действия такая же, как и для любого прокси-сервера Edge.

Могут ли приложения Hosted Targets получать доступ к данным прокси-сервера?

У приложений Hosted Targets пока нет доступа к среде выполнения прокси. Это означает, что вы не можете получить доступ к переменным потока, кешу и другим объектам напрямую из приложений Hosted Targets.

Встроенный Node.js (традиционная поддержка Node.js на основе Trireme в Edge) позволяет использовать apigee-access для доступа к переменным потока и другим объектам в Edge. Однако Hosted Targets не поддерживает модуль apigee-access для развертываний Node.js. Дополнительная информация Можно ли обойтись без apigee-access?

Как перенести существующий код приложения на размещенные целевые платформы

В настоящее время не существует автоматического способа переноса традиционного встроенного приложения Node.js на основе Trireme на размещенные целевые платформы. Однако вы можете вручную преобразовать существующий код приложения в размещенные цели. Пример можно найти в разделе Перенос существующего прокси-сервера Node.js на прокси-сервер размещенных целевых сервисов.