Criar gatilhos com o Eventarc

Console

1. Implante seu serviço do Cloud Run usando contêineres ou da origem.

2. No Google Cloud console, acesse o Cloud Run:

   Acesse o Cloud Run

3. Na lista de serviços, clique em um serviço atual.

4. Na página "Detalhes do serviço", acesse a guia Gatilhos.

5. Clique em Adicionar acionador e selecione uma opção.

6. No painel Gatilho do Eventarc, modifique os detalhes do gatilho da seguinte maneira:

   1. No campo Nome do gatilho, digite um nome ou use o nome padrão.

   2. Selecione um Tipo de acionador na lista para especificar um dos seguintes tipos de acionador:

      • Fontes do Google para especificar acionadores para Pub/Sub, Cloud Storage, Firestore, e outros provedores de eventos do Google.

      • Terceiros para integração com provedores que não são do Google que oferecem uma origem do Eventarc. Para mais informações, consulte Eventos de terceiros no Eventarc.

   3. Selecione um provedor de eventos na lista Provedor de eventos para escolher um produto que ofereça o tipo de evento para acionar seu serviço. Para ver a lista de provedores de eventos, consulte Provedores e destinos de eventos.

   4. Selecione um tipo de evento na lista Tipo de evento. A configuração do gatilho varia de acordo com o tipo de evento compatível: Para mais informações, consulte Tipos de eventos.

   5. Se o campo Região estiver ativado, selecione um local para o gatilho do Eventarc. Em geral, o local de um gatilho do Eventarc precisa corresponder ao local do recurso Google Cloud que você quer monitorar para eventos. Na maioria dos cenários, você também precisa implantar o serviço na mesma região. Consulte Noções básicas sobre locais do Eventarc para mais detalhes sobre locais de acionador do Eventarc.

   6. No campo Conta de serviço, selecione uma conta de serviço. Os acionadores do Eventarc são vinculados a contas de serviço para usar como uma identidade ao invocar o serviço. A conta de serviço do acionador do Eventarc precisa ter permissão para invocar o serviço. Por padrão, o Cloud Run usa a conta de serviço padrão do Compute Engine.

   7. Se quiser, especifique o caminho do URL do serviço para enviar a solicitação recebida. Esse é o caminho relativo no serviço de destino para o qual os eventos do gatilho precisam ser enviados. Por exemplo: /, /route, route e route/subroute.

   8. Depois de preencher os campos obrigatórios, clique em Salvar gatilho.

7. Depois de criar o gatilho, verifique a integridade garantindo que haja uma marca de seleção check_circle na guia Gatilhos.

gcloud

1. Implante seu serviço do Cloud Run usando contêineres ou da origem.

2. Execute o comando a seguir para criar um gatilho que filtra eventos:

   gcloud eventarc triggers create TRIGGER_NAME  \
       --location=REGION \
       --destination-run-service=SERVICE  \
       --destination-run-region=REGION \
       --event-filters="EVENT_FILTER" \
       --service-account=PROJECT_NUMBER-compute@developer.gserviceaccount.com
   

   Substitua:

   • TRIGGER_NAME pelo nome do gatilho.

   • EVENTARC_TRIGGER_LOCATION com o local do gatilho do Eventarc. Em geral, o local de um gatilho do Eventarc precisa corresponder ao local do recurso Google Cloud que você quer monitorar para eventos. Na maioria dos cenários, você também precisa implantar o serviço na mesma região. Para mais informações, consulte Locais do Eventarc.

   • SERVICE pelo nome do serviço que você está implantando.

   • REGION pela região do Cloud Run do serviço.

   • PROJECT_NUMBER pelo número do projeto Google Cloud . Os acionadores do Eventarc são vinculados a contas de serviço para usar como uma identidade ao invocar o serviço. A conta de serviço do gatilho do Eventarc precisa ter permissão para invocar o serviço. Por padrão, o Cloud Run usa a conta de serviço de computação padrão.

   • A flag event-filters especifica os filtros de evento que o gatilho monitora. Um evento que corresponde a todos os filtros de event-filters aciona chamadas para seu serviço. Cada gatilho precisa ter um tipo de evento compatível. Não é possível mudar o tipo de filtro de evento depois da criação. Para mudar o tipo de filtro de evento, crie um novo gatilho e exclua o antigo. Opcional: é possível repetir a flag --event-filters com um filtro compatível no formato ATTRIBUTE=VALUE para adicionar mais filtros.

