Crea ed esegui il deployment di una funzione Cloud Functions HTTP con Node.js
Questo documento illustra il processo di creazione di una funzione HTTP di Cloud Functions. Questo è uno dei due tipi di Cloud Functions:
- Una funzione HTTP, che richiami dalle richieste HTTP standard.
- Una funzione basata su eventi, che viene attivata da eventi nella tua infrastruttura Cloud, ad esempio messaggi su un argomento Pub/Sub o modifiche in un bucket Cloud Storage.
Per maggiori dettagli, consulta gli articoli sulla scrittura di funzioni HTTP e sulla scrittura di funzioni basate su eventi.
Prima di iniziare
- 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.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.
-
Abilita le API Cloud Functions, Cloud Build, Artifact Registry, Cloud Run, and Cloud Logging.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.
-
Abilita le API Cloud Functions, Cloud Build, Artifact Registry, Cloud Run, and Cloud Logging.
- Installa e inizializza gcloud CLI.
- Aggiorna e installa i componenti di
gcloud
.gcloud components update
-
Prepara l'ambiente di sviluppo.
Crea la funzione
Crea una directory sul tuo sistema locale per il codice della funzione:
Linux o Mac OS X
mkdir ~/helloworld cd ~/helloworld
Windows
mkdir %HOMEPATH%\helloworld cd %HOMEPATH%\helloworld
Crea un file
index.js
nella directoryhelloworld
con il seguente contenuto:Questa funzione di esempio restituisce un allegro "Hello World!" a tutte le richieste.
Specifica delle dipendenze
Le dipendenze in Node.js vengono gestite con npm ed espresse in un file di metadati denominato package.json
. Puoi creare questo file manualmente o con il comando npm
.
Per creare il file
package.json
con il comandonpm
:Esegui il comando
npm init
dalla directory helloworld. PremiEnter
per accettare la risposta predefinita alle relative domande.npm init
Modifica il file
package.json
per aggiungere una dipendenza al framework delle funzioni:"dependencies": { "@google-cloud/functions-framework": "^3.1.0" }
Se preferisci creare il file
package.json
manualmente, copia al suo interno i seguenti contenuti:
Molte librerie client di Node.js possono essere utilizzate con i prodotti Google Cloud e possono essere installate in base alle dipendenze.
Crea e testa la tua funzione in locale
Per testare la funzione localmente prima di eseguirne il deployment, devi installare il framework delle funzioni in locale, quindi eseguire la funzione.
Esegui il comando seguente dalla directory
helloworld
per installare il framework di Functions sulla macchina locale:npm install @google-cloud/functions-framework
Esegui questo comando dalla directory
helloworld
per eseguire la funzione in locale:npx @google-cloud/functions-framework --target=helloGET
Testa la tua funzione visitando
http://localhost:8080
in un browser o eseguendocurl localhost:8080
da un'altra finestra.Per ulteriori dettagli, consulta Invio di richieste a funzioni locali.
La funzione restituisce il messaggio "Hello World!"
esegui il deployment della funzione
Per eseguire il deployment della funzione, esegui il comando gcloud functions deploy
nella directory helloworld
:
gcloud functions deploy hello-node-function \
--gen2 \
--runtime=nodejs20 \
--region=REGION \
--source=. \
--entry-point=helloGET \
--trigger-http \
--allow-unauthenticated
Sostituisci REGION con il nome della regione Google Cloud in cui vuoi eseguire il deployment della funzione (ad esempio us-west1
).
Questa operazione esegue il deployment della funzione di esempio con il runtime nodejs20 nella regione scelta.
Il flag facoltativo --allow-unauthenticated
consente di raggiungere la funzione
senza autenticazione.
Testa la funzione di cui hai eseguito il deployment
Dopo il deployment della funzione, annota la proprietà
uri
nell'output del comandogcloud functions deploy
o recuperala con il seguente comando:gcloud functions describe hello-node-function \ --region=REGION
Sostituisci REGION con il nome della regione Google Cloud in cui hai eseguito il deployment della funzione (ad esempio
us-west1
).Visita questo URL nel tuo browser o utilizzando il seguente comando
curl
:curl FUNCTION_URL
Sostituisci FUNCTION_URL con la proprietà
uri
che hai appena recuperato.La funzione restituisce un messaggio "Hello World!".
Visualizza i log della funzione
Visualizza i log con lo strumento a riga di comando
Puoi esaminare i log della funzione con l'interfaccia utente di Cloud Logging o utilizzando Google Cloud CLI.
Per visualizzare i log per la tua funzione con gcloud CLI, utilizza il comando gcloud functions logs read
:
gcloud functions logs read \
--gen2 \
--region=REGION \
--limit=10 \
hello-node-function
Sostituisci REGION con il nome della regione Google Cloud in cui hai eseguito il deployment della funzione
(ad esempio us-west1
).
L'output è simile al seguente:
LEVEL: I
NAME: hello-node-function
TIME_UTC: 2023-06-16 18:42:24.956
LOG:
LEVEL: I
NAME: hello-node-function
TIME_UTC: 2023-06-16 18:42:01.692
LOG:
LEVEL: I
NAME: hello-node-function
TIME_UTC: 2023-06-16 18:31:47.711
LOG: Default STARTUP TCP probe succeeded after 1 attempt for container "hello--node--function-1" on port 8080.
LEVEL: I
NAME: hello-node-function
TIME_UTC: 2023-06-16 18:31:46.542
LOG:
LEVEL: I
NAME: hello-node-function
TIME_UTC: 2023-06-16 18:31:27.390
LOG: Default STARTUP TCP probe succeeded after 1 attempt for container "hello--node--function-1" on port 8080.
Visualizza i log con la dashboard dei log
Per visualizzare i log per la tua funzione con la dashboard di logging, apri la pagina Panoramica di Cloud Functions e fai clic sul nome della funzione nell'elenco, quindi fai clic sulla scheda Log.