Trigger Pub/Sub

Nelle funzioni Cloud Run, un attivatore 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 funzione verrà chiamata ogni volta che viene pubblicato un messaggio nell'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.

Il repository Google Events 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 Eseguire il deployment di una funzione Cloud Run per istruzioni generali su come eseguire il deployment di una funzione e consulta questa sezione per ulteriori informazioni specifiche sulla configurazione degli attivatori 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] \
...
  • Il flag --trigger-topic specifica l'argomento Pub/Sub che verrà monitorato dall'attivatore. 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 esegui 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. I messaggi pubblicati in questo argomento attivano 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:

      • Le origini Google ti consentono di specificare gli attivatori per Pub/Sub, Cloud Storage, Firestore e altri fornitori di eventi Google.Nel riquadro Trigger Eventarc, utilizza il campo Fornitore di eventi per selezionare il prodotto che fornisce il tipo di evento con cui vuoi attivare la funzione. Quindi, nel campo Evento, seleziona l'evento da utilizzare come trigger.

      • L'opzione Personalizzato ti consente di produrre e utilizzare eventi dal codice dell'applicazione. Segui le istruzioni nel riquadro Trigger Eventarc per creare un canale. Un canale è una risorsa utilizzata come pipeline per pubblicare eventi personalizzati dai produttori ai consumatori. Gli eventi personalizzati vengono pubblicati in un canale e un trigger Eventarc si iscrive a 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. Il valore predefinito è google.cloud.pubsub.topic.v1.messagePublished.

    • Facoltativamente, nel campo Account di servizio, seleziona un account di servizio da utilizzare come identità dell'attivatore Eventarc. Per ulteriori informazioni, consulta Identità trigger.

  5. Fai clic su Salva trigger.

Passaggi successivi