Comienza a usar Node.js en Apigee Edge

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

En este tema, se explica la manera más sencilla de unir una aplicación de Node.js a un proxy de API mediante la IU de administración.

Introducción

Es probable que la primera app de Node.js que creaste sea un servidor HTTP que responde a las solicitudes con “Hello World!”. La manera más sencilla de probar Node.js en Apigee Edge es hacer algo muy similar. Con solo unos clics, tendrás un servidor HTTP de Node.js con proxy que se ejecuta en Edge. Luego, puedes usar el editor de código de la IU para modificar la app de Node.js, agregar archivos Node.js adicionales, agregar políticas, etcétera.

Cómo crear el ejemplo de Hello World! proxy de API

En esta sección, se explica cómo crear un proxy de API de Edge que interactúe con un servidor HTTP de Node.js. El código del servidor HTTP de Node.js ya está escrito y se implementa automáticamente en Edge cuando sigues estos pasos sencillos.
  1. En el asistente de compilación de un proxy, selecciona App de Node.js.
  2. Presiona Siguiente.
  3. Sigue las indicaciones del asistente Build a Proxy y realiza las siguientes selecciones.
    Campo Selección
    Detalles
    Nombre del proxy Ingresa Nodejs-Hello. El nombre que se muestra para tu API.
    Ruta base del proxy Ingrese nodejs-hello
    Origen Selecciona Muestra de “Hello World”. (Analizaremos las otras opciones más adelante en este tema).
    Descripción Ingresa una descripción de la API.
    Seguridad
    Transferencia (ninguna) Selecciona Transferencia (ninguna). Crea un proxy de transferencia simple.
    Hosts virtuales
    predeterminado, seguro No cambies los valores predeterminados. Para obtener más información sobre los hosts virtuales, consulta Acerca de los hosts virtuales (Beta).
    Compilación
    Implementa entornos Selecciona prueba.
  4. Haz clic en Build and Deploy.
    Como respuesta, deberías ver una confirmación de que tu nuevo proxy de API se creó y se implementó correctamente en el entorno de prueba.
  5. Haz clic en View the <proxy name> proxy in el editor para mostrar la página de detalles del proxy de API.

Invoca el proxy de Hello

Cuando llamas al proxy hello, la aplicación de Node.js se ejecuta automáticamente y responde con “Hello, World!”. Ten en cuenta que, a menos que especifiques lo contrario, la aplicación de Node.js se implementa en el entorno llamado test. Esta es la llamada básica con Curl (sustituye el nombre de tu organización por myorg).
$ curl http://myorg-test.apigee.net/nodejs-hello
Hello, World!

Visualiza y edita el código de Node.js

Veamos el código de Node.js que se agregó al proxy de API. Ve a la página de resumen del proxy de Hello World y haz clic en Develop.



Se abrirá la vista Desarrollar, que incluye un editor de código. Puedes editar el código allí directamente.

Por ejemplo, cambia la respuesta de Hello, World! a algo diferente, como Hello, Node! y, luego, haz clic en Guardar. Se guarda el proxy y se vuelve a implementar.

Por último, vuelve a invocar el proxy para verificar el cambio:

$ curl http://myorg-test.apigee.net/nodejs-hello
Hello, Node!

Obtén más información sobre la ejecución de aplicaciones de Node.js en Apigee Edge

Como todas las aplicaciones de Node.js, las de Node.js que se ejecutan en Apigee Edge se ejecutan en un solo subproceso de control. No es necesario (y de hecho, no se puede) iniciar otro subproceso ni sincronizar variables entre subprocesos. Debido a que Node.js aplica programación sin bloqueo, una sola secuencia de comandos puede admitir miles de solicitudes simultáneas porque la secuencia de comandos deja la CPU cada vez que tiene que esperar algo y recibe una notificación más tarde cuando ocurre algo.

Para usar Node.js en Apigee Edge, debes especificar un archivo de secuencia de comandos principal de Node.js. Esta secuencia de comandos se debe configurar para manejar las solicitudes entrantes, que se suelen hacer mediante los módulos http o https, la creación de un cliente, etcétera. (Si la secuencia de comandos principal no está configurada de esta manera, simplemente se ejecutará y saldrá después de que se implemente). En Apigee Edge, cada secuencia de comandos de la aplicación de Node.js se inicia desde el principio cuando se implementa el proxy y se detiene cuando se anula su implementación. En el medio, esperará a recibir solicitudes nuevas y las procesará. Para obtener más información, consulta "Cómo invocar un archivo Node.js importado" en Implementa una app de Node.js independiente.

Próximos pasos

También puedes crear e implementar aplicaciones independientes de Node.js directamente desde tu sistema de archivos. En el siguiente tema, Implementa una app de Node.js independiente, se explica cómo usar el comando apigeetool para implementar una app de Node.js desde la línea de comandos.