Premiers pas avec Node.js sur Apigee Edge

<ph type="x-smartling-placeholder"></ph> Vous consultez la documentation Apigee Edge.
Accédez à la page Documentation sur Apigee X. En savoir plus

Cet article explique le moyen le plus simple d'encapsuler une application Node.js dans un proxy d'API à l'aide de la classe de gestion centralisée.

Introduction

Il y a de fortes chances que la première application Node.js que vous ayez créée soit un serveur HTTP qui répond à avec "Hello World!" Le moyen le plus simple d'essayer Node.js sur Apigee Edge est de faire quelque chose de très similaire. En seulement quelques clics, vous disposez d'un code Node.js fonctionnel et proxy Serveur HTTP exécuté sur Edge. Vous pouvez ensuite utiliser l'éditeur de code de l'interface utilisateur pour modifier le une application Node.js, ajouter des fichiers Node.js supplémentaires, ajouter des règles, etc.

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

Ce explique comment créer un proxy d'API Edge qui interagit avec un serveur HTTP Node.js. La Le code de serveur HTTP Node.js est déjà écrit pour vous et est automatiquement déployé sur Edge lorsque suivez ces étapes simples.
  1. Dans l'assistant "Créer un proxy", sélectionnez Application Node.js.
  2. Cliquez sur Suivant.
  3. Suivez les instructions de l'assistant "Build a Proxy" (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" Exemple. (Nous aborderons les autres options plus loin dans cet article.)
    Description Saisissez une description de l'API.
    Sécurité
    Ignorer (aucun) Sélectionnez Passthrough (none) (Passthrough (aucun)). Crée un transfert simple proxy.
    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 (Compiler et déployer).
    En réponse, vous devriez voir un accusé de réception indiquant que votre nouveau proxy d'API a bien été créé. et déployé dans l'environnement de test environnement.
  5. Cliquez sur Afficher le nom de <nom du proxy>. dans l'éditeur pour afficher la page des détails du proxy d'API.

Appeler le proxy hello

Lorsque vous appelez la fonction hello l'application Node.js s'exécute automatiquement et répond avec le message "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 avec Curl (remplacez votre le nom de l'organisation myorg). 
$ 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éder à la page de résumé de la Hello World, puis cliquez sur Develop (Développer).



La vue Développement s'ouvre et inclut un éditeur de code. Vous pouvez modifier le code ici directement.

Par exemple, remplacez la réponse Hello, World! par une autre réponse, comme Hello, Node!, puis sur Enregistrer. Le proxy est enregistrées et redéployées.

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 ce fil de contrôle. Il n'est pas nécessaire (et même impossible) de démarrer un autre fil de discussion. synchroniser les variables entre les threads. Puisque Node.js applique une programmation non bloquante, un seul peut prendre en charge des milliers de requêtes simultanées, car il abandonne le processeur il doit attendre quelque chose, et il est averti plus tard quand 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 en utilisant les modules http ou https, en créant un client ; ainsi de suite. Si le script principal n'est pas configuré de cette manière, il s'exécutera et se fermera après. est déployé.) 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é lorsqu'il est annulé. Entre les deux, il attendra de nouvelles demandes et les traiter. Pour en savoir plus, consultez la section "Appeler un fichier Node.js importé" dans Déployer une application autonome Application Node.js

Étapes suivantes

Vous pouvez également créer et déployer des applications Node.js autonomes directement depuis votre système de fichiers. La rubrique suivante, Déployer un application Node.js autonome, explique comment utiliser la commande apigeetool pour déployer un Application Node.js à partir de la ligne de commande.