Publicar e receber eventos criando um barramento e uma inscrição (console)

Criar uma sub-rede e ativar o Acesso privado do Google

A menos que você crie uma política organizacional que proíba isso, os novos projetos Google Cloud começam com uma rede de nuvem privada virtual (VPC) padrão (uma rede VPC de modo automático) que tenha uma sub-rede em cada região. As sub-redes têm intervalos de endereços IP associados a elas.

Como você está encaminhando mensagens para um destino do Cloud Run usando um endereço DNS, é necessário ativar o Acesso privado do Google na sub-rede usada no anexo de rede. Caso contrário, não será possível resolver o endereço DNS. Para mais informações sobre redes privadas e o Cloud Run, consulte Receber solicitações de redes VPC.

Crie uma sub-rede na rede padrão do projeto e ative o Acesso privado do Google:

1. No Console do Google Cloud, acesse a página Redes VPC.

   Acessar redes VPC

2. Na lista de redes VPC, clique no nome padrão.

3. Na página Detalhes da rede VPC, clique na guia Sub-redes.

4. Clique em add_box Adicionar sub-rede.

5. No painel Adicionar uma sub-rede, faça o seguinte:

   1. Digite um Nome, por exemplo, my-subnet.
   2. Na lista Região, selecione us-central1.
   3. Insira um intervalo IPv4 principal para a sub-rede, por exemplo, 10.8.0.0/24.
   4. Em Acesso privado do Google, selecione Ativado.
   5. Aceite todos os outros padrões.
   6. Clique em Adicionar.

Os intervalos de IP da sub-rede precisam ser exclusivos e não podem se sobrepor em uma rede VPC ou em uma rede VPC com peering. Para mais informações sobre tipos e intervalos de sub-rede válidos, consulte Sub-redes.

Criar um anexo de rede

Um anexo de rede é um recurso que permite que uma rede VPC do produtor inicie conexões com uma rede VPC do consumidor. Para publicar eventos, o Eventarc Advanced usa o anexo de rede para estabelecer uma conexão com o endpoint hospedado em uma rede VPC.

Crie um anexo de rede na mesma rede e região que contém o endpoint de destino do evento e que aceita automaticamente conexões de qualquer interface do Private Service Connect que se refira ao anexo de rede:

1. No Console do Google Cloud, acesse Private Service Connect.

   Acessar a página "Private Service Connect"

2. Clique na guia Anexos de rede.

3. Clique em add Criar anexo de rede.

4. Digite um Nome, por exemplo, my-network-attachment.

5. Na lista Rede, selecione padrão.

6. Na lista Região, selecione us-central1 (Iowa).

7. Na lista Sub-rede, selecione a sub-rede que você criou anteriormente.

8. Clique em Aceitar conexões automaticamente para todos os projetos

9. Clique em Criar anexo de rede.

Criar um repositório padrão do Artifact Registry

Crie um repositório padrão do Artifact Registry para armazenar a imagem do contêiner.

1. No console do Google Cloud, acesse a página Repositórios.

   Acessar repositórios

2. Clique em add Criar repositório.

3. Digite um Nome, por exemplo, my-repo.

   Para cada local de repositório em um projeto, os nomes dos repositórios precisam ser exclusivos.

4. Em Formato do repositório, selecione Docker.

5. Na lista Região, selecione us-central1 (Iowa).

6. Aceite todos os outros padrões.

7. Clique em Criar.

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

Implante um serviço do Cloud Run que registre o conteúdo de um evento. Esse serviço só é acessível em redes VPC do mesmo projeto, e o URL do serviço não é acessível diretamente porque ele só permite invocações autenticadas.

1. No terminal, clone o repositório do GitHub:

   git clone https://github.com/GoogleCloudPlatform/eventarc-samples.git

2. Mude para o diretório que contém o código de amostra do Cloud Run:

   cd eventarc-samples/eventarc-advanced-quickstart/

3. Crie uma imagem de contêiner do Docker e envie a imagem para o repositório:

   gcloud builds submit \
       --tag $REGION-docker.pkg.dev/PROJECT_ID/REPOSITORY/log-events:v1

   Substitua REPOSITORY pelo nome do repositório do Artifact Registry.

4. Implante a imagem do contêiner no Cloud Run:

   1. No console do Google Cloud, acesse a página do Cloud Run.

      Acesse o Cloud Run

   2. Clique em add_box Implantar contêiner > Serviço.

   3. Selecione Implantar uma revisão de uma imagem de contêiner atual.

   4. No URL da imagem do contêiner, clique em Selecionar para especificar a imagem do contêiner do Artifact Registry que você criou anteriormente.

   5. Também é possível mudar o nome do serviço, por exemplo, para my-service.

   6. Na lista Região, selecione us-central1 (Iowa).

   7. Em Autenticação, selecione Exigir autenticação.

   8. Em Entrada, selecione Interno.

   9. Aceite todos os outros padrões.

   10. Clique em Criar e aguarde a conclusão da implantação.

Criar um barramento do Eventarc Advanced

