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 Specifica delle dipendenze.
• App Engine avvia l'applicazione eseguendo npm start.
• Il server deve essere in ascolto sulla 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 disporre di un file app.yaml.

Crea un server per ascoltare le richieste HTTP

Il cuore del tuo servizio web è il server HTTP. Il codice campione in questa guida utilizza il framework Express.js per gestire le richieste HTTP, ma puoi utilizzare il framework web che preferisci.

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 tuo 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: risponde a tutte le richieste GET al percorso principale ('/') con il testo "Hello from App Engine!". Prendi nota delle ultime quattro righe, in cui il server è impostato per l'ascolto sulla 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, la porta 8080 viene utilizzata come valore predefinito. Questa operazione è necessaria per testare l'app localmente, perché process.env.PORT non viene impostato durante le esecuzioni locali, ma solo quando l'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 visualizzare una pagina con il testo "Hello from App Engine!" (Ciao da App Engine).

Creare il file app.yaml

Un file app.yaml specifica le impostazioni per l'ambiente di runtime del servizio App Engine. Il servizio non verrà eseguito il deployment 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 Node.js. Il file app.yaml può anche specificare le impostazioni di rete, le impostazioni di scalabilità e altro ancora. Per ulteriori informazioni, consulta il riferimento app.yaml.

A questo punto, dovresti avere una struttura di file simile alla 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 deployare il servizio su App Engine.