Encaminhe eventos do Cloud Storage para fluxos de trabalho

Padrão

Um acionador do Eventarc declara o seu interesse num determinado evento ou conjunto de eventos. Pode configurar o encaminhamento de eventos especificando filtros para o acionador, incluindo a origem do evento e o fluxo de trabalho de destino.

Os eventos são entregues no formato CloudEvents através de um pedido HTTP. O serviço Workflows converte o evento num objeto JSON (seguindo a especificação CloudEvents) e passa o evento para a execução do fluxo de trabalho como um argumento de tempo de execução do fluxo de trabalho. Certifique-se de que o tamanho do evento não excede 512 KB. Os eventos superiores ao tamanho máximo dos argumentos dos fluxos de trabalho não acionam execuções de fluxos de trabalho.

Estas instruções mostram como configurar o encaminhamento de eventos para que uma execução do fluxo de trabalho seja acionada em resposta a um eventoCloud Storage direto. Isto aplica-se a um fornecedor de eventos do Cloud Storage. Para mais detalhes, consulte a lista de eventos diretos suportados.

Nota: se os eventos de registo direto e de auditoria forem suportados para um fornecedor Google, recomendamos que crie um acionador que filtre o evento direto. Os eventos diretos oferecem várias vantagens em relação aos eventos de registo de auditoria. Para mais informações, consulte o artigo Encaminhamentos de eventos.

Prepare-se para criar um acionador

Antes de criar um acionador do Eventarc para um fluxo de trabalho de destino, conclua as seguintes tarefas.

Consola

1. Na Google Cloud consola, na página do seletor de projetos, selecione ou crie um Google Cloud projeto.

   Nota: se não planeia manter os recursos que criar neste procedimento, crie um projeto em vez de selecionar um projeto existente. Depois de concluir estes passos, pode eliminar o projeto, removendo todos os recursos associados ao projeto.

   Aceder ao seletor de projetos

2. Ative as APIs Eventarc, Eventarc Publishing, Workflows e Workflow Executions.

   Ative as APIs

3. Se aplicável, ative a API relacionada com os eventos diretos. Por exemplo, para eventos, ative a APICloud Storage . Cloud Storage

4. Se ainda não tiver uma, crie uma conta de serviço gerida pelo utilizador e, em seguida, conceda-lhe as funções e as autorizações necessárias para que o Eventarc possa gerir eventos para um fluxo de trabalho de destino.

   1. Na Google Cloud consola, aceda à página Contas de serviço.

      Aceda a Contas de serviço

   2. Selecione o seu projeto.

   3. No campo Nome da conta de serviço, introduza um nome. A Google Cloud consola preenche o campo ID da conta de serviço com base neste nome.

      No campo Descrição da conta de serviço, introduza uma descrição. Por exemplo, Service account for event trigger.

   4. Clique em Criar e continuar.

   5. Para conceder o acesso adequado, na lista Selecionar uma função, selecione as funções de gestão de identidade e de acesso (IAM) necessárias para conceder à sua conta de serviço. Para mais informações, consulte o artigo Funções e autorizações para alvos de fluxos de trabalho.

      Para funções adicionais, clique em Adicionar outra função e adicione cada função adicional.

   6. Clique em Continuar.

   7. Para concluir a criação da conta, clique em Concluído.

5. Conceda a função de publicador do Pub/Sub ao agente de serviço do Cloud Storage. Normalmente, este valor é de [e-mail]. Pode obter o endereço de email do agente do serviço Cloud Storage.

   1. Na Google Cloud consola, aceda à página IAM.

      Aceda ao IAM

   2. Na linha do agente do serviço Cloud Storage, clique em Editar principal. (Se o agente de serviços não estiver listado, avance para o passo seguinte.) É aberto o painel Editar acesso.

      1. Clique em Adicionar outra função e, de seguida, pesquise a função Publicador do Pub/Sub.
      2. Selecione a função.
      3. Clique em Guardar.

   3. Se o agente de serviços não estiver na lista, clique em Conceder acesso. O painel Conceder acesso é aberto.

      1. No campo Novos membros, introduza o endereço de email do agente de serviço.
      2. Na lista Selecionar uma função, pesquise a função Publicador do Pub/Sub.
      3. Selecione a função.
      4. Clique em Guardar.

