Crea un'app Node.js nell'ambiente flessibile di App Engine

Crea un'app Node.js nell'ambiente flessibile di App Engine

ID regione

REGION_ID è un codice abbreviato assegnato da Google in base alla regione selezionata al momento della creazione dell'app. Il codice non corrispondono a un paese o a una provincia, anche se potrebbero essere visualizzati alcuni ID regione in modo simile ai codici paese e provincia di uso comune. Per le app create dopo il giorno Febbraio 2020, REGION_ID.r è incluso in URL di App Engine. Per le app esistenti create prima di questa data, l'ID regione è facoltativo nell'URL.

Scopri di più sugli ID regione.

Ok

Questa guida rapida illustra come creare ed eseguire il deployment di un'app che visualizza un breve messaggio. Tu Puoi utilizzare l'applicazione di esempio in questa guida rapida per qualsiasi versione supportata di Node.js, specificando la versione del runtime e il sistema operativo app.yaml.

Prima di iniziare

1. Accedi al tuo account Google Cloud. Se non conosci Google Cloud, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti gratuiti per l'esecuzione, il test e il deployment dei carichi di lavoro.

2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

3. Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.

4. Attiva Cloud Build API.

   Abilita l'API

5. Installa Google Cloud CLI.

6. Per initialize gcloud CLI, esegui questo comando:

   gcloud init

7. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

8. Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.

9. Attiva Cloud Build API.

   Abilita l'API

10. Installa Google Cloud CLI.

11. Per initialize gcloud CLI, esegui questo comando:

    gcloud init

Prerequisiti aggiuntivi

1. Inizializza la tua app App Engine con il tuo progetto e scegli la relativa area geografica:

   gcloud app create --project=[YOUR_PROJECT_ID]
   

   Quando richiesto, seleziona la regione in cui vuoi individuare la tua applicazione App Engine.

   Attenzione: non puoi modificare la regione di un'app una volta impostato.

2. Installa i seguenti prerequisiti:

   • Scarica e installare Git.
   • Prepara l'ambiente per lo sviluppo Node.js.

Località App Engine

App Engine è regionale, il che significa che l'infrastruttura che esegue le tue app in una regione specifica e Google la gestisce in modo che sia disponibile in modo ridondante tutte le zone all'interno di quella regione.

Soddisfare i requisiti di latenza, disponibilità o durabilità è fondamentale i fattori necessari per selezionare la regione in cui vengono eseguite le tue app. In genere, puoi seleziona la regione più vicina agli utenti della tua app, ma devi considerare località in cui è disponibile App Engine nonché le località dell'altro Prodotti e servizi Google Cloud utilizzati dalla tua app. Utilizzo dei servizi in più località può influire sulla latenza dell'app e sulle sue pricing.

Non puoi modificare la regione di un'app dopo averla impostata.

Nota: due sedi, chiamate europe-west e us-central nei comandi App Engine e nella console Google Cloud, sono rispettivamente denominati europe-west1 e us-central1, altrove nella documentazione di Google.

Se hai già creato un'applicazione App Engine, puoi visualizzarne la regione effettuando una delle seguenti operazioni:

• Esegui il comando gcloud app describe.

• Apri l'app Dashboard di App Engine nella console Google Cloud. L'area viene visualizzata vicino alla parte superiore della pagina.

Ok

Questa guida rapida dimostra una semplice applicazione Node.js scritto con Express.js il modello di machine learning.

Importante: Per un'esperienza ottimale su Windows, esegui l'upgrade alla versione più recente di Node.js gestore di pacchetti (npm) eseguendo npm install -g npm. Ultima versione di npm le dipendenze in una struttura di directory piatta, quindi le installazioni che non sono in conflitto con la lunghezza massima del percorso Windows, pari a 255 caratteri. Se preferisci continuare a utilizzare una versione precedente di npm, puoi ridurre la durata di percorsi spostando il progetto alla radice dell'unità, ad esempio C:\.

scarica l'app Hello World

Abbiamo creato un'app Hello World per App Engine, così potrai rapidamente avere un'idea generale del deployment di un'app in Google Cloud.

