Gestione dei trigger

Puoi utilizzare vari metodi per gestire i trigger utilizzando la console Google Cloud o Google Cloud CLI.

Elenca trigger

Puoi elencare, filtrare e ordinare gli attivatori in tutte le località.

Console

1. Nella console Google Cloud, vai alla pagina Trigger di Eventarc.

   Vai ai trigger

   Elenca tutti i trigger nel progetto per tutte le località e include dettagli come nome del trigger, regione, provider di eventi, destinazione e tipo di evento.

2. Per filtrare gli attivatori in base a una proprietà specifica:

   1. Fai clic sulla casella Filtro.
   2. Nell'elenco delle Proprietà, seleziona un'opzione per filtrare gli attivatori, ad esempio Nome o Canale evento.

   Puoi selezionare una singola proprietà o utilizzare l'operatore logico OR per aggiungere altre proprietà in base a cui filtrare.

3. Per ordinare gli attivatori, fai clic su Ordina accanto all'intestazione di colonna appropriata.

   È possibile ordinare solo alcune colonne, ad esempio Nome, Regione o Canale evento.

gcloud

gcloud eventarc triggers list --location=-

Questo comando elenca il nome, il tipo, la destinazione e lo stato del trigger in tutte le località.

Descrivi un attivatore

Puoi descrivere un attivatore in una località specifica.

Console

1. Nella console Google Cloud, vai alla pagina Trigger di Eventarc.

   Vai ai trigger

2. Nell'elenco degli attivatori, fai clic su quello di cui vuoi conoscere i dettagli.

La pagina Dettagli trigger mostra i dettagli dell'attivatore, come nome, regione, provider di eventi, tipo di evento, tipo di contenuto dei dati sugli eventi e destinazione.

gcloud

gcloud eventarc triggers describe TRIGGER \
--location=LOCATION

Sostituisci quanto segue:

• TRIGGER: l'ID del trigger o un identificatore completo.
• LOCATION: la posizione del trigger Eventarc.

Questo comando restituisce informazioni sul trigger simili alle seguenti:

  createTime: '2023-03-16T13:40:44.889670204Z'
  destination:
    cloudRun:
      path: /
      region: us-central1
      service: hello
  eventDataContentType: application/protobuf
  eventFilters:
  - attribute: serviceName
    value: cloudscheduler.googleapis.com
  - attribute: methodName
    value: google.cloud.scheduler.v1.CloudScheduler.DeleteJob
  - attribute: type
    value: google.cloud.audit.log.v1.written
  name: projects/project-name/locations/us-central1/triggers/name-of-trigger
  serviceAccount: [e-mail]
  transport:
    pubsub:
      subscription: projects/project-name/subscriptions/eventarc-us-central1-name-of-trigger-sub-034
      topic: projects/project-name/topics/eventarc-us-central1-name-of-trigger-931

Se la condizione del trigger indica un problema con l'argomento Pub/Sub, consulta la sezione Il trigger non pubblica eventi.

Aggiorna un attivatore

Puoi aggiornare un trigger per le destinazioni Cloud Run, Google Kubernetes Engine (GKE) e Workflows.

Console

1. Nella console Google Cloud, vai alla pagina Trigger di Eventarc.

   Vai ai trigger

2. Nell'elenco degli attivatori, fai clic su quello di cui vuoi conoscere i dettagli.

3. Nella pagina Dettagli attivatore, fai clic su Modifica.

4. Modifica i campi come richiesto e fai clic su Salva.

   Tieni presente che non puoi aggiornare i campi Provider di eventi, Evento, Argomento Cloud Pub/Sub, Bucket, Regione e Destinazione evento. Per ulteriori informazioni sui campi, consulta le istruzioni della console relative a provider, tipo di evento e destinazione specifici.

gcloud

Cloud Run

gcloud eventarc triggers update TRIGGER \
    --location=LOCATION \
    --event-filters=NEW_EVENT_FILTERS \
    --service-account=NEW_SERVICE_ACCOUNT \
    --destination-run-region=NEW_REGION \
    --destination-run-service=NEW_SERVICE \
    --destination-run-path=NEW_PATH \
    --event-data-content-type="NEW_EVENT_DATA_TYPE"

Sostituisci quanto segue:

• TRIGGER: l'ID del trigger o un identificatore completo.
• LOCATION: la posizione del trigger Eventarc.

Puoi aggiornare i seguenti elementi:

• NEW_EVENT_FILTERS: il filtro utilizzato per configurare il routing degli eventi dell'attivatore; ad esempio, methodName=storage.objects.create può essere aggiornato a methodName=storage.objects.delete. Tieni presente che, dopo aver creato un trigger, il filtro eventi type non può essere modificato. Per un tipo di evento diverso, devi creare un nuovo trigger.
• NEW_SERVICE_ACCOUNT: l'indirizzo email dell'account di servizio Identity and Access Management (IAM) associato all'attivatore.
• NEW_REGION: la regione in cui si trova il servizio Cloud Run di destinazione.
• NEW_SERVICE: il nome del servizio Cloud Run che riceve gli eventi per il trigger.
• NEW_PATH: il percorso relativo nel servizio Cloud Run di destinazione a cui devono essere inviati gli eventi per il trigger.
• NEW_EVENT_DATA_TYPE: la codifica del payload dell'evento; a seconda del provider di eventi, può essere application/json o application/protobuf.