gcloud

1. In the Google Cloud console, activate Cloud Shell.

   Activate Cloud Shell

   At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

2. Ative as APIs Eventarc, Eventarc Publishing, Workflows e Workflow Executions:

   gcloud services enable eventarc.googleapis.com \
       eventarcpublishing.googleapis.com \
       workflows.googleapis.com \
       workflowexecutions.googleapis.com

3. Se aplicável, ative a API relacionada com os eventos diretos. Por exemplo, para Cloud Storage eventos, ative storage.googleapis.com.

4. Se ainda não tiver uma, crie uma conta de serviço gerida pelo utilizador e, em seguida, conceda-lhe as funções e as autorizações necessárias para que o Eventarc possa gerir eventos para um fluxo de trabalho de destino.

   1. Crie a conta de serviço:

      gcloud iam service-accounts create SERVICE_ACCOUNT_NAME

      Substitua SERVICE_ACCOUNT_NAME pelo nome da conta de serviço. Tem de ter entre 6 e 30 carateres e pode conter carateres alfanuméricos em minúsculas e traços. Depois de criar uma conta de serviço, não pode alterar o respetivo nome.

   2. Conceda as funções ou as autorizações da gestão de identidade e de acesso (IAM) necessárias. Para mais informações, consulte o artigo Funções e autorizações para alvos de fluxos de trabalho.

5. Se estiver a criar um acionador para um evento direto do Cloud Storage, conceda a função pubsub.publisher à conta de serviço do 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"
   

Crie um acionador

Pode criar um acionador do Eventarc com um fluxo de trabalho implementado como o recetor de eventos através da CLI Google Cloud (gcloud ou Terraform) ou através da consola Google Cloud .

Nota: a filtragem é feita através de uma correspondência exata e não suporta carateres universais nem expressões regulares.

Consola

1. Na Google Cloud consola, aceda à página Triggers do Eventarc.

   Aceda a Acionadores

2. Clique em Criar acionador.
3. Escreva um Nome do acionador.

   Este é o ID do acionador e tem de começar com uma letra. Pode conter até 63 letras minúsculas, números ou hífenes.

4. Para o Tipo de acionador, selecione Fontes Google.
5. Na lista Fornecedor de eventos, selecione Cloud Storage.

   Tenha em atenção que o nome do fornecedor de eventos usado na Google Cloud documentação associada pode não ter um prefixo de Cloud ou Google Cloud. Por exemplo, na consola, o Memorystore for Redis é denominado Google Cloud Memorystore for Redis.

6. Na lista Tipo de evento, nos eventos Direto, selecione um tipo de evento:
   • google.cloud.storage.object.v1.archived: o evento é enviado quando uma versão ativa de um objeto se torna uma versão não atual. Para mais informações, consulte o artigo Controlo de versões de objetos.
   • google.cloud.storage.object.v1.delete: o evento é enviado quando um objeto é eliminado temporariamente. Para mais informações, consulte o artigo Eliminação temporária.
   • google.cloud.storage.object.v1.finalized: o evento é enviado quando é criado um novo objeto (ou um objeto existente é substituído e é criada uma nova geração desse objeto) no contentor.
   • google.cloud.storage.object.v1.metadataUpdated: o evento é enviado quando os [metadados](/storage/docs/metadata) de um objeto existente mudam.
7. Na lista Tipo de conteúdo dos dados de eventos, selecione a codificação do payload do evento.

   Para eventos diretos de Cloud Storage, este tem de ser application/json.

8. Especifique ou procure o identificador exclusivo global do contentor do Cloud Storage.

   O contentor do Cloud Storage tem de residir no mesmo Google Cloud projeto e região ou região múltipla que o acionador do Eventarc.

