Estás viendo la documentación de Apigee Edge.
Ve 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: te permiten implementar aplicaciones en un entorno nativo, seguro, escalable y aislado en el que los proxies de la 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 destinos alojados. Ten en cuenta que el entorno de destinos alojados tiene alcance 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, implementada y compilada de forma correcta, 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 admiten Objetivos alojados?
Actualmente, solo puedes implementar apps de Node.js en objetivos alojados.
Instalar destinos alojados
Los destinos alojados están disponibles en todas las organizaciones de nube pública perimetral. No necesitas instalar nada para usar objetivos alojados.
Verifica que los destinos alojados estén habilitados
Si deseas verificar que tu organización tenga habilitados los objetivos alojados, obtén los detalles de tu organización y asegúrate de que la propiedad features.isEdgeFunctionsEnabled esté establecida 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
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 los límites de productos de Apigee.
Pasos básicos que se deben seguir
Si estás familiarizado con el desarrollo de proxies perimetrales, solo necesitas aprender unos pasos sencillos para usar los destinos alojados de forma correcta. En esencia, creas, implementas y administras proxies de Edge para los destinos alojados de la misma manera que 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 tu 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 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 un entorno de organización de Edge. Este alcance es el mismo que para cualquier proxy de Edge.
¿Las aplicaciones de destinos alojados pueden acceder a los datos de 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 las variables de flujo, las cachés y otras entidades directamente desde las aplicaciones de destinos alojados.
Con Node.js incorporado (la compatibilidad tradicional de Node.js basada en Trireme en Edge), puedes usar apigee-access para acceder a variables de flujo y a otras entidades en Edge. Sin embargo, los destinos alojados no son compatibles con 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 de Node.js incorporada basada en Trireme tradicional 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 destinos alojados.