Descripción general de los destinos alojados

Estás consultando la documentación de Apigee Edge.
Consulta la documentación de Apigee X.
Información

Hosted Targets te permite ejecutar aplicaciones de Node.js en un entorno de ejecución nativo alojado por Apigee. El objetivo de Hosted Targets es simple: permitirte implementar aplicaciones en un entorno nativo, seguro, escalable y aislado en el que los proxies de API de Edge pueden llamarlas como servicios de destino.

Como se muestra en la siguiente figura, un proxy de la API de Edge llama a una aplicación de Node.js que se implementa en el entorno de Hosted Targets. Ten en cuenta que el entorno de Destinos alojados se define dentro de un entorno de organización y entorno de Apigee.

Para que un proxy de API de Edge se comunique con una aplicación de destino alojada y compilada correctamente, se requiere una configuración simple en el extremo de destino del proxy. Para comenzar, consulta los instructivos de Destinos alojados.

¿Qué entornos de ejecución de aplicaciones admite Hosted Targets?

Actualmente, solo puedes implementar apps de Node.js en destinos alojados.

Instalar destinos alojados

Hosted Targets está disponible en todas las organizaciones de la nube pública perimetral. No necesitas instalar nada para usar Hosted Targets.

Verifica que los destinos alojados esté habilitado

Si deseas verificar que tu organización tenga habilitados los destinos alojados, obtén los detalles de tu organización y asegúrate de que la propiedad features.isEdgeFunctionsEnabled esté configurada como verdadera. La propiedad es de solo lectura.

Por ejemplo:

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"
  }
  

Qué debes saber sobre Hosted Targets

Hosted Targets permite que las aplicaciones de Node.js se ejecuten en un entorno nativo que no depende de ninguna tecnología de tiempo de ejecución específica de Apigee. Puedes depurar y probar tu app localmente antes de implementarla. Ten la seguridad de que la versión implementada funcionará exactamente como lo hace de manera local. En el momento de la implementación, puedes elegir cualquier versión del entorno de ejecución de la aplicación para ejecutarla en Destinos alojados. Por ejemplo, puedes optar por ejecutar una app de Node.js en un entorno v8.10.0.

Límites

Para conocer los límites de uso de los destinos alojados, consulta los límites de los productos de Apigee.

Pasos básicos que se deben seguir

Si estás familiarizado con el desarrollo de proxies perimetrales, solo necesitas conocer algunos pasos sencillos para usar los destinos alojados de forma correcta. En esencia, creas, implementas y administras proxies perimetrales para destinos alojados como lo haces con cualquier otro proxy de Apigee Edge.

Para usar Destinos alojados, debes realizar las siguientes tareas. En los instructivos, se explica cada una de estas tareas en detalle.

  • Desarrolla y prueba tu aplicación de Node.js de forma local.
  • Crea un archivo de manifiesto en el directorio raíz del proyecto de la aplicación. El manifiesto es un archivo YAML en el que se especifica la información necesaria para compilar y, luego, implementar la aplicación.
  • Agrega tu aplicación al proxy perimetral como un tipo de recurso alojado.
  • En el extremo de destino del proxy, agrega una etiqueta <HostedTarget/> vacía. Esta etiqueta le indica a Edge que implemente la aplicación de Node.js en el entorno de Destinos alojados. Por ejemplo:
  • <?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>

Alcance de las aplicaciones de Hosted Targets

Las aplicaciones de destinos alojados tienen alcance en un entorno de organización de Edge. Este alcance es el mismo que para cualquier proxy perimetral.

¿Las aplicaciones de Destinos alojados pueden acceder a los datos del proxy?

Por el momento, las apps de destinos alojados no tienen acceso al entorno de ejecución del proxy. Esto significa que no puedes acceder a variables de flujo, cachés ni otras entidades directamente desde las aplicaciones de Destinos alojados.

Con Node.js incorporado (la compatibilidad tradicional con Node.js basada en Trireme en Edge), puedes usar apigee-access para acceder a variables de flujo y otras entidades en Edge. Sin embargo, Hosted Targets no admite el módulo apigee-access para implementaciones de Node.js. Consulta también ¿Es posible resolver la falta de acceso a Apigee?

Migra el código de la aplicación existente a destinos alojados

Por el momento, no existe una ruta de migración automatizada de una aplicación tradicional de Node.js incorporada basada en Trireme a los destinos alojados. Sin embargo, puedes convertir el código de la aplicación existente en destinos alojados de forma manual. Para ver un ejemplo, consulta Migra un proxy de Node.js existente a un proxy de Hosted Targets.