9. Selecione uma região.

   Os acionadores do Cloud Storage para o Eventarc estão disponíveis em localizações de região única, de duas regiões e multirregionais. Tenha em atenção que o contentor do Cloud Storage tem de residir no mesmo Google Cloud projeto e região ou multirregião que o acionador do Eventarc.

   Os eventos são enviados através de notificações do Pub/Sub do Cloud Storage. A configuração de demasiadas notificações registadas no mesmo contentor pode esgotar o limite de notificações do contentor, conforme indicado pelo erro Cloud Storage bucket ...: Pub/Sub notification limit reached. O contentor pode ter até 10 configurações de notificações definidas para serem acionadas para um evento específico. Consulte mais quotas e limitações na página de quotas e limites do Cloud Storage .

10. Selecione a conta de serviço que vai invocar o seu serviço ou fluxo de trabalho.

    Em alternativa, pode criar uma nova conta de serviço.

    Isto especifica o email da conta de serviço de gestão de identidade e de acesso (IAM) associado ao acionador e ao qual concedeu anteriormente funções específicas necessárias pelo Eventarc.

11. Na lista Destino do evento, selecione Workflows.
12. Selecione um fluxo de trabalho.
    

    Este é o nome do fluxo de trabalho para o qual os eventos são transmitidos. Os eventos de uma execução do fluxo de trabalho são transformados e transmitidos ao fluxo de trabalho como argumentos de tempo de execução.

    Para mais informações, consulte o artigo Crie um acionador para fluxos de trabalho.

13. Opcionalmente, para adicionar uma etiqueta, pode clicar em Adicionar etiqueta. As etiquetas são pares de chave-valor que ajudam a organizar os seus Google Cloud recursos. Para mais informações, consulte o artigo O que são etiquetas?
14. Clique em Criar.

Depois de criar um acionador, não é possível modificar os filtros da origem do evento. Em alternativa, crie um novo acionador e elimine o antigo. Para mais informações, consulte o artigo Faça a gestão dos acionadores.

gcloud

gcloud eventarc triggers create TRIGGER \
    --location=LOCATION \
    --destination-workflow=DESTINATION_WORKFLOW  \
    --destination-workflow-location=DESTINATION_WORKFLOW_LOCATION \
    --event-filters="type=EVENT_FILTER_TYPE" \
    --event-filters="bucket=BUCKET" \
    --service-account="MY_SERVICE_ACCOUNT@PROJECT_ID.iam.gserviceaccount.com"

Substitua o seguinte:

• TRIGGER: o ID do acionador ou um identificador totalmente qualificado.
• LOCATION: a localização do acionador do Eventarc e disponível em localizações de região única, região dupla e multirregião; não pode criar um acionador do globalEventarc. Tenha em atenção que o contentor do Cloud Storage tem de estar no mesmo Google Cloud projeto e região que o acionador do Eventarc. Para mais informações, consulte o artigo Localizações do Eventarc.
• DESTINATION_WORKFLOW: o ID do fluxo de trabalho implementado que recebe os eventos do acionador. O fluxo de trabalho pode estar em qualquer uma das localizações suportadas e não tem de estar na mesma localização que o acionador. No entanto, o fluxo de trabalho tem de estar no mesmo projeto que o acionador.
• DESTINATION_WORKFLOW_LOCATION (opcional): a localização em que o fluxo de trabalho de destino é implementado. Se não for especificado, assume-se que o fluxo de trabalho está na mesma localização que o acionador.
• EVENT_FILTER_TYPE: o identificador do evento do Cloud Storage e pode ser um dos seguintes:
  • google.cloud.storage.object.v1.finalized: o evento é enviado quando um novo objeto é criado (ou um objeto existente é substituído e é criada uma nova geração desse objeto) no contentor
  • google.cloud.storage.object.v1.archived: o evento é enviado quando uma versão em direto de um objeto se torna uma versão não atual. Para mais informações, consulte o artigo Controlo de versões de objetos.
  • google.cloud.storage.object.v1.deleted: o evento é enviado quando um objeto é eliminado de forma reversível. Para mais informações, consulte o artigo Eliminação temporária.
  • google.cloud.storage.object.v1.metadataUpdated: o evento é enviado quando os metadados de um objeto existente mudam.
• BUCKET: o identificador exclusivo a nível global do contentor do Cloud Storage.
• SERVICE_ACCOUNT_NAME: o nome da conta de serviço do IAM que criou à qual concedeu funções específicas exigidas pelos Workflows.
• PROJECT_ID: o ID do seu Google Cloud projeto

