Attivatore con eventi

Puoi creare un trigger Eventarc in modo che il servizio Cloud Run riceva le notifiche relative a un evento o a un insieme di eventi specificati. Specificando i filtri per il trigger, puoi configurare il routing dell'evento, tra cui l'origine evento e il servizio Cloud Run di destinazione.

Gli eventi inviati al servizio Cloud Run vengono ricevuti sotto forma di richieste HTTP.

I seguenti tipi di eventi attivano richieste al tuo servizio:

Questa pagina mostra come creare un trigger tramite la pagina della console di Cloud Run.

Puoi anche creare un trigger Eventarc utilizzando Google Cloud CLI o la pagina della console Eventarc. Segui le istruzioni per creare un trigger per un provider, un tipo di evento e una destinazione specifici.

Preparati a creare un trigger

Prima di creare un trigger, completa questi prerequisiti:

  1. Eventarc utilizza un account di servizio fornito dal cliente come identità del trigger. Assicurati di concedere i ruoli e le autorizzazioni richiesti all'account di servizio del trigger.

    Ad esempio, per inviare eventi a un servizio Cloud Run che richiede l'autenticazione, l'account di servizio per il trigger Eventarc deve avere il ruolo Identity and Access Management (IAM) Invoker di Cloud Run.

  2. Se stai creando un trigger per un evento diretto da Cloud Storage, concedi il ruolo pubsub.publisher all'account di servizio Cloud Storage:

    SERVICE_ACCOUNT="$(gsutil kms serviceaccount -p PROJECT_ID)"

gcloud projects add-iam-policy-binding PROJECT_ID \
    --member="serviceAccount:${SERVICE_ACCOUNT}" \
    --role='roles/pubsub.publisher'

    Sostituisci PROJECT_ID con l'ID progetto Google Cloud. Puoi trovare l'ID progetto nella pagina Ti diamo il benvenuto della console Google Cloud.

Crea un trigger tramite la console

Puoi utilizzare la pagina della console Cloud Run per creare un trigger Eventarc.

  1. Se necessario, abilita l'API Eventarc.

    Abilitare l'API

  2. Nella console Google Cloud, vai a Cloud Run.

    Vai a Cloud Run

  3. Nell'elenco dei servizi, fai clic su un servizio esistente o creane uno nuovo.

  4. Nella pagina dei dettagli del servizio, fai clic sulla scheda Trigger.

  5. Fai clic su Aggiungi trigger Eventarc.

    Si apre il riquadro Trigger Eventarc. Per determinare il modo migliore per instradare gli eventi, consulta Opzioni di routing degli eventi.

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

  7. Seleziona l'Account di servizio che richiama il tuo servizio Cloud Run.

    In alternativa, crea un nuovo account di servizio.

    Specifica l'indirizzo email dell'account di servizio IAM associato al trigger. Per le destinazioni Cloud Run, questo account di servizio viene utilizzato per generare token di identità quando si chiama il servizio.

  8. (Facoltativo) Specifica il Percorso URL del servizio a cui inviare la richiesta in entrata.

    Questo è il percorso relativo nel servizio di destinazione a cui devono essere inviati gli eventi per il trigger. Ad esempio: /, /route, route, route/subroute.

  9. Dopo aver creato il trigger, verificane l'integrità assicurandoti che sia presente un segno di spunta nella scheda Trigger.

Passaggi successivi