Trigger di Pub/Sub (1ª generazione)
In Cloud Functions, un trigger Pub/Sub consente di chiamare una funzione in risposta ai messaggi Pub/Sub. Se specifichi un trigger Pub/Sub per una funzione. Devi specificare anche un trigger Pub/Sub. per ogni argomento. La tua funzione verrà chiamata ogni volta che un messaggio viene pubblicato nel all'argomento specificato.
Affinché una funzione utilizzi un trigger Pub/Sub, deve essere implementata come funzione basata su evento:
Se utilizzi un Funzione CloudEvent, i dati dell'evento Pub/Sub vengono passati alla tua funzione nel il formato CloudEvents e i dati di CloudEvent il payload è di tipo
MessagePublishedData
.Se utilizzi un funzione in background, il payload dei dati degli eventi Pub/Sub viene passato direttamente alla tua funzione nel
PubsubMessage
formato.
La Google Eventi contiene risorse aggiuntive per l'uso dei dati sugli eventi.
Deployment
Puoi specificare un trigger Pub/Sub quando esegui il deployment di una funzione. Consulta Esegui il deployment di una funzione Cloud Functions per istruzioni generali su come eseguire il deployment di una funzione, per ulteriori informazioni specifiche sulla configurazione di Pub/Sub durante il deployment.
gcloud
Se con gcloud CLI, i flag mostrati qui vengono usati per configurare i trigger Pub/Sub:
gcloud functions deploy YOUR_FUNCTION_NAME \ --trigger-topic=YOUR_PUBSUB_TOPIC \ [--retry] \ ...
- La
--trigger-topic
specifica l'argomento Pub/Sub monitorato dal trigger. I messaggi pubblicati in questo argomento attivano le chiamate alla funzione. - La
Controlli flag
--retry
se le chiamate di funzione non riuscite vengono ritentate automaticamente. Consulta Ripetere le funzioni basate su eventi per ulteriori informazioni.
Eventi Pub/Sub legacy
Le funzioni legacy in Cloud Functions (1ª generazione.) utilizzano un tipo di evento diverso per i trigger Pub/Sub:
gcloud functions deploy YOUR_FUNCTION_NAME \ --trigger-event=providers/cloud.pubsub/eventTypes/topic.publish \ --trigger-resource=YOUR_PUBSUB_TOPIC \ ...
Questo tipo di evento è supportato per le funzioni legacy che già utilizzano questi
eventi. Tuttavia, consigliamo di usare il flag --trigger-topic
, poiché
il tipo di evento precedente potrebbe essere rimosso in una data futura.
Console
Se tramite la console Google Cloud, puoi configurare un trigger Pub/Sub nella sezione Trigger:
- Nel campo Tipo di trigger, seleziona Cloud Pub/Sub.
- Nel campo Seleziona un argomento Cloud Pub/Sub, seleziona un argomento per trigger per il monitoraggio oppure seleziona Crea un argomento per aprire una finestra in creare un nuovo argomento. Quando un messaggio viene pubblicato nella che attiva una chiamata alla tua funzione.
- Seleziona o deseleziona la casella di controllo Riprova in caso di errore per controllare se le chiamate di funzione non riuscite vengono ritentate automaticamente. Consulta Ripetere le funzioni basate su eventi per ulteriori informazioni.
Passaggi successivi
- Scopri come scrivere funzioni basate su eventi.
- Scopri come eseguire il deployment di una funzione Cloud Functions.
- Guarda il tutorial su Pub/Sub per vedere un esempio di scrittura, deployment e chiamata a una funzione con un Trigger di Pub/Sub.