1. Clona il repository dell'app di esempio Hello World nella tua macchina locale.

   git clone https://github.com/GoogleCloudPlatform/nodejs-docs-samples
   

   In alternativa puoi scaricare l'esempio come file ZIP ed estrarlo.

2. Passa alla directory che contiene il codice campione.

      cd nodejs-docs-samples/appengine/hello-world/flexible/
   

Esegui Hello World sul computer locale

1. Installa le dipendenze per questo progetto.

   npm install
   

   Oppure, se usi Yarn.

   yarn install
   

2. Esegui lo script di avvio.

   npm start
   

   Oppure, se usi Yarn.

   yarn start
   

3. Visualizza la tua app nel browser web.

   • Se utilizzi Cloud Shell, nella barra degli strumenti fai clic su Anteprima web e seleziona Anteprima sulla porta 8080.

   • Se non utilizzi Cloud Shell, inserisci il seguente indirizzo:

   http://localhost:8080

Nella pagina viene visualizzato il messaggio Hello World dell'app di esempio. Nel tuo premi Ctrl+C per uscire dal server web.

Esegui il deployment di Hello World ed eseguilo su App Engine

Per eseguire il deployment dell'app in App Engine, procedi nel seguente modo: in un ambiente flessibile:

1. Esegui il deployment dell'app Hello World eseguendo questo dalla directory hello-world/flexible/:

   gcloud app deploy

   Scopri di più sulla e i flag facoltativi.

   Flag dei comandi gcloud comuni

   • Includi il flag --version per specificare un ID univoco identifica la versione dell'app, altrimenti ne viene generata una per te. Esempio: --version [YOUR_VERSION_ID]
   • Includi il flag --project per specificare un'alternativa dall'ID progetto Google Cloud a quello che hai inizializzato come per impostazione predefinita nello strumento gcloud. Esempio: --project [YOUR_PROJECT_ID]

   Esempio:

   gcloud app deploy --version pre-prod-5 --project my-sample-app

   Per scoprire di più sul deployment della tua app dalla riga di comando, vedi Test e deployment dell'app . Per un elenco di tutti i flag dei comandi, vedi gcloud app deploy riferimento.

   Ok
   Nota: Durante il deployment, npm install per impostazione predefinita viene utilizzato per l'installazione dipendenze, a meno che un file yarn.lock esista e non è in elenco nella sezione skip_files del file app.yaml, in in questo caso è invece utilizzato yarn install --production. A fanno sì che la build torni a npm install elimina yarn.lock o aggiungi yarn.lock al Sezione skip_files del tuo file app.yaml.

2. Avvia il browser per visualizzare l'app all'indirizzo https://PROJECT_ID.REGION_ID.r.appspot.com

   gcloud app browse

   dove PROJECT_ID rappresenta il tuo Google Cloud dell'ID progetto.

Questa volta la pagina che visualizza il messaggio Hello World viene consegnata da un in esecuzione su un'istanza di App Engine.

Complimenti! Hai eseguito il deployment della tua prima app di App Engine Ambiente flessibile di App Engine.

Se hai riscontrato errori durante il deployment della tua applicazione, controlla suggerimenti per la risoluzione dei problemi.

Consulta le sezioni seguenti per informazioni sulla pulizia e per i link alle i possibili passaggi successivi.

Esegui la pulizia

Per evitare addebiti, puoi eliminare il tuo progetto Google Cloud per arrestare e la fatturazione per tutte le risorse utilizzate all'interno del progetto.

Attenzione: l'eliminazione di un progetto ha i seguenti effetti:
• L'intero contenuto del progetto viene eliminato. Se hai utilizzato un progetto esistente per le attività in questo documento, quando lo elimini elimini anche qualsiasi altro lavoro svolto nel progetto.
• Gli ID progetto personalizzati non sono più disponibili. Quando hai creato questo progetto, potresti aver creato un ID progetto personalizzato che vuoi utilizzare in futuro. Per conservare gli URL che utilizzano l'ID progetto, ad esempio un URL appspot.com, elimina le risorse selezionate all'interno del progetto anziché eliminare l'intero progetto.
1. Nella console Google Cloud, vai alla pagina Gestisci risorse.

   Vai a Gestisci risorse

