Trigger delle funzioni Cloud Run

Nota: questi contenuti si applicano solo alle funzioni Cloud Run, precedentemente Cloud Functions (2ª gen.).

Per la versione 1ª gen. di questo documento, consulta Trigger delle funzioni Cloud Run (1ª gen.).

Puoi configurare le funzioni di Cloud Run per l'esecuzione in risposta a vari scenari specificando un trigger per la funzione. I trigger possono essere richieste HTTP(S) o a uno di una serie di eventi supportati. Questa pagina fornisce una panoramica sono supportati dalle funzioni Cloud Run.

In generale, gli attivatori si suddividono in due categorie:

• Trigger HTTP(S), che reagiscono alle richieste HTTP(S) e corrispondono Funzioni HTTP.

• Trigger evento, che reagiscono agli eventi all'interno del progetto Google Cloud e corrispondono alle funzioni basate su eventi.

Specifichi gli attivatori nell'ambito del deployment delle funzioni. Non puoi associare la stessa funzione a più attivatori contemporaneamente, ma puoi fare in modo che lo stesso evento causi l'esecuzione di più funzioni implementando più funzioni con le stesse impostazioni di attivazione.

Nota: l'associazione dell'attivatore non avviene immediatamente. Potrebbero essere necessari diversi minuti prima che una funzione di cui è stato eseguito il deployment inizi a essere attivata per gli eventi in arrivo.

Trigger supportati

Le funzioni Cloud Run supportano i seguenti tipi di trigger:

• Trigger HTTP
• Trigger evento:
  • Trigger di Pub/Sub
  • Attivatori Cloud Storage
  • Trigger di Firestore
  • Trigger Eventarc generalizzati
    • Supporta qualsiasi tipo di evento supportato da Eventarc, incluse oltre 90 origini evento tramite Cloud Audit Logs

Tutte le funzioni basate su eventi utilizzano Eventarc per l'invio di eventi. I trigger di Pub/Sub e di Cloud Storage sono implementati particolari tipi di trigger Eventarc.

Nota: Eventarc al momento non supporta gli eventi diretti da Google Analytics for Firebase o Firebase Autenticazione.

Trigger aggiuntivi tramite Pub/Sub e webhook

Poiché le funzioni di Cloud Run possono essere attivate da messaggi su un Pub/Sub puoi integrare le funzioni di Cloud Run con qualsiasi altro servizio Google supporta Pub/Sub come bus di eventi. Inoltre, l'uso di trigger HTTP puoi anche integrarlo con qualsiasi servizio che fornisca callback HTTP (webhook). Le sezioni seguenti descrivono alcuni esempi di integrazioni.

Cloud Logging

Cloud Logging può instradare i log a un argomento Pub/Sub, dove possono essere utilizzati dalle funzioni Cloud Run. Per ulteriori informazioni, consulta Configurare e gestire i sink nella documentazione di Cloud Logging.

Cloud Scheduler

Puoi pianificare una funzione Cloud Run HTTP creando un job Cloud Scheduler che attiva un'azione utilizzando HTTP. Per maggiori informazioni informazioni, nella documentazione di Cloud Scheduler, Pianifica una funzione Cloud Run HTTP.

Puoi pianificare una funzione basata su eventi quando deve essere attivata direttamente in risposta a eventi all'interno del tuo progetto Google Cloud, ad esempio quando viene pubblicato un messaggio in un argomento Pub/Sub. Per ulteriori informazioni, consulta la documentazione di Cloud Scheduler Pianificare una funzione Cloud Run basata su eventi.

Cloud Tasks

Le attività di destinazione HTTP di Cloud Tasks ti consentono di eseguire gestori delle attività in qualsiasi endpoint HTTP, quindi è possibile utilizzare una funzione Cloud Run con un trigger HTTP come gestore delle attività. Puoi anche utilizzare le attività per limitare la velocità o la frequenza di chiamata delle funzioni. Consulta: Crea attività target HTTP nella documentazione di Cloud Tasks per saperne di più.

Gmail

Con l'API Push Notification di Gmail, puoi inviare eventi Gmail a un argomento Pub/Sub e utilizzarli con le funzioni Cloud Run.