Crea ed esegui il deployment di una funzione Cloud Functions HTTP con Java
Questa guida illustra il processo di scrittura di una Cloud Function utilizzando il runtime Java. Esistono due tipi di funzioni Cloud Functions:
- Una funzione HTTP, che richiami dalle richieste HTTP standard.
- Una funzione basata su eventi, che viene attivata da eventi in Cloud ad esempio i messaggi su un argomento Pub/Sub o le modifiche nel bucket Cloud Storage.
Il documento mostra come creare una funzione HTTP semplice e come realizzarla utilizzando Maven o Gradle.
Per maggiori dettagli, leggi l'articolo Scrivere funzioni HTTP e la 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 Google Cloud SDK.
- Aggiorna e installa i componenti di
gcloud
con quanto segue .gcloud components update
-
Prepara l'ambiente di sviluppo.
Crea la funzione
Questa sezione descrive come creare una funzione.
Maven
Crea una directory sul sistema locale per il codice della funzione:
Linux o Mac OS X:
mkdir ~/helloworld cd ~/helloworld
Windows:
mkdir %HOMEPATH%\helloworld cd %HOMEPATH%\helloworld
Crea la struttura del progetto che contenga la directory e il file di origine.
mkdir -p ~/helloworld/src/main/java/functions touch ~/helloworld/src/main/java/functions/HelloWorld.java
Aggiungi i seguenti contenuti al file
HelloWorld.java
:Questa funzione di esempio restituisce il saluto "Hello World!"
Gradle
Crea una directory sul sistema locale per il codice della funzione:
Linux o Mac OS X:
mkdir ~/helloworld-gradle cd ~/helloworld-gradle
Windows:
mkdir %HOMEPATH%\helloworld-gradle cd %HOMEPATH%\helloworld-gradle
Crea la struttura del progetto che contenga la directory e il file di origine.
mkdir -p src/main/java/functions touch src/main/java/functions/HelloWorld.java
Aggiungi i seguenti contenuti al file
HelloWorld.java
:Questa funzione di esempio restituisce il saluto "Hello World!"
Specifica delle dipendenze
Il passaggio successivo è impostare le dipendenze:
Maven
Passa alla directory helloworld
creata in precedenza e crea
un file pom.xml
:
cd ~/helloworld
touch pom.xml
Per gestire le dipendenze utilizzando Maven, specifica le dipendenze in
la sezione <dependencies>
all'interno del file pom.xml
del tuo progetto. Per questo esercizio, copia i seguenti contenuti
nel file pom.xml
.
Vedi helloworld per un campione completo basato su Maven.
Gradle
Passa alla directory helloworld-gradle
creata in precedenza e
crea un file build.gradle
:
cd ~/helloworld-gradle
touch build.gradle
Per gestire le dipendenze utilizzando Gradle, specifica le dipendenze in
il file build.gradle
del tuo progetto. Per questo esercizio, copia i seguenti contenuti
nel file build.gradle
. Tieni presente che questo file build.gradle
include una
per aiutarti a eseguire le funzioni localmente.
Vedi helloworld-gradle per un campione completo basato su Gradle.
Crea e testa la tua funzione in locale
Prima di eseguire il deployment della funzione, puoi crearla e testarla in locale:
Maven
Esegui questo comando per verificare che la funzione venga creata:
mvn compile
Un'altra opzione è utilizzare il comando
mvn package
per compilare il Java eseguire i test e pacchettizzare il codice in un file JAR all'interno . Puoi scoprire di più sul ciclo di vita della build di Maven quiAvvia la funzione con il seguente comando:
mvn function:run
Testa la funzione visitando
http://localhost:8080
in un browser oppure eseguendocurl localhost:8080
da un'altra finestra.Consulta Invio di richieste a funzioni locali per in modo più dettagliato.
Gradle
Esegui questo comando per verificare che la funzione venga creata:
gradle build
Avvia la funzione con il seguente comando:
gradle runFunction -Prun.functionTarget=functions.HelloWorld
Testa la funzione visitando
http://localhost:8080
in un browser oppure eseguendocurl localhost:8080
da un'altra finestra.Consulta Invio di richieste a funzioni locali per in modo più dettagliato.
esegui il deployment della funzione
Per eseguire il deployment della funzione, esegui questo comando
nella directory helloworld
(se utilizzi maven
)
o la directory helloworld-gradle
(per Gradle):
gcloud functions deploy java-http-function \
--gen2 \
--entry-point=functions.HelloWorld \
--runtime=java17 \
--region=REGION \
--source=. \
--trigger-http \
--allow-unauthenticated
Sostituisci REGION con il nome della regione Google Cloud in cui vuoi eseguire il deployment della funzione
(ad es. us-west1
).
Il flag facoltativo --allow-unauthenticated
ti consente di raggiungere la funzione
senza autenticazione.
java-http-function
è il nome registrato con cui la tua funzione
è identificato nella console Google Cloud e --entry-point
specifica
il nome completo della classe (FQN) della funzione.
Testa la funzione di cui hai eseguito il deployment
Dopo il deployment della funzione, prendi nota della proprietà
uri
dall'output delgcloud functions deploy
oppure recuperalo con il seguente comando:gcloud functions describe java-http-function \ --region=REGION
Sostituisci REGION con il nome della regione Google Cloud in cui hai eseguito il deployment della funzione (ad es.
us-west1
).Accedi all'URL dal browser. La funzione restituisce un messaggio "Hello World!" per creare un nuovo messaggio email.
Visualizza i log della funzione
Visualizza i log con lo strumento a riga di comando
Puoi rivedere i log della funzione con l'interfaccia utente di Cloud Logging o tramite Google Cloud CLI.
Per visualizzare i log per la tua funzione con gcloud CLI, utilizza il metodo
Comando logs read
:
gcloud functions logs read \
--gen2 \
--limit=10 \
--region=REGION \
java-http-function
Sostituisci REGION con il nome della regione Google Cloud in cui hai eseguito il deployment della funzione
(ad es. us-west1
).
L'output è simile al seguente:
LEVEL: I
NAME: my-first-function
TIME_UTC: 2023-05-29 23:09:57.708
LOG:
LEVEL: I
NAME: my-first-function
TIME_UTC: 2023-05-29 23:05:53.257
LOG: Default STARTUP TCP probe succeeded after 1 attempt for container "my--first--function-1" on port 8080.
LEVEL:
NAME: my-first-function
TIME_UTC: 2023-05-29 23:05:53.248
LOG: 2023-05-29 23:05:53.248:INFO:oejs.Server:main: Started @892ms
Visualizza i log con la dashboard dei log
Per visualizzare i log per la funzione con la dashboard di logging, apri la Pagina Panoramica di Cloud Functions e fai clic su il nome della funzione nell'elenco, poi fai clic sulla scheda Log.