Um barramento recebe mensagens de eventos de uma origem de mensagens ou publicadas por um provedor e atua como um roteador de mensagens.

Para mais informações, consulte Criar um bus para encaminhar mensagens.

1. No console do Google Cloud, acesse a página Eventarc > Bus.

   Acessar "Bus"

2. Clique em add_box Criar barramento.

3. Na página Criar um barramento, faça o seguinte:

   1. Digite um nome de barramento, por exemplo, my-bus.
   2. Na lista Região, selecione us-central1 (Iowa).

4. Aceite todos os outros padrões.

5. Clique em Criar.

Criar uma inscrição do Eventarc Advanced

Um registro determina quais mensagens são roteadas para um destino e também especifica o pipeline usado para configurar um destino para as mensagens de evento.

Para mais informações, consulte Criar uma inscrição para receber eventos.

Ao usar o console do Google Cloud, é possível criar uma inscrição e um pipeline ao mesmo tempo.

1. Para criar uma inscrição, no console do Google Cloud, acesse a página Eventarc > Pipelines.

   Acessar "Pipelines"

2. Clique em add_box Criar pipeline.

3. No painel Detalhes do pipeline, faça o seguinte:

   1. Insira um nome de pipeline, por exemplo, my-pipeline.
   2. Na lista Região, selecione us-central1 (Iowa). O pipeline precisa ser criado na mesma região do barramento.
   3. Aceite todos os outros padrões.
   4. Clique em Continuar.

4. No painel Matrículas, faça o seguinte:

   1. Clique em Adicionar uma inscrição.
   2. Insira um nome de inscrição, por exemplo, my-enrollment.
   3. Na lista Barramento do Eventarc Advanced, selecione o barramento que você criou anteriormente.

   4. No campo Expressão CEL, escreva uma expressão de avaliação usando CEL. Exemplo:

      message.type == "hello-world-type"

   5. Clique em Concluído.

   6. Clique em Continuar.

   7. No painel Mediação de eventos, clique em Continuar novamente.

5. No painel Destino, faça o seguinte:

   1. Na lista Tipo de destino, selecione Serviço do Cloud Run (via HTTP) e selecione o serviço do Cloud Run que você criou anteriormente.

   2. Na lista Anexo de rede, selecione o anexo de rede que você criou anteriormente.

   3. Marque a caixa de seleção Ativar autenticação.

      1. Na lista Auth header, selecione OIDC token.

      2. Na lista Conta de serviço, selecione a conta de serviço que você criou anteriormente e que vai invocar o serviço de destino. Esse e-mail da conta de serviço é usado para gerar o token do OIDC.

6. Clique em Criar.

Publicar uma mensagem de evento no barramento

Para publicar uma mensagem diretamente no seu bus, use o comando gcloud beta eventarc message-buses publish ou envie uma solicitação para a API REST de publicação do Eventarc. Para mais informações, consulte Publicar eventos diretamente.

A mensagem precisa estar em um formato CloudEvents, que é uma especificação para descrever dados de eventos de uma maneira comum. O elemento data é o payload do seu evento. Qualquer JSON bem formado pode ser colocado neste campo. Para mais informações sobre atributos de contexto do CloudEvents, consulte Formato de evento.

Publique um evento no barramento do Eventarc Advanced usando a gcloud CLI e uma flag --event-data e outras flags de atributo de evento:

gcloud beta eventarc message-buses publish BUS_NAME \
    --event-data='{"key": "hello-world-data"}' \
    --event-id=hello-world-id-1234 \
    --event-source=hello-world-source \
    --event-type=hello-world-type \
    --event-attributes="datacontenttype=application/json" \
    --location=$REGION

Ou publique um evento no barramento do Eventarc Advanced como uma mensagem JSON usando a CLI gcloud e uma flag --json-message:

gcloud beta eventarc message-buses publish BUS_NAME \
    --location=$REGION \
    --json-message='{"id": "hello-world-id-1234", "type":
 "hello-world-type", "source":
 "hello-world-source", "specversion": "1.0", "data":
 {"key": "hello-world-data"}}'

Depois de publicar um evento, você vai receber uma mensagem "Evento publicado com sucesso".

Conferir os dados do evento nos registros do Cloud Run

Depois de publicar um evento no barramento do Eventarc Advanced, é possível verificar os registros do serviço do Cloud Run para conferir se o evento foi recebido conforme o esperado.

1. No console do Google Cloud, acesse a página do Cloud Run.

   Acesse o Cloud Run

2. Na página Serviços, clique no nome do serviço.

3. Clique na guia Registros.

4. É possível filtrar as entradas de registro e retornar a saída. Por exemplo, você pode pesquisar hello-world-data.

5. Procure uma entrada de registro semelhante a esta:

   2025-02-27 08:36:44.350 EST [2025-02-27 13:36:44,352] INFO in server: Body: b'{"key": "hello-world-data"}'
   

Você criou um barramento e uma inscrição do Eventarc Advanced, publicou uma mensagem de evento no barramento e verificou o resultado esperado nos registros do serviço de receptor de eventos.