Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Receber eventos diretos do Cloud Storage (console)

Neste guia de início rápido, mostramos como receber eventos diretos do Cloud Storage em um serviço não autenticado do Cloud Run.

Conclua este guia de início rápido usando o console. Para receber instruções usando a Google Cloud CLI,, consulte Receber eventos usando os Registros de auditoria do Cloud (CLI gcloud).

Neste guia de início rápido, você fará as seguintes tarefas:

  1. Criar um bucket do Cloud Storage para ser uma origem do evento.

  2. Implantar um serviço de receptor de eventos no Cloud Run

  3. Criar um gatilho do Eventarc para filtrar e rotear eventos.

  4. Gerar um evento fazendo upload de um arquivo no bucket do Cloud Storage e visualizar o evento nos registros do Cloud Run.


Para receber orientações sobre esta tarefa diretamente no Console, clique em Orientações:

Orientações


As seções a seguir guiam você pelas mesmas etapas que você encontra clicando em Orientações.

Antes de começar

Algumas das etapas deste documento podem não funcionar corretamente se sua organização aplicar restrições ao ambiente do Google Cloud. Nesse caso, talvez não seja possível concluir tarefas como criar endereços IP públicos ou chaves de contas de serviço. Se você fizer uma solicitação que retorne um erro sobre restrições, veja como Desenvolver aplicativos em um ambiente restrito do Google Cloud.

  1. Faça login na sua conta do Google Cloud. Se você começou a usar o Google Cloud agora, crie uma conta para avaliar o desempenho de nossos produtos em situações reais. Clientes novos também recebem US$ 300 em créditos para executar, testar e implantar cargas de trabalho.
  2. No console do Google Cloud, na página do seletor de projetos, selecione ou crie um projeto do Google Cloud.

    Acessar o seletor de projetos

  3. Verifique se o faturamento está ativado para seu projeto na nuvem. Saiba como verificar se o faturamento está ativado em um projeto.

  4. Ative as APIs Cloud Build and Eventarc.

    Ative as APIs

  5. No console do Google Cloud, na página do seletor de projetos, selecione ou crie um projeto do Google Cloud.

    Acessar o seletor de projetos

  6. Verifique se o faturamento está ativado para seu projeto na nuvem. Saiba como verificar se o faturamento está ativado em um projeto.

  7. Ative as APIs Cloud Build and Eventarc.

    Ative as APIs

crie um bucket do Cloud Storage

No guia de início rápido, usamos o Cloud Storage como origem do evento.

  1. No console, acesse o Cloud Storage.

    Acesse o Cloud Storage

  2. Clique em Criar bucket.

    Novo bucket

  3. Digite um Nome exclusivo para o bucket. Por exemplo, helloworld-bucket.

  4. Clique em Continuar.

  5. Em Tipo de local, selecione Região e, em seguida, us-central1 (Iowa).

  6. Aceite os outros padrões.

  7. Clique em Criar.

Depois que a origem do evento é criada, implante o serviço de receptor de eventos no Cloud Run.

Implantar o serviço de receptor de eventos no Cloud Run

Implante um serviço do Cloud Run que recebe e registra eventos.

  1. Para clonar o repositório de exemplo na sua conta do GitHub, siga estas instruções:

    Go

    1. No GitHub, acesse GoogleCloudPlatform/golang-samples.

    2. Clique em Bifurcar.

      Captura de tela do botão de divisão

    3. Se solicitado, selecione o local em que você quer clonar o repositório.

    Java

    1. No GitHub, acesse GoogleCloudPlatform/java-docs-samples.

    2. Clique em Bifurcar.

      Captura de tela do botão de divisão

    3. Se solicitado, selecione o local em que você quer clonar o repositório.

    .NET

    1. No GitHub, acesse GoogleCloudPlatform/dotnet-docs-samples.

    2. Clique em Bifurcar.

      Captura de tela do botão de divisão

    3. Se solicitado, selecione o local em que você quer clonar o repositório.

    Node.js

    1. No GitHub, acesse GoogleCloudPlatform/nodejs-docs-samples.

    2. Clique em Bifurcar.

      Captura de tela do botão de divisão

    3. Se solicitado, selecione o local em que você quer clonar o repositório.

    Python

    1. No GitHub, acesse GoogleCloudPlatform/python-docs-samples.

    2. Clique em Bifurcar.

      Captura de tela do botão de divisão

    3. Se solicitado, selecione o local em que você quer clonar o repositório.

  2. No console, acesse o Cloud Run.

    Acesse o Cloud Run

  3. Clique em Criar serviço.

  4. No formulário Criar serviço, selecione Implantar continuamente novas revisões a partir de um repositório de origem.

  5. Clique em Configurar com o Cloud Build.

  6. No formulário Configurar com o Cloud Build, conclua as seguintes etapas:

    Configurar com a página do Cloud Build

    1. Se solicitado, ative a API Cloud Build.
    2. Na lista Repository Provider, selecione GitHub.

    3. Na lista Repository, selecione o repositório do GitHub que você bifurcou.

    4. Depois de selecionar a conta e o repositório do GitHub, marque a caixa de seleção para aceitar os termos da exoneração de responsabilidade de consentimento e clique em Próxima.

    5. Deixe o campo Ramificação como ^main$.

    6. Em Tipo de build, selecione Dockerfile e forneça o local de origem do Dockerfile:

      eventarc/audit-storage/Dockerfile
      

      No exemplo em Go:

      eventarc/audit_storage/Dockerfile
      
    7. Clique em Save.

  7. No formulário Criar serviço, digite um nome de serviço. Por exemplo, helloworld-events.

  8. Aceite o padrão Região como seu local de serviço. Por exemplo, us-central1(Iowa).

  9. Aceite os padrões de alocação e preço de CPU e escalonamento automático.

  10. Na seção Entrada, selecione Permitir todo o tráfego.

  11. Na seção Autenticação, selecione Permitir invocações não autenticadas.

  12. Clique em Criar.

