Deployment del servizio Web

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 regione possono sembrare simili ai codici 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 regione è facoltativo nell'URL.

Scopri di più sugli ID regione.

Questa sezione della guida mostra come utilizzare gcloud CLI per eseguire il deployment del tuo servizio web Node.js su App Engine. Per saperne di più sull'ambiente di runtime Node.js, consulta Ambiente di runtime Node.js.

Prima di iniziare

  1. Crea un progetto Google Cloud con un'app App Engine.
  2. Scrivi un server web Node.js pronto per il deployment su App Engine.
  3. Installa Google Cloud CLI, che fornisce lo strumento a riga di comando gcloud. Assicurati che gcloud sia configurato per utilizzare il progetto Google Cloud in cui vuoi eseguire il deployment.

Punti chiave

Utilizza gcloud app deploy e gcloud app browse per eseguire il deployment e visualizzare il servizio.

Deployment del servizio

Nella cartella my-nodejs-service, dove si trova il file app.yaml, esegui questo comando nel terminale:

gcloud app deploy

I file di origine vengono quindi caricati in Google Cloud Storage. Cloud Build crea la tua app e ne esegue il deployment in App Engine.

Per informazioni su altri modi per creare ed eseguire il deployment della tua app, vedi Test e deployment dell'app.

Se non ne hai uno, viene creato un file .gcloudignore per garantire che la cartella node_modules non venga caricata.

I moduli Node.js vengono installati nel cloud, come elencato nei file package.json e package-lock.json e il servizio viene avviato utilizzando npm start.

Deployment di più servizi

Puoi aggiungere più servizi nel progetto creando un file app.yaml per ciascun servizio. Includi l'attributo service in ogni file app.yaml per specificare il nome del servizio. Per scoprire di più su come strutturare la tua app utilizzando più servizi, consulta Strutturare i servizi web in App Engine.

Per eseguire il deployment di più servizi, segui queste istruzioni. A ogni servizio di cui è stato eseguito il deployment sarà assegnato un URL.

Visualizzazione del servizio

Per avviare rapidamente il browser e accedere al tuo servizio web all'indirizzo https://PROJECT_ID.REGION_ID.r.appspot.com, utilizza il seguente comando:

gcloud app browse

Servizi e versioni

Hai appena creato ed eseguito il deployment di un servizio su App Engine. Puoi specificare il nome del tuo servizio nel file app.yaml. Se il nome viene omesso, viene considerato default. Il primo servizio di cui esegui il deployment deve essere quello predefinito.

Puoi aggiornare il servizio in qualsiasi momento eseguendo di nuovo il comando gcloud app deploy. Ogni volta che esegui il deployment, viene creata una nuova versione e il traffico viene instradato automaticamente alla versione più recente.

Per confermare che il servizio è stato creato ed è stato eseguito il deployment di una versione:

  1. Visualizza i tuoi servizi App Engine nella console Google Cloud:

    Visualizza servizi

    Dovresti vedere un servizio nell'elenco, denominato default. Il servizio predefinito è accessibile pubblicamente al seguente URL:

    https://PROJECT_ID.REGION_ID.r.appspot.com

  2. Visualizza le tue versioni:

    Visualizza versioni

    Dovresti vedere una versione con timestamp elencata, corrispondente al tuo deployment.

Per informazioni su come inviare richieste a versioni e servizi specifici, vedi Come vengono instradate le richieste.

Passaggi successivi

Ora che hai un server Node.js in esecuzione su App Engine, scopri come aggiornare il tuo servizio web.