Attivatore con eventi

Puoi creare un trigger Eventarc in modo che il servizio Cloud Run riceva le notifiche di un evento specifico o di un insieme di eventi. Specificando i filtri per il trigger, puoi configurare il routing dell'evento, inclusi 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 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. Ogni trigger Eventarc è associato a un account di servizio Identity and Access Management (IAM) al momento della creazione del trigger. Puoi specificare un account di servizio gestito dall'utente che il trigger utilizza come identità predefinita. 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 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 del tuo progetto Google Cloud. Puoi trovare il tuo 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 Dettagli 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, vedi Opzioni di routing degli eventi.

  6. Segui le istruzioni per creare un trigger per un provider, un tipo di evento e una destinazione specifici e consulta le istruzioni della console nella sezione "Crea 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'email dell'account di servizio IAM associata al trigger. Per le destinazioni Cloud Run, questo account di servizio viene utilizzato per generare token di identità quando si richiama il servizio.

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

    Questo è il percorso relativo sul 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