Criar um gatilho do Eventarc

O gatilho do Eventarc envia eventos do bucket do Cloud Storage para o serviço helloworld-events do Cloud Run.

  1. No console, acesse o Eventarc.

    Acessar o Eventarc

  2. Clique em Criar gatilho.

  3. Digite um Nome de acionador.

    Por exemplo, helloworld-trigger

  4. Na lista Provedor de eventos, selecione Fontes do Google > Cloud Storage.

  5. Na lista Evento, selecione Direto > google.cloud.storage.object.v1.finalized de dados.

  6. Para Bucket, especifique o bucket do Cloud Storage helloworld-bucket que você criou anteriormente.

  7. Se solicitado, conceda o seguinte:

    • Papel iam.serviceAccountTokenCreator para a conta de serviço do Pub/Sub
    • Papel pubsub.publisher para a conta de serviço do Cloud Storage
  8. Use a conta de serviço de computação padrão como a conta de serviço que invoca o serviço.

  9. Na lista Destino do evento, selecione Cloud Run.

  10. Para o serviço Cloud Run, selecione o serviço helloworld-events criado anteriormente.

  11. Clique em Criar.

Gerar e visualizar um evento

Gere um evento e confirme se o gatilho do Eventarc está funcionando conforme o esperado.

  1. Para gerar um evento:

    1. Crie um arquivo de texto com o nome random.txt e o texto "Hello World".

    2. No console, acesse o Cloud Storage.

      Acesse o Cloud Storage

    3. Clique no nome do bucket de armazenamento que você criou.

    4. Na guia Objetos, clique em Fazer upload de arquivos e faça o upload do arquivo random.txt.

    O upload gera um evento e o serviço do Cloud Run registra a mensagem do evento.

  2. Para visualizar a entrada de registro:

    1. No console, acesse o Cloud Run.

      Acesse o Cloud Run

    2. Clique no nome do serviço que você criou.

    3. Para recuperar as entradas de registro de todas as revisões desse serviço, clique na guia Registros na página Detalhes do serviço. É possível filtrar por nível de gravidade do registro.

    4. Procure uma entrada de registro semelhante a esta:

      Received event of type google.cloud.storage.object.v1.finalized. Event data: [...]

Parabéns! Você implantou com sucesso um serviço de receptor de eventos no Cloud Run, criou um gatilho do Eventarc, gerou um evento a partir do Cloud Storage e o visualizou nos registros do Cloud Run.

Limpeza

Para evitar cobranças na sua conta do Google Cloud pelos recursos usados nesta página, siga estas etapas.

O Cloud Run não gera custos quando o serviço não está em uso, mas ainda é possível receber cobranças por armazenamento da imagem de contêiner no Container Registry, recursos do Cloud Run e armazenamento de arquivos no bucket do Cloud Storage.

É possível excluir a imagem, excluir o bucket de armazenamento e excluir o serviço.

Para excluir o gatilho do Eventarc, siga estas etapas:

  1. No console, acesse o Eventarc.

    Acessar o Eventarc

  2. Clique no nome do gatilho que você criou.

  3. Na página Detalhes do gatilho, clique em Excluir.

Se preferir, exclua o projeto do Google Cloud para evitar cobranças. A exclusão do projeto do Cloud interrompe o faturamento de todos os recursos usados nele.

  1. No Console do Google Cloud, acesse a página Gerenciar recursos.

    Acessar "Gerenciar recursos"

  2. Na lista de projetos, selecione o projeto que você quer excluir e clique em Excluir .
  3. Na caixa de diálogo, digite o ID do projeto e clique em Encerrar para excluí-lo.

A seguir