2. Nell'elenco dei progetti, seleziona il progetto che vuoi eliminare, quindi fai clic su Elimina.
3. Nella finestra di dialogo, digita l'ID del progetto e fai clic su Chiudi per eliminare il progetto.

Passaggi successivi

Impara a conoscere l'intera piattaforma

Ora che sai com'è sviluppare ed eseguire il deployment delle app di App Engine, puoi esplorare il resto di Google Cloud. Hai già Google Cloud CLI installato, che ti offre gli strumenti per interagire come Cloud SQL, Cloud Storage, Firestore e altro ancora.

Scopri di più sull'ambiente flessibile di App Engine

Ecco alcuni argomenti che ti aiuteranno a continuare a conoscere App Engine:

• Panoramica di App Engine
• Routing delle richieste
• Gestione delle richieste
• Gestione delle istanze

Revisione del codice Hello World

Hello World è l'app di App Engine più semplice possibile, in quanto contiene servizio, ha una sola versione e tutto il codice si trova all'interno nella directory radice dell'app. Questa sezione descrive nel dettaglio ogni file dell'app.

app.js

Il file app.js contiene il codice JavaScript per avviare un server e rispondere a richieste.

Il seguente codice risponde alle richieste dei client web visualizzando la "Hello World" attraverso un server eseguito sulla porta 8080.

const express = require('express');

const app = express();

app.get('/', (req, res) => {
  res.status(200).send('Hello, world!').end();
});

// Start the server
const PORT = parseInt(process.env.PORT) || 8080;
app.listen(PORT, () => {
  console.log(`App listening on port ${PORT}`);
  console.log('Press Ctrl+C to quit.');
});

app.yaml

La app.yaml descrive la seguente configurazione per la tua app:

• Imposta env: flex, a indicare che la tua app utilizza Ambiente flessibile di App Engine.

• Specifica il runtime utilizzato dall'app.

  runtime: nodejs
  env: flex
  runtime_config:
    operating_system: ubuntu22
  # This sample incurs costs to run on the App Engine flexible environment.
  # The settings below are to reduce costs during testing and are not appropriate
  # for production use. For more information, see:
  # https://cloud.google.com/appengine/docs/flexible/nodejs/configuring-your-app-with-app-yaml
  manual_scaling:
    instances: 1
  resources:
    cpu: 1
    memory_gb: 0.5
    disk_size_gb: 10
  

  • Per ulteriori informazioni su come funziona il runtime Node.js, consulta Il runtime di Node.js.

  • Per maggiori dettagli su come progettare la tua app per sfruttare le versioni e servizi, vedi Panoramica di App Engine.

  • Per maggiori dettagli sulle impostazioni di configurazione per App Engine, vedi Configurazione dell'app con app.yaml.

  package.json

  package.json viene utilizzato per specificare le dipendenze dell'app, la versione del nodo e l'avvio dell'app.

  {
    "name": "appengine-hello-world",
    "description": "Simple Hello World Node.js sample for Google App Engine Flexible Environment.",
    "version": "0.0.2",
    "private": true,
    "license": "Apache-2.0",
    "author": "Google Inc.",
    "repository": {
      "type": "git",
      "url": "https://github.com/GoogleCloudPlatform/nodejs-docs-samples.git"
    },
    "engines": {
      "node": ">=16.0.0"
    },
    "scripts": {
      "start": "node app.js",
      "test": "c8 mocha -p -j 2 --exit test/*.test.js"
    },
    "dependencies": {
      "express": "^4.17.1"
    },
    "devDependencies": {
      "c8": "^8.0.0",
      "mocha": "^10.0.0",
      "supertest": "^6.0.0"
    }
  }
  

  Nell'esempio precedente, il file package.json specifica che l'app utilizza Node.js versione 18 e successive e dipende da express. Per maggiori dettagli su come installare ed eseguire dell'app, consulta la documentazione sul runtime di Node.js.