Trigger Eventarc

Un trigger Eventarc abilita una funzione che deve essere attivata da qualsiasi tipo di evento supportato Eventarc. Se specifichi Eventarc trigger per una funzione; tu fornisci i filtri di eventi. Il tuo verrà richiamata ogni volta che si verifica un evento corrispondente ai filtri.

Le funzioni basate su eventi in Cloud Functions utilizzano Trigger Eventarc. Per ulteriori informazioni, vedi Trigger Eventarc nella documentazione di Eventarc. Per un elenco degli eventi supportati di Google, consulta Tipi di eventi supportati da Eventarc.

Per utilizzare un trigger Eventarc, una funzione deve essere implementata come Funzione CloudEvent. I dati dell'evento vengono passati alla funzione nel Formato CloudEvents, con un payload di dati CloudEvent corrispondenti al tipo di evento. La Google Eventi contiene risorse aggiuntive per l'uso dei dati sugli eventi.

Località trigger

I trigger Eventarc sono collegati a determinati locations. In generale, la posizione di un trigger Eventarc deve corrispondere alla località del e la risorsa di cui vuoi monitorare gli eventi. Nella maggior parte degli scenari, anche il deployment della Cloud Function nella stessa regione. Consulta Informazioni sulle località Eventarc per maggiori dettagli sulle località dei trigger Eventarc.

Identità trigger

I trigger Eventarc sono collegati agli account di servizio per essere utilizzati come quando richiami la tua funzione. Il trigger Eventarc un account di servizio deve avere per richiamare la funzione. Per impostazione predefinita, Account di servizio Compute predefinito .

Deployment

Puoi specificare un trigger Eventarc quando esegui il deployment di una funzione. Consulta Deployment di una funzione Cloud Functions per informazioni generali istruzioni su come eseguire il deployment di una funzione. Questa sezione descrive come configurare un trigger Eventarc che chiama una funzione quando un evento che corrispondono ai filtri si verificano durante il deployment.

gcloud

Se con gcloud CLI, i flag mostrati vengono usati per configurare i trigger Eventarc:

gcloud functions deploy YOUR_FUNCTION_NAME \
  --gen2 \
  --trigger-event-filters="type=EVENTARC_FILTER_TYPE" \
  [--trigger-event-filters=EVENTARC_EVENT_FILTER] \
  [--trigger-event-filters-path-pattern=EVENTARC_EVENT_PATH_PATTERN] \
  [--trigger-location=EVENTARC_TRIGGER_LOCATION] \
  [--trigger-service-account=EVENTARC_TRIGGER_SERVICE_ACCOUNT] \
  [--retry] \
...
  • Il flag --gen2 specifica che stai eseguendo il deployment in Cloud Functions (2nd gen). Devi usare Cloud Functions (2nd gen) per utilizzare Trigger Eventarc.

  • La --trigger-event-filters specifica i filtri di eventi che verranno monitorati dal trigger. Un evento che corrisponde a tutti i filtri attiverà le chiamate alla tua funzione.

    • Obbligatorio: ogni attivatore deve avere un tipo di evento supportato nel formato --event-filters="type=EVENTARC_FILTER_TYPE". Questo tipo di evento non può essere modificato dopo la creazione. Per modificare EVENT_FILTER_TYPE, crea un nuovo trigger ed elimina quello vecchio.
    • (Facoltativo) Puoi ripetere il flag --trigger-event-filters con un filtro supportato nel modulo ATTRIBUTE=VALUE per aggiungere altri filtri.

  • La --trigger-event-filters-path-pattern specifica i filtri di eventi che il trigger monitorerà nel percorso formato pattern. Il filtro deve essere nel formato ATTRIBUTE=VALUE. Consulta Comprendi i pattern dei percorsi per saperne di più informazioni.

  • La --trigger-location specifica una posizione per il trigger Eventarc. Consulta Posizione trigger per ulteriori informazioni. In caso contrario specificata, la regione della funzione viene utilizzata come località del trigger.

  • La --trigger-service-account specifica un account di servizio da usare come identità Trigger Eventarc. Consulta Identità trigger per ulteriori informazioni.

  • La Controlli flag --retry se le chiamate di funzione non riuscite vengono ritentate automaticamente. Consulta Ripetere le funzioni basate su eventi per ulteriori informazioni.

Se stai creando un trigger per un Pub/Sub diretto o per l'evento Cloud Storage, fai riferimento alle istruzioni dell'interfaccia a riga di comando gcloud configurare un Pub/Sub e Trigger di Cloud Storage, rispettivamente.

La documentazione di Eventarc contiene esempi di come specificare filtri per diversi tipi di eventi. Per ulteriori informazioni, segui le istruzioni quando creando un trigger per un provider, un tipo di evento e una destinazione specifici.

Console

Se tramite la console Google Cloud, devi selezionare 2a generazione come ambiente. Quindi puoi configurare Trigger Eventarc nella sezione Trigger.

  1. Per aggiungere un attivatore di evento, fai clic su Aggiungi attivatore. Vengono visualizzate le le seguenti opzioni:

    • Trigger di Pub/Sub
    • Trigger di Cloud Storage
    • Trigger di Firestore
    • Altro trigger

    Quando scegli una di queste opzioni, il riquadro Trigger Eventarc dove puoi specificare i dettagli dell'attivatore.

    Se stai creando un trigger per un Pub/Sub diretto o Evento Cloud Storage, consulta la console Google Cloud istruzioni per configurare Pub/Sub e Cloud Storage trigger rispettivamente.

  2. Se scegli Altro attivatore, utilizza il campo Tipo di attivatore nella Riquadro Trigger Eventarc per specificare una delle origini Google, Personalizzato o Di terze parti.

    • Con Origini Google puoi specificare trigger per Pub/Sub, Cloud Storage, Firestore e altri eventi Google di Google Cloud. 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 quindi l'evento che da usare come trigger.

    • L'opzione Personalizzato ti consente di produrre e utilizzare eventi dal tuo il codice dell'applicazione. Segui i prompt nel riquadro Trigger Eventarc per creare un canale. Un canale è una risorsa utilizzata come pipeline per fornire servizi più eventi dai produttori ai consumatori. Gli eventi personalizzati vengono pubblicati e un trigger Eventarc esegue l'iscrizione a questi eventi.

    • L'opzione Di terze parti ti consente di eseguire l'integrazione con fornitori non Google. che offrono un'origine Eventarc. Consulta eventi di terze parti in Eventarc per maggiori dettagli.

  3. Nel campo Regione, seleziona una località per Eventarc , se applicabile. Vedi Località trigger per ulteriori informazioni.

  4. Facoltativamente, nel campo Account di servizio, seleziona un account di servizio per come identità del trigger Eventarc. Consulta Per ulteriori informazioni, attiva l'identità.

  5. 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.

  6. Fai clic su Salva trigger.

Passaggi successivi