Chiamare direttamente Cloud Functions
Per supportare iterazioni e debug rapide, Cloud Functions fornisce un comando call
nell'interfaccia a riga di comando e una funzionalità di test nell'interfaccia utente della console Google Cloud. Ciò ti consente di richiamare direttamente una funzione
per assicurarti che funzioni come previsto. Questo determina l'esecuzione immediata della funzione, anche se potrebbe essere stato sottoposto a deployment per rispondere a un evento specifico.
Testa la funzione con Google Cloud CLI
Per richiamare direttamente la tua funzione utilizzando gcloud CLI, utilizza il comando gcloud functions call
e fornisci tutti i dati che la tua funzione prevede come JSON nell'argomento --data
. Ad esempio:
gcloud functions call YOUR_FUNCTION_NAME \
--region=REGION --gen2 \
--data '{"name":"Kalani"}'
Sostituisci:
- YOUR_FUNCTION_NAME: il nome della funzione che stai testando
- REGION: la regione Google Cloud in cui è stato eseguito il deployment della funzione
L'argomento --data
viene inviato alla funzione come segue:
- Per le funzioni HTTP, i dati forniti vengono inviati come corpo di una richiesta POST.
- Per le funzioni CloudEvent, i dati vengono passati direttamente alla funzione come dati degli eventi.
Per saperne di più, consulta la documentazione di gcloud functions call
.
Testa la funzione con la Google Cloud Console
Per richiamare una funzione direttamente dalla console Google Cloud, segui questi passaggi:
Nell'elenco, fai clic sul nome della funzione da richiamare. Viene visualizzata la pagina Dettagli funzione.
Fai clic sulla scheda Test.
Nel campo Configura evento di trigger, inserisci i dati che la funzione prevede come JSON.
Fai clic su + Aggiungi parametro di query e + Aggiungi parametro intestazione per aggiungere parametri di query e di intestazione alla chiamata di funzione in base alle esigenze.
La console Google Cloud assembla i parametri da te specificati in un comando
gcloud functions call
nella finestra del comando di test dell'interfaccia a riga di comando.Seleziona Esegui in Cloud Shell per aprire una finestra di Cloud Shell ed eseguire questo comando.
Premi Invio per attivare il comando
gcloud functions call
dopo che viene visualizzato nella finestra di Cloud Shell.
Esempio di funzione basata su eventi di Cloud Pub/Sub
Questo esempio mostra come richiamare direttamente una funzione basata su eventi di 2ª generazione attivata da eventi Cloud Pub/Sub:
Node.js
Python
Go
Java
C#
Ruby
PHP
Per richiamare la funzione direttamente, invia un elemento PubsubMessage
, che si aspetta dati con codifica Base64 come dati sugli eventi:
Node.js
DATA=$(printf 'Hello!'|base64) && gcloud functions call helloPubSub --data '{"data":"'$DATA'"}'
Python
DATA=$(printf 'Hello!'|base64) && gcloud functions call hello_pubsub --data '{"data":"'$DATA'"}'
Go
DATA=$(printf 'Hello!'|base64) && gcloud functions call HelloPubSub --data '{"data":"'$DATA'"}'
Java
DATA=$(printf 'Hello!'|base64) && gcloud functions call java-hello-pubsub --data '{"data":"'$DATA'"}'
C#
DATA=$(printf 'Hello!'|base64) && gcloud functions call csharp-hello-pubsub --data '{"data":"'$DATA'"}'
Ruby
DATA=$(printf 'Hello!'|base64) && gcloud functions call hello_pubsub --data '{"data":"'$DATA'"}'
PHP
DATA=$(printf 'Hello!'|base64) && gcloud functions call helloworldPubsub --data '{"data":"'$DATA'"}'
Questo esempio di interfaccia a riga di comando utilizza la sintassi bash
o sh
. Funziona in ambienti Linux e Mac,
ma non in Windows.
Puoi anche richiamare la funzione dalla console Google Cloud utilizzando gli stessi dati sugli eventi nel campo Evento di trigger.