Scrivere il servizio web con Node.js

Questa guida mostra come scrivere un servizio web Node.js da eseguire nell'ambiente standard di App Engine. Per scoprire di più sul runtime Node.js e sul suo funzionamento, consulta Ambiente di runtime Node.js.

Prima di iniziare

• Installa Node.js LTS.

Punti chiave

• Puoi utilizzare le dipendenze elencandole nel file package.json. Per ulteriori informazioni, consulta la sezione Specificare le dipendenze.
• App Engine avvia l'applicazione eseguendo npm start.
• Il server deve ascoltare la porta specificata da process.env.PORT, una variabile di ambiente impostata dal runtime di App Engine.
• Per eseguire il deployment del servizio in App Engine, devi avere un file app.yaml.

Crea un server per ascoltare le richieste HTTP

Il nucleo del servizio web è il server HTTP. Il codice campione in questa guida utilizza il framework Express.js per gestire le richieste HTTP, ma puoi utilizzare un framework web di tua scelta.

1. Crea una nuova cartella denominata my-nodejs-service per il servizio Node.js.

2. Vai alla cartella nel terminale e crea un file package.json eseguendo npm init.

3. Aggiungi Express come dipendenza eseguendo:

   npm install express
   

   Verifica che Express venga visualizzato nel campo dependencies del file package.json. Ecco un esempio:

   {
     ...
     "dependencies": {
       "express": "^4.16.3"
     }
     ...
   }
   

4. Aggiungi uno script start al file package.json:

   "scripts": {
     "start": "node server.js"
   }
   

5. Crea un file denominato server.js nella stessa cartella e aggiungi il seguente codice:

   const express = require('express');
   const app = express();
   
   app.get('/', (req, res) => {
     res.send('Hello from App Engine!');
   });
   
   // Listen to the App Engine-specified port, or 8080 otherwise
   const PORT = process.env.PORT || 8080;
   app.listen(PORT, () => {
     console.log(`Server listening on port ${PORT}...`);
   });

Si tratta di un server web molto semplice che risponde a tutte le richieste GET al percorso radice ('/') con il testo "Un saluto da App Engine!" Nota le ultime quattro righe, dove il server è impostato per ascoltare la porta specificata da process.env.PORT, una variabile di ambiente impostata dal runtime di App Engine. Se il server non è impostato per ascoltare questa porta, non riceverà richieste.

Tieni presente che se process.env.PORT non è impostato, viene utilizzata la porta 8080 come valore predefinito. Questo è necessario per testare l'app localmente, perchéprocess.env.PORT non viene impostato durante le esecuzioni locali, ma solo quando la tua app è in esecuzione su App Engine. Puoi utilizzare la porta che preferisci per i test, ma questa guida utilizza 8080.

Esegui il server localmente

Per eseguire il server localmente:

1. Esegui npm start nel terminale. Verrà eseguito il file server.js.

2. Indirizza il browser web a http://localhost:8080.

Dovresti vedere una pagina con il testo "Un saluto da App Engine!".

Crea il file app.yaml

Un file app.yaml specifica le impostazioni per l'ambiente di runtime del servizio App Engine. Il servizio non verrà implementato senza questo file.

1. Nella cartella my-nodejs-service, crea un file denominato app.yaml.

2. Aggiungi i seguenti contenuti:

   runtime: nodejs20

   Si tratta di un file di configurazione minimo che indica ad App Engine la versione del runtime di Node.js. Il file app.yaml può anche specificare impostazioni di rete, impostazioni di scalabilità e altro ancora. Per ulteriori informazioni, consulta il riferimento app.yaml.

A questo punto, dovresti avere una struttura di file come la seguente:

  my-nodejs-service/
  app.yaml
  package.json
  server.js

Passaggi successivi

Ora che hai creato un semplice server web Node.js che ascolta la porta corretta e hai specificato il runtime in un file app.yaml, puoi eseguire il deployment del servizio su App Engine.