Introduzione a Node.js su Apigee Edge

Stai visualizzando la documentazione di Apigee Edge.
Vai alla documentazione di Apigee X. informazioni

Questo argomento spiega il modo più semplice per eseguire il wrapping di un'applicazione Node.js in un proxy API utilizzando l'interfaccia utente di gestione.

Introduzione

È probabile che la prima app Node.js creata sia stata un server HTTP che risponde alle richieste con "Hello World!". Il modo più semplice per provare Node.js su Apigee Edge è fare qualcosa di molto simile. Con pochi clic del mouse, potrai disporre di un server HTTP Node.js funzionante e con proxy in esecuzione su Edge. Successivamente, puoi utilizzare l'editor di codice nell'interfaccia utente per modificare l'app Node.js, aggiungere altri file Node.js, criteri e così via.

Creazione dell'esempio di Hello World! proxy API

Questa sezione spiega come creare un proxy API Edge che interagisca con un server HTTP Node.js. Il codice del server HTTP Node.js è già scritto e ne viene eseguito automaticamente il deployment su Edge dopo aver seguito questi semplici passaggi.
  1. Nella procedura guidata Crea un proxy, seleziona App Node.js.
  2. Fai clic su Avanti.
  3. Segui la procedura guidata di creazione di un proxy e seleziona quanto segue.
    Campo Selezione
    Dettagli
    Nome proxy Inserisci Nodejs-Hello. Il nome visualizzato per l'API.
    Percorso base proxy Inserisci nodejs-hello
    Origine Seleziona Esempio"Hello World". (Parleremo delle altre opzioni più avanti in questo argomento).
    Descrizione Inserisci una descrizione dell'API.
    Sicurezza
    Passaggio (nessuno) Seleziona Pass-through (nessuno). Crea un semplice proxy di pass-through.
    Host virtuali
    predefinita, sicura Non modificare le impostazioni predefinite. Per scoprire di più sugli host virtuali, consulta Informazioni sugli host virtuali (beta).
    Crea
    Esegui il deployment degli ambienti Seleziona Test.
  4. Fai clic su Crea ed esegui il deployment
    In risposta, dovresti visualizzare una conferma dell 'avvenuta creazione e del deployment del nuovo proxy API nell'ambiente di test.
  5. Fai clic su Visualizza il proxy <nome proxy> nell'editor per visualizzare la pagina dei dettagli del proxy API.

Richiamo del proxy hello

Quando chiami il proxy hello, l'applicazione Node.js viene eseguita automaticamente, rispondendo con "Hello, World!". Tieni presente che, se non diversamente specificato, viene eseguito il deployment dell'applicazione Node.js nell'ambiente chiamato test. Ecco la chiamata di base mediante Curl (sostituisci il nome della tua organizzazione con myorg). 
$ curl http://myorg-test.apigee.net/nodejs-hello
Hello, World!

Visualizzazione e modifica del codice Node.js

Vediamo il codice Node.js aggiunto al proxy API. Vai alla pagina di riepilogo del proxy Hello World e fai clic su Develop.



Si apre la visualizzazione Sviluppo che include un editor di codice. Puoi modificare il codice direttamente lì.

Ad esempio, modifica la risposta da Hello, World! a un'altra, come Hello, Node!, quindi fai clic su Salva. Il proxy è stato salvato ed eseguito nuovamente il deployment.

Infine, chiama di nuovo il proxy per verificare la modifica:

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

Scopri di più sull'esecuzione delle applicazioni Node.js su Apigee Edge

Come tutte le applicazioni Node.js, le applicazioni Node.js in esecuzione su Apigee Edge vengono eseguite in un unico thread di controllo. Non è necessario (e in effetti non è possibile) avviare un altro thread o sincronizzare le variabili tra i thread. Poiché Node.js applica la programmazione non bloccante, un singolo script può supportare migliaia di richieste in parallelo perché lo script cede la CPU ogni volta che deve attendere qualcosa e viene avvisato in un secondo momento quando si verifica.

Per utilizzare Node.js su Apigee Edge, devi specificare un file di script Node.js principale. Questo script deve essere configurato per gestire le richieste in entrata, cosa che in genere è possibile utilizzando i moduli http o https, creando un client e così via. Se lo script principale non è configurato in questo modo, verrà semplicemente eseguito e chiuso dopo il deployment. In Apigee Edge, ogni script dell'applicazione Node.js viene avviato dall'inizio quando viene eseguito il deployment del proxy e arrestato quando viene annullato il deployment del proxy. Nel frattempo, attenderà le nuove richieste e le elaborerà. Per maggiori informazioni, consulta la sezione "Richiamare un file Node.js importato" in Deployment di un'app Node.js autonoma.

Passaggi successivi

Puoi anche creare ed eseguire il deployment di applicazioni Node.js autonome direttamente dal tuo file system. L'argomento successivo, Deployment di un'app Node.js autonoma spiega come utilizzare il comando apigeetool per eseguire il deployment di un'app Node.js dalla riga di comando.