Trigger di Pub/Sub

Nelle funzioni di Cloud Run, un trigger Pub/Sub consente di chiamare una funzione in risposta ai messaggi Pub/Sub. Quando specifichi un trigger Pub/Sub per una funzione, specifichi anche un argomento Pub/Sub. La tua funzione verrà chiamata ogni volta che un messaggio viene pubblicato nel per l'argomento specificato.

Un attivatore Pub/Sub viene implementato come funzione CloudEvent, in cui i dati dell'evento Pub/Sub vengono passati alla funzione nel formato CloudEvents e il payload dei dati CloudEvent è di tipo MessagePublishedData.

La Google Eventi contiene risorse aggiuntive per lavorare con i 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 Run 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 esegui il deployment utilizzando l'interfaccia a riga di comando gcloud, i flag mostrati qui vengono utilizzati per configurare gli attivatori 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.
  • Il --retry flag controlla se le chiamate di funzione non riuscite vengono tentate automaticamente di nuovo. Per ulteriori informazioni, consulta Riprovare le funzioni basate su eventi.

Console

Se stai eseguendo il deployment utilizzando la console Google Cloud, puoi configurare un trigger Pub/Sub nella sezione Trigger:

  1. Nel campo Tipo di trigger, scegli Cloud Pub/Sub.
  2. Nel campo Argomento Cloud Pub/Sub, seleziona un argomento da monitorare per l'attivatore. Messaggi pubblicati in questo argomento attivare le chiamate alla funzione.
  3. Seleziona o deseleziona la casella di controllo Riprova in caso di errore per controllare se le funzioni Cloud Run tentano automaticamente di nuovo un'invocazione di funzione non riuscita. Per ulteriori informazioni, consulta Riprovare le funzioni basate su eventi.

  4. Fai clic su Altre opzioni per eseguire una configurazione aggiuntiva sull'attivatore:

    • Nel campo Tipo di trigger, specifica una delle opzioni Origini Google, Personalizzato o Di terze parti:

      • Con Origini Google puoi specificare gli attivatori per Pub/Sub, Cloud Storage Firestore e altri provider di eventi Google. Nel riquadro Trigger Eventarc, utilizza il Provider di eventi per selezionare il prodotto che fornisce il tipo di evento che vuoi attivare la funzione. Nel campo Evento, seleziona l'evento da utilizzare come attivatore.

      • L'opzione Personalizzato ti consente di produrre e utilizzare eventi da del codice della tua applicazione. Segui le istruzioni nel riquadro Trigger Eventarc per creare un canale. Un canale è una risorsa utilizzata come pipeline per distribuire eventi personalizzati dai producer ai consumer. Gli eventi personalizzati sono pubblicata su un canale e un trigger Eventarc sottoscrive questi eventi.

      • L'opzione Di terze parti ti consente di eseguire l'integrazione con provider non Google che offrono un'origine Eventarc. Per maggiori dettagli, consulta Eventi di terze parti in Eventarc.

    • Nel campo Evento, seleziona un evento di attivazione. L'impostazione predefinita è google.cloud.pubsub.topic.v1.messagePublished.

    • Facoltativamente, nel campo Account di servizio, seleziona un account di servizio per come identità del trigger Eventarc. Consulta: Identità trigger per ulteriori informazioni.

  5. Fai clic su Salva trigger.

Passaggi successivi