Estás viendo la documentación de Apigee Edge.
Ir a la
documentación de Apigee X. info
Los destinos alojados te permiten ejecutar aplicaciones de Node.js en un entorno de ejecución nativo alojado por Apigee. El objetivo de los destinos alojados es simple: permitirte implementar aplicaciones en un entorno nativo, seguro, escalable y aislado en el que los proxies de API de Edge puedan llamarlos como servicios de destino.
Como se ilustra en la siguiente figura, un proxy de API de Edge llama a una aplicación de Node.js que se implementa en el entorno de destinos alojados. Ten en cuenta que el entorno de destinos alojados está dentro de una organización:entorno de Apigee.
Para que un proxy de API de Edge se comunique con una aplicación de destinos alojados compilada y, luego, implementada correctamente se requiere una configuración simple en el extremo de destino del proxy. Para comenzar, ve a los instructivos de destinos alojados.
¿Qué entornos de ejecución de aplicaciones admiten los destinos alojados?
Actualmente, solo puedes implementar apps de Node.js en destinos alojados.
Instala destinos alojados
Los destinos alojados están disponibles en todas las organizaciones de la nube pública de Edge. No necesitas instalar nada para usar destinos alojados.
Verifica que los destinos alojados estén habilitados
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é establecida en 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 los destinos alojados
Los destinos alojados permiten 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 de forma local antes de implementarla y asegurarte de que la versión implementada funcione exactamente como lo hace de forma 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 elegir específicamente 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 Límites de productos de Apigee.
Pasos básicos que debes seguir
Si estás familiarizado con el desarrollo de proxies de Edge, solo necesitas aprender algunos pasos simples para usar destinos alojados de forma correcta. Básicamente, creas, implementas y administras proxies de Edge para destinos alojados de la misma manera que lo haces para cualquier otro proxy de Apigee Edge.
Para usar destinos alojados, debes realizar las siguientes tareas. En los instructivos se explican en detalle cada una de estas tareas.
- Desarrolla y prueba tu aplicación de Node.js de forma local.
- Crea un archivo de manifiesto en el directorio raíz de tu proyecto de aplicación. El manifiesto es un archivo YAML que especifica información necesaria para compilar y, luego, implementar la aplicación.
- Agrega tu aplicación al proxy de Edge 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 destinos alojados
Las aplicaciones de destinos alojados se limitan a una organización-entorno de Edge. Este alcance es el mismo que para cualquier proxy de Edge.
¿Pueden las aplicaciones de destinos alojados acceder a los datos del proxy?
Actualmente, las apps de destinos alojados no tienen acceso al entorno de ejecución del proxy. Esto significa que no puedes acceder a las variables de flujo , los caché y otras entidades directamente desde las aplicaciones de destinos alojados.
Con Node.js integrado (la compatibilidad tradicional con Node.js basada en Trireme en Edge), puedes usar
apigee-access para
acceder a las variables de flujo y otras entidades en Edge. Sin embargo, los destinos alojados no admiten el módulo apigee-access para las implementaciones de Node.js.
Consulta también
¿Es posible evitar la falta de apigee-access?
Migra el código de la aplicación existente a destinos alojados
Actualmente, no hay una ruta de migración automatizada desde una aplicación tradicional de Node.js integrada basada en Trireme a destinos alojados. Sin embargo, puedes convertir el código de la aplicación existente a destinos alojados de forma manual. Para obtener un ejemplo, consulta Cómo migrar un proxy de Node.js existente a un proxy de destinos alojados.