Comienza a usar Node.js en Apigee Edge

Estás viendo la documentación de Apigee Edge.
Ir a la documentación de Apigee X. info

En este tema, se explica la forma más sencilla de encapsular una aplicación de Node.js en un proxy de API con la IU de administración.

Introducción

Es probable que la primera app de Node.js que creaste haya sido un servidor HTTP que responde a las solicitudes con "Hello World!" La forma 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 en funcionamiento que se ejecuta en Edge. Después de eso, puedes usar el editor de código en la IU para modificar la app de Node.js, agregar archivos adicionales de Node.js, agregar políticas, etcétera.

Crea 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 simples.
  1. En el asistente para crear un proxy, selecciona Node.js App.
  2. Haz clic en Siguiente.
  3. Sigue el asistente para crear un proxy y realiza las siguientes selecciones.
    Campo Selección
    Detalles
    Nombre del proxy Ingresa Nodejs-Hello. Es el nombre que se muestra para tu API.
    Ruta base del proxy Ingresa nodejs-hello
    Fuente Selecciona "Hello World" Sample. (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 información sobre los hosts virtuales, consulta Información sobre los hosts virtuales (beta).
    Compilación
    Entornos de implementación Selecciona prueba.
  4. Haz clic en Compilar e implementar
    En respuesta, deberías ver una confirmación de que tu proxy de API nuevo se creó correctamente y se implementó en el entorno "prueba".
  5. Haz clic en Ver el proxy <proxy name> en 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 prueba. 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 Desarrollar.



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

Por ejemplo, cambia la respuesta de Hello, World! a otra cosa, como Hello, Node!, y, luego, haz clic en Guardar. El proxy se guarda 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!

Más información para ejecutar aplicaciones de Node.js en Apigee Edge

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

Para usar Node.js en Apigee Edge, debes especificar un archivo de secuencia de comandos principal de Node.js. Esta secuencia de comandos debe configurarse para controlar las solicitudes entrantes, lo que suele hacerse con los módulos http o https, la creación de un cliente, y etcétera. (Si la secuencia de comandos principal no se configura de esta manera, simplemente se ejecutará y saldrá después de que se implemente). En Apigee Edge, cada secuencia de comandos de 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á nuevas solicitudes y las procesará. Para obtener más información, consulta "Invoca un archivo de Node.js importado" en Implementa una app independiente de Node.js.

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 independiente de Node.js, se explica cómo usar el comando apigeetool para implementar una app de Node.js desde la línea de comandos.