Trigger di Cloud Run Functions

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

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

Puoi configurare le funzioni Cloud Run in modo che vengano eseguite in risposta a vari scenari specificando un attivatore per la funzione. Gli attivatori possono essere richieste HTTP(S) o uno di una serie di eventi supportati. Questa pagina fornisce una panoramica degli trigger supportati dalle funzioni Cloud Run.

In linea di massima, gli attivatori si suddividono in due categorie:

• Trigger HTTP, che reagiscono alle richieste HTTP(S) e corrispondono alle 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 degli attivatori non avviene istantaneamente. 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 Pub/Sub
  • Attivazione di 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. Gli trigger Pub/Sub e Cloud Storage sono implementati come tipi specifici di trigger Eventarc.

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

Trigger aggiuntivi tramite Pub/Sub e webhook

Poiché le funzioni Cloud Run possono essere attivate dai messaggi relativi a un argomento Pub/Sub, puoi integrarle con qualsiasi altro servizio Google che supporta Pub/Sub come bus di eventi. Inoltre, utilizzando gli attivatori HTTP, puoi anche eseguire l'integrazione 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 ulteriori informazioni, consulta Pianificare una funzione Cloud Run HTTP nella documentazione di Cloud Scheduler.

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 sezione Pianificare una funzione Cloud Run basata su eventi della documentazione di Cloud Scheduler.

Cloud Tasks

Le attività di destinazione HTTP di Cloud Tasks ti consentono di eseguire gestori delle attività su qualsiasi endpoint HTTP, pertanto una funzione Cloud Run con un trigger HTTP può essere utilizzata come gestore delle attività. Puoi anche utilizzare le attività per limitare la velocità o la frequenza di chiamata delle funzioni. Per saperne di più, consulta Creare attività target HTTP nella documentazione di Cloud Tasks.

Gmail

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