Puoi utilizzare un trigger Eventarc per eseguire un flusso di lavoro come il risultato di un evento o di un insieme di eventi. Gli eventi vengono instradati da un fornitore di eventi ai ricevitori evento interessati.
Eventarc invia gli eventi al ricevitore di eventi nel formato CloudEvents tramite una richiesta HTTP. Il servizio Workflows converte l'evento in un oggetto JSON (secondo la specifica CloudEvents) e lo passa 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 attivi i flussi di lavoro con eventi di BigQuery utilizzando Cloud Audit Logs.
- In risposta a eventi diretti come un aggiornamento a Cloud Storage. un bucket Cloud Storage o un aggiornamento a un modello Firebase Remote Config. Ad esempio, vedi di questa guida rapida in cui attiverai Workflows con da Cloud Storage.
- Per messaggi pubblicati in un argomento Pub/Sub. Ad esempio, consulta questo quickstart in cui attivi i flussi di lavoro con messaggi Pub/Sub.
Tieni presente quanto segue:
Gli eventi vengono considerati inviati non appena inizia l'esecuzione del flusso di lavoro e l'esecuzione effettiva avviene in modo asincrono nei servizi Workflows.
Le esecuzioni attivate da eventi non vengono ripetute se l'esecuzione del flusso di lavoro inizia, ma in seguito non va a buon fine. Per ulteriori informazioni, consulta Criterio per i nuovi tentativi degli eventi.
La finestra di deduplica dei flussi di lavoro per garantire l'elaborazione esattamente una volta degli eventi è di 24 ore.
Quando utilizzi Workflows come destinazione per un Trigger Eventarc, eventi maggiori del limite massimo La dimensione dell'argomento di Workflows non attiverà le esecuzioni del flusso di lavoro. Per ulteriori informazioni, consulta Quote e limiti.
Nei progetti protetti da un perimetro di servizio, durante l'instradamento degli eventi le destinazioni Workflows per cui endpoint push è impostato su un'esecuzione di Workflows, puoi solo e creare nuove sottoscrizioni push di Pub/Sub 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, vedi Configurare un perimetro di servizio utilizzando Controlli di servizio VPC.
Creare un trigger utilizzando Google Cloud CLI
Puoi creare un trigger eseguendo un comando gcloud eventarc triggers create insieme a flag obbligatori e facoltativi.
Per ulteriori informazioni, consulta le istruzioni di gcloud nella sezione "Creare un attivatore" quando crei un attivatore 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 attivatore nella Pagina Flussi di lavoro nella console Google Cloud.
Prima di iniziare
-
Enable the Eventarc and Pub/Sub APIs.
Crea un account di servizio in modo che Eventarc possa inviare richieste all'API Workflows:
Nella console Google Cloud, vai alla pagina Account di servizio.
Seleziona un progetto, quindi 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 bassi. Dopo aver creato un account di servizio, non puoi modificarne il nome.
Fai clic su Crea e continua.
Concedi al tuo nuovo account di servizio workflows.invoker in modo che dispone dell'autorizzazione per attivare il flusso di lavoro. Nell'elenco Seleziona un ruolo, seleziona Workflow > Avvocato di workflow.
Se stai sviluppando un'app di produzione, assegna sempre i ruoli meno permissivi possibili. Per ulteriori informazioni, vedi Gestire l'accesso a progetti, cartelle e organizzazioni.
Fai clic su Fine.
Consenti l'entità che eseguirà il tuo Eventarc consente di agire come servizio IAM (Identity and Access Management) l'account di servizio, concedi un ruolo che consenta all'entità di impersonare l'account di servizio.
Configura l'attivatore
Se non hai già un flusso di lavoro che vuoi attivare, crearne ed eseguirne il deployment.
Nella console Google Cloud, vai alla pagina Workflows:
Nella pagina Workflows, seleziona un flusso di lavoro per visualizzarne i 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 Workflows destinazione e consulta le istruzioni della console nella sezione "Creare un trigger" .
Seleziona l'account di servizio che richiama il flusso di lavoro.
Questo specifica l'account di servizio IAM a cui hai precedentemente concesso il ruolo
workflows.invokerin modo che l'account abbia l'autorizzazione per attivare il flusso di lavoro.Fai clic su Salva trigger.
L'attivatore Eventarc è elencato nella scheda Trigger della pagina Dettagli flussi di lavoro.
Se vuoi aggiornare o eliminare l'attivatore, devi modificare il flusso di lavoro:
- Nella pagina Dettagli del flusso di lavoro, fai clic su edit Modifica.
- Nella sezione Attivatori, trova l'attivatore che vuoi aggiornare. eliminare.
- Fai clic su edit Modifica risorsa oppure delete Elimina risorsa.
L'esecuzione del flusso di lavoro viene ora attivata dagli eventi corrispondenti criteri di filtro.
Crea un trigger utilizzando Terraform
Puoi creare un trigger per un flusso di lavoro utilizzando Terraform. Per maggiori dettagli, vedi Attivare un flusso di lavoro utilizzando Eventarc e Terraform.