Attivare un flusso di lavoro con eventi o messaggi Pub/Sub

Puoi utilizzare un trigger Eventarc per eseguire un flusso di lavoro in seguito a un evento o a un insieme di eventi. Gli eventi vengono instradati da un provider di eventi ai ricevitori di eventi interessati.

Eventarc invia gli eventi al destinatario di eventi nel formato CloudEvents tramite una richiesta HTTP. Il servizio Workflows converte l'evento in un oggetto JSON (in base alla specifica CloudEvents) e lo passa all'esecuzione del workflow come argomento di runtime del workflow.

Viene attivata un'esecuzione del workflow:

  • Quando viene creato un log di controllo che corrisponde ai criteri di filtro del trigger. Ad esempio, consulta questa guida rapida in cui attivi Workflows con eventi da BigQuery utilizzando Cloud Audit Logs.
  • In risposta a eventi diretti come un aggiornamento di un bucket Cloud Storage o un aggiornamento di un modello Firebase Remote Config. Ad esempio, consulta questa guida rapida in cui attivi Workflows con eventi diretti da Cloud Storage.
  • Tramite i messaggi pubblicati in un argomento Pub/Sub. Ad esempio, consulta questa guida rapida in cui attivi Workflows con i messaggi Pub/Sub.

Tieni presente quanto segue:

  • Gli eventi vengono considerati consegnati non appena inizia l'esecuzione del workflow e l'esecuzione effettiva avviene in modo asincrono nei servizi Workflows.

  • Le esecuzioni attivate da eventi non vengono ritentate se l'esecuzione del workflow inizia, ma non va a buon fine. Per saperne di più, consulta le norme sui tentativi di ripetizione degli eventi.

  • La finestra di deduplicazione 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, gli eventi più grandi delle dimensioni massime dell'argomento Workflows non attiveranno le esecuzioni del flusso di lavoro. Per ulteriori informazioni, consulta Quote e limiti.

  • Nei progetti protetti da un perimetro di servizio, quando indirizzi gli eventi alle destinazioni Workflows per le quali l'endpoint push Pub/Sub è impostato su un'esecuzione di Workflows, puoi creare nuove sottoscrizioni push Pub/Sub solo tramite Eventarc. Tieni presente che il account di servizio utilizzato per l'autenticazione push per l'endpoint Workflows deve essere incluso nel perimetro di servizio. Per maggiori informazioni, consulta Configura un perimetro di servizio utilizzando i 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 gcloud nella sezione "Crea un trigger" quando crei un trigger per un fornitore, un tipo di evento e una destinazione Workflows specifici.

Crea un trigger utilizzando la console

I seguenti passaggi mostrano come creare un trigger nella pagina Workflows della console Google Cloud .

Prima di iniziare

  1. Enable the Eventarc and Pub/Sub APIs.

    Enable the APIs

  2. Crea un service account in modo che Eventarc possa effettuare richieste all'API Workflows:

    1. Nella console Google Cloud , vai alla pagina Service Accounts.

      Vai a Service account

    2. Seleziona un progetto e poi fai clic su Crea service account.

    3. Nel campo Nome service account, inserisci un nome compreso tra 6 e 30 caratteri.

      Può contenere caratteri alfanumerici minuscoli e trattini. Una volta creato un account di servizio, non puoi modificarne il nome.

    4. Fai clic su Crea e continua.

    5. Concedi al nuovo account di servizio il ruolo workflows.invoker in modo che l'account abbia l'autorizzazione per attivare il workflow. Nell'elenco Seleziona un ruolo, seleziona Workflows > Invoker di Workflows.

      Se stai sviluppando un'app di produzione, concedi sempre i ruoli meno permissivi possibili. Per saperne di più, consulta la pagina Gestire l'accesso a progetti, cartelle e organizzazioni.

    6. Fai clic su Fine.

  3. Per consentire all'entità che eseguirà i comandi Eventarc di agire come service account Identity and Access Management (IAM), concedi un ruolo che consenta all'entità di rappresentare il service account.

Configurare il trigger

  1. Se non hai già un flusso di lavoro che vuoi attivare, creane e implementane uno.

  2. Nella console Google Cloud , vai alla pagina Flussi di lavoro:

    Vai a Flussi di lavoro

  3. Nella pagina Workflows, seleziona un workflow per andare alla pagina dei dettagli.

  4. Nella pagina Dettagli del flusso di lavoro, fai clic su Modifica.

  5. Nella pagina Modifica flusso di lavoro, seleziona Aggiungi nuovo trigger > Eventarc.

    Viene visualizzato il riquadro Trigger Eventarc.

  6. Segui le istruzioni per creare un trigger per un fornitore, un tipo di evento e una Workflows destinazione specifici e consulta le istruzioni della console nella sezione "Creare un trigger".

  7. Seleziona l'account di servizio che richiama il flusso di lavoro.

    Specifica il account di servizio IAM a cui hai precedentemente concesso il ruolo workflows.invoker, in modo che l'account abbia l'autorizzazione per attivare il workflow.

  8. Fai clic su Salva trigger.

    Il trigger Eventarc è elencato nella scheda Trigger della pagina Dettagli workflow.

  9. Se vuoi aggiornare o eliminare il trigger, devi modificare il workflow:

    1. Nella pagina Dettagli del flusso di lavoro, fai clic su Modifica.
    2. Nella sezione Attivatori, individua l'attivatore che vuoi aggiornare o eliminare.
    3. Fai clic su Modifica risorsa o 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 i dettagli, vedi Attivare un flusso di lavoro utilizzando Eventarc e Terraform.

Passaggi successivi