Puoi utilizzare un trigger Eventarc per eseguire un flusso di lavoro come risultato di un evento o di un insieme di eventi. Gli eventi vengono indirizzati da un fornitore di eventi ai destinatari interessati.
Eventarc invia gli eventi al ricevitore eventi nel formato CloudEvents tramite una richiesta HTTP. Il servizio Workflows converte l'evento in un oggetto JSON (secondo la specifica CloudEvents) e passa l'evento all'esecuzione del flusso di lavoro come argomento di runtime del flusso di lavoro.
Viene attivata un'esecuzione del flusso di lavoro:
- Quando viene creato un log di controllo che corrisponde ai criteri del filtro del trigger. Ad esempio, consulta questa guida rapida in cui attivare Workflows con eventi da BigQuery utilizzando Cloud Audit Logs.
- In risposta a eventi diretti come l'aggiornamento di un bucket Cloud Storage o di un modello Firebase Remote Config. Ad esempio, consulta questa guida rapida in cui puoi attivare Workflows con eventi diretti da Cloud Storage.
- Per messaggi pubblicati in un argomento Pub/Sub. Ad esempio, consulta questa guida rapida in cui puoi attivare Workflows con messaggi Pub/Sub.
Tieni presente quanto segue:
Gli eventi vengono considerati pubblicati non appena inizia l'esecuzione del flusso di lavoro e l'esecuzione effettiva avviene in modo asincrono nei servizi Workflows.
Le esecuzioni attivate dagli eventi non vengono tentate di nuovo se l'esecuzione del flusso di lavoro viene avviata, ma in seguito non riesce. Per maggiori informazioni, consulta il criterio relativo ai nuovi tentativi degli eventi.
La finestra di deduplicazione di Workflows per garantire che l'elaborazione "exactly-once" degli eventi sia di 24 ore.
Quando utilizzi Workflows come destinazione per un trigger Eventarc, gli eventi di dimensioni superiori alla dimensione massima dell'argomento Workflows non attiveranno le esecuzioni del flusso di lavoro. Per saperne di più, consulta Quote e limiti.
Nei progetti protetti da un perimetro di servizio, quando si instradano eventi alle destinazioni di Workflows per cui l'endpoint push di Pub/Sub è impostato su un'esecuzione di Workflows, puoi solo creare nuove sottoscrizioni push di Pub/Sub tramite Eventarc. Tieni presente che l'account di servizio utilizzato per l'autenticazione push per l'endpoint di Workflows deve essere incluso nel perimetro di servizio. Per ulteriori informazioni, consulta Configurare un perimetro di servizio utilizzando Controlli di servizio VPC.
Crea un trigger utilizzando Google Cloud CLI
Puoi creare un trigger eseguendo un comando gcloud eventarc triggers create insieme ai flag obbligatori e facoltativi.
Per ulteriori informazioni, consulta le istruzioni di gcloud nella sezione "Crea un trigger" durante la creazione di un trigger per un provider, un tipo di evento e una destinazione di Workflows specifici.
Crea un trigger utilizzando la console
I passaggi seguenti mostrano come creare un trigger nella pagina Workflows nella console Google Cloud.
Prima di iniziare
-
Abilita le API Eventarc and Pub/Sub.
Crea un account di servizio in modo che Eventarc possa effettuare richieste all'API Workflows:
Nella console Google Cloud, vai alla pagina Account di servizio.
Seleziona un progetto e fai clic su Crea account di servizio.
Nel campo Nome account di servizio, inserisci un nome compreso tra 6 e 30 caratteri.
Può contenere caratteri alfanumerici minuscoli e trattini. Dopo aver creato un account di servizio, non puoi modificarne il nome.
Fai clic su Crea e continua.
Concedi al nuovo account di servizio il ruolo workflows.invoker in modo che l'account abbia l'autorizzazione per attivare il tuo flusso di lavoro. Nell'elenco Seleziona un ruolo, seleziona Workflows > Workflows Invoker.
Se stai sviluppando un'app di produzione, concedi sempre i ruoli meno permissivi possibili. Per maggiori informazioni, consulta Gestire l'accesso a progetti, cartelle e organizzazioni.
Fai clic su Fine.
Per consentire all'entità che eseguirà i comandi Eventarc di agire come account di servizio Identity and Access Management (IAM), concedi un ruolo che consenta all'entità di impersonare l'account di servizio.
Configura il trigger
Se non hai già un flusso di lavoro da attivare, creane uno ed eseguine il deployment.
Nella console Google Cloud, vai alla pagina Workflows:
Nella pagina Workflows, seleziona un flusso di lavoro per passare alla relativa pagina dei dettagli.
Nella pagina Dettagli flusso di lavoro, fai clic su edit Modifica.
Nella pagina Modifica flusso di lavoro, seleziona Aggiungi nuovo trigger > Eventarc.
Si apre il riquadro Trigger Eventarc.
Segui le istruzioni per creare un trigger per un provider, un tipo di evento e unaWorkflows destinazione specifici e consulta le istruzioni della console nella sezione "Crea un trigger".
Seleziona l'Account di servizio che richiama il tuo flusso di lavoro.
Questo specifica l'account di servizio IAM a cui hai concesso in precedenza il ruolo
workflows.invokerin modo che l'account disponga dell'autorizzazione per attivare il flusso di lavoro.Fai clic su Salva trigger.
Il trigger Eventarc è elencato nella scheda Trigger della pagina Dettagli dei flussi di lavoro.
Se vuoi aggiornare o eliminare il trigger, devi modificare il flusso di lavoro:
- Nella pagina Dettagli flusso di lavoro, fai clic su edit Modifica.
- Nella sezione Trigger, trova l'attivatore che vuoi aggiornare o eliminare.
- Fai clic su edit Modifica risorsa o delete Elimina risorsa.
L'esecuzione del flusso di lavoro viene ora attivata dagli eventi che corrispondono ai criteri di filtro del trigger.
Crea un trigger utilizzando Terraform
Puoi creare un trigger per un flusso di lavoro utilizzando Terraform. Per maggiori dettagli, consulta Attivare un flusso di lavoro utilizzando Eventarc e Terraform.