Terraform

Para criar um gatilho do Eventarc para um serviço do Cloud Run, consulte Criar um gatilho usando o Terraform.

Console

Ao usar o console do Google Cloud para criar uma função, você também pode adicionar um gatilho a ela. Siga estas etapas para criar um gatilho para sua função:

1. No Google Cloud console, acesse o Cloud Run:

   Acessar o Cloud Run

2. Clique em Escrever uma função e insira os detalhes dela. Para mais informações sobre como configurar funções durante a implantação, consulte Implantar funções.

3. Na seção Gatilho, clique em Adicionar gatilho.

4. Selecione uma opção.

5. No painel Gatilho do Eventarc, modifique os detalhes do gatilho da seguinte maneira:

   1. Insira um nome para o gatilho no campo Nome do gatilho ou use o nome padrão.

   2. Selecione um Tipo de acionador na lista para especificar um dos seguintes tipos de acionador:

      • Fontes do Google para especificar acionadores para Pub/Sub, Cloud Storage, Firestore, e outros provedores de eventos do Google.

      • Terceiros para integração com provedores que não são do Google que oferecem uma origem do Eventarc. Para mais informações, consulte Eventos de terceiros no Eventarc.

   3. Selecione um provedor de eventos na lista Provedor de eventos para escolher um produto que ofereça o tipo de evento para acionar sua função. Para ver a lista de provedores de eventos, consulte Provedores e destinos de eventos.

   4. Selecione um tipo de evento na lista Tipo de evento. A configuração do gatilho varia de acordo com o tipo de evento compatível: Para mais informações, consulte Tipos de eventos.

   5. Se o campo Região estiver ativado, selecione um local para o gatilho do Eventarc. Em geral, o local de um gatilho do Eventarc precisa corresponder ao local do recurso Google Cloud que você quer monitorar para eventos. Na maioria dos cenários, você também precisa implantar a função na mesma região. Consulte Noções básicas sobre locais do Eventarc para mais detalhes sobre locais de acionador do Eventarc.

   6. No campo Conta de serviço, selecione uma conta de serviço. Os acionadores do Eventarc são vinculados a contas de serviço para usar como uma identidade ao invocar a função. A conta de serviço do acionador do Eventarc precisa ter permissão para invocar a função. Por padrão, o Cloud Run usa a conta de serviço padrão do Compute Engine.

   7. Se quiser, especifique o caminho do URL do serviço para enviar a solicitação recebida. Esse é o caminho relativo no serviço de destino para o qual os eventos do gatilho precisam ser enviados. Por exemplo: /, /route, route e route/subroute.

6. Depois de preencher os campos obrigatórios, clique em Salvar gatilho.

gcloud

Ao criar uma função usando a CLI gcloud, primeiro é necessário implantar a função e, em seguida, criar um gatilho. Siga estas etapas para criar um gatilho para sua função:

1. Execute o seguinte comando no diretório que contém o código de amostra para implantar sua função:

   gcloud run deploy FUNCTION \
           --source . \
           --function FUNCTION_ENTRYPOINT \
           --base-image BASE_IMAGE_ID \
           --region REGION
   

   Substitua:

   • FUNCTION pelo nome da função que você está implantando. É possível omitir esse parâmetro inteiramente, mas será solicitado o nome, se você omiti-lo.

   • FUNCTION_ENTRYPOINT: o ponto de entrada da função no código-fonte. Esse é o código que o Cloud Run executa quando é executada. O valor dessa sinalização precisa ser um nome de função ou de classe totalmente qualificada no código-fonte.

   • BASE_IMAGE_ID com o ambiente de imagem base da sua função. Para mais detalhes sobre as imagens de base e os pacotes incluídos em cada imagem, consulte Imagens de base dos ambientes de execução.

   • REGION com a Google Cloud região em que você quer implantar a função. Por exemplo, us-central1.

