Descripción general de los destinos alojados

Estás viendo la documentación de Apigee Edge.
Ve a la Documentación de Apigee X.
información

Los destinos alojados te permiten ejecutar aplicaciones de Node.js en un entorno de ejecución nativo que aloja Apigee. El objetivo de los objetivos alojados es simple: permitirle 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 ilustra en la siguiente figura, un proxy de la API de Edge llama a una aplicación de Node.js que se en el entorno de destinos alojados. Ten en cuenta que el entorno de destinos alojados en un entorno de organización y entorno de Apigee.

Hacer que un proxy de API de Edge se comunique con una aplicación de objetivos alojados, implementada y compilada de forma correcta 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 admiten Objetivos alojados?

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

Instalar destinos alojados

Los destinos alojados están disponibles en todas las organizaciones de nube pública perimetral. No es necesario que instales para usar objetivos alojados.

Verifica que los destinos alojados estén habilitados

Si quieres verificar que tu organización cuenta con Destinos alojados habilitados, obtener los detalles de tu organización y asegúrate de que el features.isEdgeFunctionsEnabled se configure como true. 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

Los destinos alojados permiten que las aplicaciones de Node.js se ejecuten en un entorno nativo que no depende de ninguna tecnología de entorno de ejecución específica de Apigee. Puedes depurar y probar tu app a nivel local antes de implementarla y asegúrate de que la versión implementada que a nivel local. En el momento de la implementación, puedes elegir cualquier versión del entorno de ejecución de la aplicación para que ejecuta tu aplicación en Destinos Alojados. Por ejemplo, podrías elegir específicamente ejecutar una app de Node.js en un entorno v8.10.0

Límites

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

Pasos básicos que se deben seguir

Si tienes conocimientos sobre el desarrollo de proxies perimetrales, solo necesitas aprender unos pasos sencillos. para usar objetivos alojados con éxito. En términos sencillos, creas, implementas y administras proxies de Edge. para destinos alojados del mismo modo en que lo haces con cualquier otro proxy de Apigee Edge.

Para usar destinos alojados, debes realizar las siguientes tareas. Los instructivos explicaré 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 tu aplicación. El manifiesto es un archivo YAML que especifica la información necesaria para compilar e implementar la aplicación.
  • Agrega tu aplicación al proxy de Edge como un recurso alojado el tipo de letra.
  • 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 destinos alojados

Las aplicaciones de destinos alojados se limitan a un entorno de organización de Edge. Este alcance es de la misma forma que para cualquier proxy de Edge.

¿Las aplicaciones de destinos alojados pueden acceder a datos de proxy?

Las apps de destinos alojados no acceso al entorno de ejecución del proxy. Esto significa que no puedes acceder al flujo almacenamiento en caché, cachés y 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, los destinos alojados no admite el módulo apigee-access para implementaciones de Node.js. Consulta también ¿Es posible solucionar la falta de acceso a Apigee?

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

Actualmente, no existe una ruta de migración automatizada Aplicación de Node.js incorporada y basada en Trireme en destinos alojados. Sin embargo, puedes convertir el código de la aplicación existente en destinos alojados de forma manual. Por ejemplo, consulta Cómo migrar un proxy de Node.js existente a un proxy de destinos alojados