Guida rapida: creazione di un'app Node.js nell'ambiente standard di App Engine

Creare un'app Node.js nell'ambiente standard di App Engine

ID regione

REGION_ID è un codice abbreviato assegnato da Google in base all'area geografica selezionata al momento della creazione dell'app. Il codice non corrisponde a un paese o a una provincia, anche se alcuni ID di area geografica potrebbero essere simili ai codici di paese e provincia di uso comune. Per le app create dopo febbraio 2020, REGION_ID.r è incluso negli URL di App Engine. Per le app esistenti create prima di questa data, l'ID area geografica è facoltativo nell'URL.

Scopri di più sugli ID dell'area geografica.

Questa guida rapida mostra come eseguire il deployment di un'app di esempio su App Engine. Se vuoi saperne di più sulla codifica di un'app per App Engine, consulta la pagina relativa alla creazione di un'app.

App Engine è l'opzione di computing più adatta a te? Scopri altre opzioni per ospitare l'applicazione su Google Cloud.

Costi

Non ci sono costi associati all'esecuzione di questa guida. L'esecuzione della sola app di esempio non supera la quota gratuita.

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. Nella pagina del selettore di progetti della console Google Cloud, seleziona o crea un progetto Google Cloud.

    Vai al selettore progetti

  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. Nella pagina del selettore di progetti della console Google Cloud, seleziona o crea un progetto Google Cloud.

    Vai al selettore progetti

  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 l'area geografica in cui vuoi individuare l'applicazione App Engine.

  2. Installa i seguenti prerequisiti:

Località App Engine

App Engine è a livello di area geografica, il che significa che l'infrastruttura che esegue le tue app si trova in un'area geografica specifica e Google la gestisce in modo che sia disponibile in modo ridondante in tutte le zone all'interno di tale area.

I requisiti di latenza, disponibilità o durabilità sono fattori principali per selezionare l'area geografica in cui vengono eseguite le tue app. In genere, puoi selezionare l'area geografica più vicina agli utenti della tua app, ma dovresti considerare le località in cui è disponibile App Engine e le località degli altri prodotti e servizi Google Cloud che la tua app utilizza. L'utilizzo di servizi in più località può influire sulla latenza e sui prezzi dell'app.

Non puoi modificare l'area geografica di un'app dopo averla impostata.

Se hai già creato un'applicazione App Engine, puoi visualizzarne l'area geografica procedendo in uno dei seguenti modi:

Questa guida rapida illustra una semplice applicazione Node.js scritta con il framework Espressione.js.

Scarica il codice di esempio

Utilizza la nostra semplice app Hello World per una rapida panoramica del deployment di un servizio web su App Engine. Per scaricare il codice nel tuo ambiente di sviluppo:

  1. Scarica il repository delle app di esempio di Node.js:

    Cloud Shell

    Apri il repository in Cloud Shell:

    Apri in Cloud Shell

    Computer locale

    Scarica il repository come file ZIP ed estrailo.

    In alternativa, clona il repository con git:

    git clone https://github.com/GoogleCloudPlatform/nodejs-docs-samples
    
  2. Passa alla directory che contiene l'app Hello World:

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

Esegui Hello World localmente

  1. Installa le dipendenze per il progetto:

    npm install
    
  2. Avvia il server HTTP:

    npm start
    
  3. Visualizza l'app nel browser web:

    Cloud Shell

    Nella barra degli strumenti di Cloud Shell, fai clic su Anteprima web Anteprima web e seleziona Anteprima sulla porta 8080.

    Computer locale

    Nel browser web, apri http://localhost:8080.

    Puoi vedere il messaggio "Hello, world!" nella pagina.

  4. Interrompi il server HTTP premendo Ctrl+C nella finestra del terminale.

Eseguire il deployment ed eseguire Hello World su App Engine

  1. Esegui il deployment dell'app Hello World in App Engine eseguendo il seguente comando dalla directory hello-world/standard:

    gcloud app deploy
    
  2. Visualizza l'app dal vivo all'indirizzo https://PROJECT_ID.REGION_ID.r.appspot.com:

    gcloud app browse
    

Il messaggio "Hello, world!" viene ora recapitato da un server web in esecuzione su un'istanza di App Engine.

Complimenti! Hai eseguito il deployment di un servizio web Node.js su App Engine.

Esegui la pulizia

Se vuoi continuare a imparare su App Engine, puoi tenere il tuo progetto Cloud e seguire la pagina Building a App (Creazione di un'app).

In alternativa, puoi eliminare il progetto Cloud per interrompere la fatturazione per tutte le risorse utilizzate al suo interno.

  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

Ora che hai esperienza con il deployment di un servizio web su App Engine, consulta la procedura dettagliata di Node.js su App Engine tramite la sezione Creazione di un'app.

Per ulteriori informazioni sul runtime Node.js nell'ambiente standard di App Engine, consulta Node.js Runtime Environment.