2. Execute o comando a seguir para criar um gatilho que filtra eventos:

   gcloud eventarc triggers create TRIGGER_NAME  \
       --location=REGION \
       --destination-run-service=FUNCTION  \
       --destination-run-region=REGION \
       --event-filters="EVENT_FILTER" \
       --service-account=PROJECT_NUMBER-compute@developer.gserviceaccount.com
   

   Substitua:

   • TRIGGER_NAME pelo nome do gatilho.

   • EVENTARC_TRIGGER_LOCATION com o local do gatilho do Eventarc. Em geral, o local de um gatilho do Eventarc precisa corresponder ao local do recurso Google Cloud que você quer monitorar para eventos. Na maioria dos cenários, você também precisa implantar a função na mesma região. Para mais informações, consulte Locais do Eventarc.

   • FUNCTION pelo nome da função que você está implantando.

   • REGION pela região do Cloud Run da função.

   • PROJECT_NUMBER pelo número do projeto Google Cloud . Os acionadores do Eventarc são vinculados a contas de serviço para usar como uma identidade ao invocar a função. A conta de serviço do gatilho do Eventarc precisa ter permissão para invocar a função. Por padrão, o Cloud Run usa a conta de serviço de computação padrão.

   • A flag event-filters especifica os filtros de evento que o gatilho monitora. Um evento que corresponde a todos os filtros de event-filters aciona chamadas para sua função. Cada gatilho precisa ter um tipo de evento compatível. Não é possível mudar o tipo de filtro de evento depois da criação. Para mudar o tipo de filtro de evento, crie um novo gatilho e exclua o antigo. Opcional: é possível repetir a flag --event-filters com um filtro compatível no formato ATTRIBUTE=VALUE para adicionar mais filtros.

Terraform

Para criar um gatilho do Eventarc para uma função do Cloud Run, consulte Criar um gatilho usando o Terraform.

Console

Depois de implantar a função, siga estas etapas para modificar o prazo ack dela:

1. No Google Cloud console, acesse o Cloud Run:

   Acesse o Cloud Run

2. Localize a função que você quer atualizar na lista de serviços e clique nela para abrir os detalhes.

3. Abra a guia Gatilhos.

4. Clique no nome do gatilho para abrir Detalhes do gatilho.

5. Clique no link Tópico para abrir o painel de edição.

6. Clique no nome ID da assinatura para acessar o painel de assinatura e clique em Editar na parte de cima da página.

7. Defina o valor do Prazo de confirmação como 600 e clique em Atualizar para salvar a mudança.

gcloud

Atualize o prazo de ack por acionador para o valor máximo de 600 segundos. Os comandos a seguir fazem referência a variáveis (TRIGGER_NAME e REGION) cujos valores foram definidos nas etapas anteriores.

## Per Cloud Run function:

# Update Ack Deadline to max (600s)
SUBSCRIPTION_ID=$(gcloud eventarc triggers describe "$TRIGGER_NAME" --location $REGION --format json | jq -r '.transport.pubsub.subscription')
gcloud pubsub subscriptions update "$SUBSCRIPTION_ID" --ack-deadline=600

Faça uma atualização em massa em todos os gatilhos de serviço e função para definir os prazos de ack como 600 segundos:

### Match all Cloud Run service triggers and update all deadlines to 600s (max timeout)
### This will change ALL Cloud Run Service and Cloud Run function
TRIGGER_NAMES=($(gcloud eventarc triggers list | awk '/Cloud Run service/ {print $1}'))

if [ ${#TRIGGER_NAMES[@]} -eq 0 ]; then
  echo "No matching triggers found"
fi

for trigger in "${TRIGGER_NAMES[@]}"; do
echo "Updating ack deadline for trigger: $trigger"
SUBSCRIPTION_ID=$(gcloud eventarc triggers describe "$trigger" --location $REGION --format json | jq -r '.transport.pubsub.subscription')

if [ -z "$SUBSCRIPTION_ID" ]; then
    echo "Error: Could not retrieve subscription ID for trigger: $trigger"
    continue # Skip to the next trigger
fi
gcloud pubsub subscriptions update "$SUBSCRIPTION_ID" --ack-deadline=600
echo "Ack deadline updated for subscription: $SUBSCRIPTION_ID"
done