Gerenciar gatilhos

Visualizar

As instruções do console do Google Cloud para destinos do Google Kubernetes Engine (GKE) e do Workflows são cobertas pelos Termos de ofertas pré-GA dos Termos de Serviço do Google Cloud. Os produtos pré-GA podem ter suporte limitado, e as mudanças realizadas podem não ser compatíveis com outras versões pré-GA. Para mais informações, consulte as descrições da fase de lançamento.

O Eventarc tem vários métodos para gerenciar acionadores usando o Console do Google Cloud ou a Google Cloud CLI.

Excluir um gatilho

Importante: a exclusão de um gatilho também exclui qualquer novo tópico do Pub/Sub que foi criado inicialmente pelo Eventarc na criação do gatilho.

É possível excluir um gatilho.

Console

1. No console, acesse a página Gatilhos do Eventarc.

   Acessar o Eventarc
2. Selecione o gatilho e clique em Excluir.

gcloud

gcloud eventarc triggers delete TRIGGER

Substitua TRIGGER pelo ID do gatilho ou um identificador totalmente qualificado.

Listar gatilhos

É possível listar, filtrar e classificar os acionadores em todos os locais.

Console

• Para listar todos os gatilhos, no console, acesse a página Gatilhos do Eventarc.

  Acessar o Eventarc

  Esse comando lista o nome, a região, o provedor de eventos, as informações de destino e o tipo de gatilho em todos os locais.

• Para filtrar seus gatilhos por nome, região ou data de criação:
  1. Clique na caixa de texto Filtrar .
  2. Na lista de Propriedades, selecione uma opção para filtrar os acionadores.

  É possível selecionar uma única propriedade ou usar o operador lógico OR para adicionar mais propriedades e filtrar.

• Para classificar seus gatilhos por nome, região ou data de criação, clique em Classificar ao lado de Name, Region e Created.

gcloud

gcloud eventarc triggers list --location=-

Esse comando lista o nome, o tipo, o destino e o status do acionador em todos os locais.

Descrever um gatilho

Descreva um acionador em um local específico.

Console

1. No console, acesse a página Gatilhos do Eventarc.

   Acessar o Eventarc
2. Na lista de gatilhos, clique nos gatilhos sobre os quais você quer saber os detalhes.

A página Detalhes do gatilho exibe os detalhes do gatilho, como nome, provedor de eventos, condição e destino.

gcloud

gcloud eventarc triggers describe TRIGGER \
--location=LOCATION

Substitua:

• TRIGGER: o ID do gatilho ou um identificador totalmente qualificado.
• LOCATION: o local do gatilho do Eventarc.

Esse comando retorna as seguintes informações sobre o gatilho:

• Horário de criação do gatilho
• Detalhes do destino do gatilho
• Critérios correspondentes, como filtros de evento
• Nome do gatilho
• Condição do gatilho
• E-mail da conta de serviço associada ao gatilho
• Detalhes da camada de transporte, como assinatura do Pub/Sub e nomes de tópico.

Se a condição do gatilho indicar um problema com o tópico do Pub/Sub, consulte O gatilho não está entregando eventos.

Atualizar um gatilho

É possível atualizar um gatilho para destinos do Cloud Run, Google Kubernetes Engine (GKE) e Workflows.

Console

1. No console, acesse a página Gatilhos do Eventarc.

   Acessar o Eventarc
2. Na lista de gatilhos, clique nos gatilhos sobre os quais você quer saber os detalhes.
3. Na página de detalhes da política, clique em Editar.
4. Edite os campos conforme necessário e clique em Salvar.

   Não é possível atualizar o Provedor de eventos, o Evento, o tópico do Cloud Pub/Sub, o Bucket: Campos Region e Event destination. Para mais informações sobre os campos, consulte Criar gatilhos usando o Console do Google Cloud.

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

Substitua:

• TRIGGER: o ID do gatilho ou um identificador totalmente qualificado.
• LOCATION: o local do gatilho do Eventarc.

Você pode atualizar qualquer um dos seguintes itens:

• NEW_EVENT_FILTERS: o filtro usado para configurar o roteamento de eventos do gatilho; por exemplo, type=google.cloud.pubsub.topic.v1.messagePublished.
• NEW_SERVICE_ACCOUNT: o e-mail da conta de serviço do gerenciamento de identidade e acesso (IAM) associado ao gatilho.
• NEW_REGION: a região em que o serviço de destino do Cloud Run pode ser encontrado.
• NEW_SERVICE: o nome do serviço do Cloud Run que recebe os eventos do gatilho.
• NEW_PATH: o caminho relativo no serviço de destino do Cloud Run para o qual os eventos do gatilho devem ser enviados.

Por exemplo, para atualizar o gatilho com uma nova conta de serviço:

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

Esse comando atualiza um gatilho chamado cal-events-trigger com uma conta de serviço, new-serviceaccount@PROJECT_ID.iam.gserviceaccount.com.

Kubernetes Engine

Visualização

Este produto é coberto pelos Termos de ofertas pré-GA dos Termos de Serviço do Google Cloud. Os produtos pré-GA podem ter suporte limitado, e as mudanças realizadas podem não ser compatíveis com outras versões pré-GA. Para mais informações, consulte as descrições da fase de lançamento.

Esta seção também se aplica a destinos do Cloud Run for Anthos.

gcloud eventarc triggers update TRIGGER \
  --location=LOCATION \
  --destination-gke-namespace=NEW_NAMESPACE \
  --destination-gke-service=NEW_SERVICE \
  --destination-gke-path=NEW_PATH

Substitua:

• TRIGGER: o ID do gatilho ou um identificador totalmente qualificado.
• LOCATION: o local do gatilho do Eventarc.

Você pode atualizar qualquer um dos seguintes itens:

• NEW_NAMESPACE: o namespace em que o serviço do GKE de destino está em execução.
• NEW_SERVICE: o nome do serviço do GKE que recebe os eventos do gatilho.
• NEW_PATH: o caminho relativo no serviço de destino do GKE para onde os eventos do acionador precisam ser enviados.

Por exemplo, para atualizar o gatilho com um novo serviço:

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

Esse comando atualiza um gatilho chamado cal-events-trigger com um novo serviço do GKE chamado, helloworld-events, que recebe os eventos do gatilho.

Workflows

Visualização

Este produto é coberto pelos Termos de ofertas pré-GA dos Termos de Serviço do Google Cloud. Os produtos pré-GA podem ter suporte limitado, e as mudanças realizadas podem não ser compatíveis com outras versões pré-GA. Para mais informações, consulte as descrições da fase de lançamento.

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

Substitua:

• TRIGGER: o ID do gatilho ou um identificador totalmente qualificado.
• LOCATION: o local do gatilho do Eventarc.

Você pode atualizar qualquer um dos seguintes itens:

• NEW_EVENT_FILTERS: o filtro usado para configurar o roteamento de eventos do gatilho; por exemplo, type=google.cloud.pubsub.topic.v1.messagePublished.
• NEW_SERVICE_ACCOUNT: o e-mail da conta de serviço do gerenciamento de identidade e acesso (IAM) associado ao gatilho.
• NEW_DESTINATION_WORKFLOW: o ID do fluxo de trabalho implantado que recebe os eventos do gatilho.
• NEW_DESTINATION_WORKFLOW_LOCATION: o local em que o fluxo de trabalho de destino é implantado.

Por exemplo, para atualizar o gatilho com uma nova conta de serviço:

gcloud eventarc triggers update cal-workflows-trigger \
  --service-account="${TRIGGER_SA}@${PROJECT_ID}.iam.gserviceaccount.com"

Esse comando atualiza um gatilho chamado cal-workflows-trigger com uma conta de serviço, new-serviceaccount@PROJECT_ID.iam.gserviceaccount.com.

Informações relacionadas

• Criar gatilhos usando o Console do Google Cloud
• Crie um gatilho para um serviço do Cloud Run usando a CLI do Google Cloud
• Crie um gatilho para um serviço do GKE usando a Google Cloud CLI
• Crie um gatilho para os fluxos de trabalho usando a CLI do Google Cloud