Ad esempio, per aggiornare l'account di servizio per un trigger:

gcloud eventarc triggers update my-cloud-run-trigger \
    --service-account=new-serviceaccount@${PROJECT_ID}.iam.gserviceaccount.com

Questo comando aggiorna l'account di servizio di un trigger denominato my-cloud-run-trigger in new-serviceaccount@PROJECT_ID.iam.gserviceaccount.com.

GKE

Questo prodotto o funzionalità è soggetto ai "Termini delle Offerte pre-GA" nella sezione Termini generali del servizio dei Termini specifici del servizio. I prodotti e le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per saperne di più, consulta le descrizioni della fase di lancio.

Tieni presente che questa sezione si applica anche agli endpoint pubblici dei servizi privati e pubblici in esecuzione in un cluster GKE.

gcloud eventarc triggers update TRIGGER \
    --location=LOCATION \
    --destination-gke-namespace=NEW_NAMESPACE \
    --destination-gke-service=NEW_SERVICE \
    --destination-gke-path=NEW_PATH \
    --event-data-content-type="NEW_EVENT_DATA_TYPE"

Sostituisci quanto segue:

• TRIGGER: l'ID del trigger o un identificatore completo.
• LOCATION: la località del trigger Eventarc.

Puoi aggiornare i seguenti elementi:

• NEW_NAMESPACE: lo spazio dei nomi in cui è in esecuzione il servizio GKE di destinazione.
• NEW_SERVICE: il nome del servizio GKE che riceve gli eventi per il trigger.
• NEW_PATH: il percorso relativo del servizio GKE di destinazione a cui devono essere inviati gli eventi per il trigger.
• NEW_EVENT_DATA_TYPE: la codifica del payload dell'evento; a seconda del provider di eventi, può essere application/json o application/protobuf.

Ad esempio, per aggiornare il servizio di ricezione di eventi per un trigger:

gcloud eventarc triggers update my-gke-trigger \
    --destination-gke-service=helloworld-events

Questo comando aggiorna il servizio di ricezione di eventi per un trigger denominato my-gke-trigger in un servizio GKE denominato helloworld-events.

Workflows

gcloud eventarc triggers update TRIGGER
    --location=LOCATION \
    --event-filters=NEW_EVENT_FILTERS \
    --service-account=NEW_SERVICE_ACCOUNT \
    --destination-workflow=NEW_DESTINATION_WORKFLOW \
    --destination-workflow-location=NEW_DESTINATION_WORKFLOW_LOCATION \
    --event-data-content-type="NEW_EVENT_DATA_TYPE"

Sostituisci quanto segue:

• TRIGGER: l'ID del trigger o un identificatore completo.
• LOCATION: la località del trigger Eventarc.

Puoi aggiornare i seguenti elementi:

• NEW_EVENT_FILTERS: il filtro utilizzato per configurare il routing degli eventi dell'attivatore; ad esempio, methodName=storage.objects.create può essere aggiornato a methodName=storage.objects.delete. Tieni presente che, una volta creato un trigger, il filtro eventi type non può essere modificato. Per un tipo di evento diverso, devi creare un nuovo trigger.
• NEW_SERVICE_ACCOUNT: l'indirizzo email dell'account di servizio Identity and Access Management (IAM) associato all'attivatore.
• NEW_DESTINATION_WORKFLOW: l'ID del flusso di lavoro di cui è stato eseguito il deployment che riceve gli eventi dal trigger.
• NEW_DESTINATION_WORKFLOW_LOCATION: la località in cui viene eseguito il deployment del flusso di lavoro di destinazione.
• NEW_EVENT_DATA_TYPE: la codifica del payload dell'evento; a seconda del provider di eventi, può essere application/json o application/protobuf.

Ad esempio, per aggiornare l'account di servizio per un trigger:

gcloud eventarc triggers update my-workflows-trigger \
    --service-account=new-serviceaccount@${PROJECT_ID}.iam.gserviceaccount.com

Questo comando aggiorna l'account di servizio di un trigger denominato my-workflows-trigger in new-serviceaccount@PROJECT_ID.iam.gserviceaccount.com.

Elimina un trigger

Importante: l'eliminazione di un trigger elimina anche qualsiasi nuovo argomento Pub/Sub creato inizialmente da Eventarc al momento della creazione del trigger.

Puoi eliminare un attivatore.

Console

1. Nella console Google Cloud, vai alla pagina Trigger di Eventarc.

   Vai ai trigger

2. Seleziona l'attivatore e fai clic su Elimina.

gcloud

gcloud eventarc triggers delete TRIGGER

Sostituisci TRIGGER con l'ID dell'attivatore o un identificatore completo.

Passaggi successivi

• Creare un attivatore per un provider, un tipo di evento e una destinazione specifici