Attivare con gli eventi

Eventarc è un servizio Google Cloud che ti consente di creare architetture basate sugli eventi senza dover implementare, personalizzare o gestire l'infrastruttura di base.

Puoi creare un trigger Eventarc specificando i filtri per l'trigger e configurando il routing dell'evento, inclusa l'origine dell'evento e il servizio Cloud Run di destinazione. Quando l'evento o di eventi che corrispondono ai filtri, questo fa sì che il tuo servizio Cloud Run da richiamare automaticamente in risposta agli eventi.

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 per un servizio tramite pagina della console Cloud Run. Per istruzioni simili su come creare un un trigger per una funzione, vedi Eseguire il deployment delle funzioni in Cloud Run.

Puoi anche creare un trigger Eventarc utilizzando Google Cloud CLI o tramite la pagina della console Eventarc. Per istruzioni su come creare un attivatore per un provider, un tipo di evento e una destinazione specifici, filtra l'elenco per scoprire di più su Fornitori e destinazioni di eventi di Eventarc.

Prima di iniziare

Prima di creare un trigger con Eventarc, comprendi il ruoli richiesti per l'identità trigger.

  1. Abilita l'API Eventarc.

    Abilitare l'API

  2. Ogni attivatore Eventarc è associato a un account di servizio Identity and Access Management (IAM) al momento della sua creazione. Questo account di servizio è noto come attiva account di servizio, e viene utilizzato per richiamare l'API Eventarc. Ad esempio, per inviare eventi a un servizio Cloud Run che richiede l'autenticazione, assicurati che all'identità del trigger sia concessa IAM Invoker di Cloud Run (roles/run.invoker).

  3. 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="$(gcloud storage service-agent --project=PROJECT_ID)"

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

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

Crea un trigger

Dopo aver eseguito il deployment del servizio, puoi utilizzare la pagina della console Cloud Run per creare un trigger Eventarc.

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

    Vai a Cloud Run

  2. Nell'elenco dei servizi, fai clic su un servizio esistente o creane uno nuovo completamente gestito di Google Cloud.

  3. Nella pagina Dettagli servizio, fai clic sulla scheda Trigger.

  4. 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.

  5. Segui le istruzioni per creare un trigger per un provider, un tipo di evento e destinazione e consulta le istruzioni della console nella sezione "Creare un trigger" .

  6. Seleziona l'account di servizio che richiama il servizio Cloud Run o crea un nuovo account di servizio.

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

  7. (Facoltativo) Specifica il Percorso URL del servizio per inviare i messaggi in entrata a cui inviare la richiesta.

    Si tratta del percorso relativo sul servizio di destinazione a cui vengono inviati gli eventi l'attivatore deve essere inviato. Ad esempio: /, /route, route, route/subroute.

  8. Dopo aver creato l'attivatore, verificane l'integrità assicurandoti che sia presente un segno di spunta nella scheda Attivatori.

Passaggi successivi