Notas:

• Para eventos diretos de Cloud Storage, a codificação do payload do evento é application/json.
• Estas flags são obrigatórias:
  • --event-filters="type=EVENT_FILTER_TYPE"
  • --event-filters="bucket=BUCKET"
• Depois de criar um acionador, não é possível alterar o EVENT_FILTER_TYPE. Para um tipo de evento diferente, tem de criar um novo acionador.
• --service-account: O email da conta de serviço de IAM que o acionador do Eventarc vai usar para invocar as execuções do fluxo de trabalho. Recomendamos vivamente que use uma conta de serviço com o mínimo de privilégios necessários para aceder aos recursos necessários. Para saber mais sobre as contas de serviço, consulte o artigo Crie e faça a gestão de contas de serviço.
• Os eventos são enviados através de notificações do Pub/Sub do Cloud Storage. A configuração de demasiadas notificações registadas no mesmo contentor pode esgotar o limite de notificações do contentor, conforme indicado pelo erro Cloud Storage bucket ...: Pub/Sub notification limit reached. O contentor pode ter até 10 configurações de notificações definidas para serem acionadas para um evento específico. Consulte mais quotas e limitações na página de quotas e limites do Cloud Storage.
• Cada acionador pode ter vários filtros de eventos, separados por vírgulas numa flag --event-filters=[ATTRIBUTE=VALUE,...] ou pode repetir a flag para adicionar mais filtros. Apenas os eventos que correspondem a todos os filtros são enviados para o destino. Os carateres universais e as expressões regulares não são suportados.
• O contentor do Cloud Storage tem de residir no mesmo Google Cloud projeto e região ou multirregião que o acionador do Eventarc.
• Por predefinição, as subscrições do Pub/Sub criadas para o Eventarc persistem independentemente da atividade e não expiram. Para alterar a duração da inatividade, consulte o artigo Propriedades da subscrição.

Exemplo:

gcloud eventarc triggers create helloworld-trigger \
    --location=us-central1 \
    --destination-workflow=my-workflow \
    --destination-workflow-location=europe-west4 \
    --event-filters="type=google.cloud.storage.object.v1.finalized" \
    --event-filters="bucket=my-project-bucket" \
    --service-account="${SERVICE_ACCOUNT_NAME}@${PROJECT_ID}.iam.gserviceaccount.com"

Este comando cria um acionador denominado helloworld-trigger para o contentor do Cloud Storage my-project-bucket e o evento identificado como google.cloud.storage.object.v1.finalized.

Terraform

Pode criar um acionador para um fluxo de trabalho com o Terraform. Para ver detalhes, consulte o artigo Acione um fluxo de trabalho com o Eventarc e o Terraform.

Nota: embora o acionador seja criado imediatamente, pode demorar até dois minutos para que um acionador se propague e filtre eventos.

Crie uma lista de um acionador

Pode confirmar a criação de um acionador listando os acionadores do Eventarc através da CLI do Google Cloud ou da Google Cloud consola.

Consola

1. Na Google Cloud consola, aceda à página Triggers do Eventarc.

   Aceda a Acionadores

   Esta página lista os seus acionadores em todas as localizações e inclui detalhes como nomes, regiões, fornecedores de eventos, destinos e muito mais.

2. Para filtrar os acionadores:

   1. Clique em Filtro ou no campo Acionadores de filtro.
   2. Na lista Propriedades, selecione uma opção para filtrar os acionadores.

   Pode selecionar uma única propriedade ou usar o operador lógico OR para adicionar mais propriedades.

3. Para ordenar os acionadores, junto ao título de qualquer coluna suportada, clique em Ordenar.

gcloud

Execute o seguinte comando para listar os seus acionadores:

gcloud eventarc triggers list --location=-

Este comando lista os seus acionadores em todas as localizações e inclui detalhes como nomes, tipos, destinos e estados.

O que se segue?

• Acione um fluxo de trabalho com o Eventarc e o Terraform

• Acione fluxos de trabalho com eventos do Cloud Storage

• Acione fluxos de trabalho com mensagens do Pub/Sub

• Saiba mais sobre o Eventarc