Premiers pas avec Node.js sur Apigee Edge

Vous consultez la documentation Apigee Edge.
Accédez à la documentation Apigee X. info

Cet article explique la méthode la plus simple pour encapsuler une application Node.js dans un proxy d'API à l'aide de l' interface utilisateur de gestion.

Introduction

Il est probable que la première application Node.js que vous avez créée était un serveur HTTP qui répondait aux requêtes avec "Hello World!" La méthode la plus simple pour essayer Node.js sur Apigee Edge consiste à faire quelque chose de très similaire. En quelques clics de souris, vous disposerez d'un serveur HTTP Node.js proxy fonctionnel exécuté sur Edge. Vous pourrez ensuite utiliser l'éditeur de code de l'interface utilisateur pour modifier l' application Node.js, ajouter des fichiers Node.js supplémentaires, ajouter des règles, etc.

Créer l'exemple Hello World! proxy d'API

Cette section explique comment créer un proxy d'API Edge qui interagit avec un serveur HTTP Node.js. Le code du serveur HTTP Node.js est déjà écrit pour vous et est automatiquement déployé sur Edge lorsque vous suivez ces étapes simples.
  1. Dans l'assistant "Créer un proxy", sélectionnez Application Node.js.
  2. Cliquez sur Suivant.
  3. Suivez l'assistant "Créer un proxy" et effectuez les sélections suivantes.
    Champ Sélection
    Détails
    Nom du proxy Saisissez Nodejs-Hello. Nom affiché pour votre API.
    Chemin de base du proxy Saisissez nodejs-hello
    Source Sélectionnez "Hello World" Sample (Exemple "Hello World"). (Nous aborderons les autres options plus loin dans cet article.)
    Description Saisissez une description de l'API.
    Sécurité
    Directe (aucune) Sélectionnez Directe (aucune). Crée un proxy direct simple.
    Hôtes virtuels
    par défaut, sécurisé Ne modifiez pas les valeurs par défaut. Pour en savoir plus sur les hôtes virtuels, consultez À propos des hôtes virtuels (bêta).
    Build
    Environnements de déploiement Sélectionnez test.
  4. Cliquez sur Build and Deploy
    Un message de confirmation devrait s'afficher pour indiquer que votre nouveau proxy d'API a été créé et déployé dans l'environnement "test".
  5. Cliquez sur View the <proxy name> proxy in the editor (Afficher le proxy <nom du proxy> dans l'éditeur) pour afficher la page d'informations du proxy d'API.

Appeler le proxy hello

Lorsque vous appelez le hello proxy, l'application Node.js s'exécute automatiquement et répond avec "Hello, World!". Notez que sauf indication contraire, l'application Node.js est déployée dans l'environnement appelé test. Voici l'appel de base à l'aide de Curl (remplacez myorg par le nom de votre organisation). 
$ curl http://myorg-test.apigee.net/nodejs-hello
Hello, World!

Afficher et modifier le code Node.js

Examinons le code Node.js qui a été ajouté au proxy d'API. Accédez à la page de résumé du proxy Hello World, puis cliquez sur "Develop" (Développer).



La vue "Develop" (Développer) s'ouvre et inclut un éditeur de code. Vous pouvez y modifier le code directement.

Par exemple, remplacez la réponse Hello, World! par Hello, Node! puis cliquez sur Save. Le proxy est enregistré et redéployé.

Enfin, appelez à nouveau le proxy pour vérifier la modification :

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

En savoir plus sur l'exécution d'applications Node.js sur Apigee Edge

Comme toutes les applications Node.js, les applications Node.js exécutées sur Apigee Edge s'exécutent dans un seul thread de contrôle. Il n'est pas nécessaire (et en fait impossible) de démarrer un autre thread ou de synchroniser des variables entre les threads. Étant donné que Node.js applique une programmation non bloquante, un seul script peut prendre en charge des milliers de requêtes simultanées, car il abandonne le processeur chaque fois qu'il doit attendre quelque chose et est averti ultérieurement lorsque cela se produit.

Pour utiliser Node.js sur Apigee Edge, vous devez spécifier un fichier de script Node.js principal. Ce script doit être configuré pour gérer les requêtes entrantes, ce que vous faites généralement à l'aide des modules http ou https, en créant un client, et ainsi de suite. (Si le script principal n'est pas configuré de cette manière, il s'exécute et se ferme simplement après son déploiement.) Dans Apigee Edge, chaque script d'application Node.js est démarré depuis le début lorsque le proxy est déployé et arrêté lorsque le proxy est non déployé. Entre-temps, il attend de nouvelles requêtes et les traite. Pour en savoir plus, consultez "Appeler un fichier Node.js importé" dans Déployer une application Node.js autonome.

Étapes suivantes

Vous pouvez également créer et déployer des applications Node.js autonomes directement à partir de votre système de fichiers. L'article suivant, Déployer une application Node.js autonome, explique comment utiliser la commande apigeetool pour déployer une application Node.js à partir de la ligne de commande.