Publicar eventos de origens do Google

É possível ativar a coleta e publicação de eventos de fontes do Google para um barramento específico do Eventarc Advanced criando um recurso GoogleApiSource.

Os eventos de fontes do Google são acionados diretamente por um evento não mediado, como a criação de uma função do Cloud Run ou uma mudança de status em um job do Dataflow. Para mais informações, consulte Tipos de evento do Google compatíveis com o Eventarc.

Observe o seguinte:

• Por padrão, os eventos são coletados do projeto Google Cloud em que o recursoGoogleApiSourceexiste. Também é possível usar a CLI gcloud para coletar eventos de vários projetos na mesma organização que o recurso GoogleApiSource. Para mais informações, consulte Publicar eventos de vários projetos neste documento.
• É possível publicar eventos em um barramento que está em um Google Cloud projeto diferente daquele em que o recurso GoogleApiSource existe. É possível configurar isso usando a CLI gcloud ou enviando uma solicitação para a API Eventarc (mas não pelo console Google Cloud ).
• Há um limite de um recurso GoogleApiSource por projeto por região. Google Cloud

Antes de começar

Antes de começar, verifique se você concluiu as etapas a seguir:

1. Se você estiver usando a Google Cloud CLI para executar os comandos nesta página, instale e inicialize a CLI gcloud. Se você já instalou a CLI gcloud, instale a versão mais recente executando gcloud components update.

2. Ative a API Eventarc e a API Eventarc Publishing:

   Console

   Roles required to enable APIs

   To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

   Enable the APIs

   gcloud

   Roles required to enable APIs

   To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

   gcloud services enable eventarc.googleapis.com eventarcpublishing.googleapis.com

Ativar eventos de fontes do Google

Para publicar eventos de fontes do Google, crie um recurso GoogleApiSource. Esse recurso representa uma assinatura de eventos da API do Google em um projeto Google Cloud específico para um barramento do Eventarc Advanced.

É possível ativar a publicação de eventos de fontes do Google das seguintes maneiras:

• No console do Google Cloud
• Usando a Google Cloud CLI no terminal ou no Cloud Shell

• Enviando uma solicitação para a API Eventarc

{
  "displayName": "GOOGLE_API_SOURCE_NAME",
  "labels": {"LABEL_KEY":"LABEL_VALUE"},
  "annotations": {"ANNOTATION_KEY":"ANNOTATION_VALUE"},
  "destination": "DESTINATION",
  "cryptoKeyName": "ENCRYPT_KEY",
  "loggingConfig": {"logSeverity":"LOG_SEVERITY"}
}

cat > request.json << 'EOF'
{
  "displayName": "GOOGLE_API_SOURCE_NAME",
  "labels": {"LABEL_KEY":"LABEL_VALUE"},
  "annotations": {"ANNOTATION_KEY":"ANNOTATION_VALUE"},
  "destination": "DESTINATION",
  "cryptoKeyName": "ENCRYPT_KEY",
  "loggingConfig": {"logSeverity":"LOG_SEVERITY"}
}
EOF

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://eventarc.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/googleApiSources?googleApiSourceId=GOOGLE_API_SOURCE_NAME"

@'
{
  "displayName": "GOOGLE_API_SOURCE_NAME",
  "labels": {"LABEL_KEY":"LABEL_VALUE"},
  "annotations": {"ANNOTATION_KEY":"ANNOTATION_VALUE"},
  "destination": "DESTINATION",
  "cryptoKeyName": "ENCRYPT_KEY",
  "loggingConfig": {"logSeverity":"LOG_SEVERITY"}
}
'@  | Out-File -FilePath request.json -Encoding utf8

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://eventarc.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/googleApiSources?googleApiSourceId=GOOGLE_API_SOURCE_NAME" | Select-Object -Expand Content

{
  "name": "projects/PROJECT_ID/locations/LOCATION/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.eventarc.v1.OperationMetadata",
    "createTime": "2024-01-25T17:17:45.782370139Z",
    "target": "projects/PROJECT_ID/locations/LOCATION/googleApiSources/GOOGLE_API_SOURCE_NAME",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

Os eventos de fontes do Google no mesmo projeto Google Cloud que o recurso GoogleApiSource agora são coletados e publicados no barramento.

Desativar eventos de fontes do Google

Para desativar a publicação de eventos de fontes do Google em um projeto Google Cloud específico para um barramento do Eventarc Advanced, exclua o recurso GoogleApiSource.

É possível desativar a publicação de eventos de fontes do Google das seguintes maneiras:

• No console do Google Cloud
• Usando a CLI gcloud no terminal ou no Cloud Shell

• Enviando uma solicitação para a API Eventarc

curl -X DELETE \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://eventarc.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/googleApiSources/GOOGLE_API_SOURCE_NAME"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method DELETE `
    -Headers $headers `
    -Uri "https://eventarc.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/googleApiSources/GOOGLE_API_SOURCE_NAME" | Select-Object -Expand Content

{
  "name": "projects/PROJECT_ID/locations/LOCATION/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.eventarc.v1.OperationMetadata",
    "createTime": "2024-01-25T17:17:45.782370139Z",
    "target": "projects/PROJECT_ID/locations/LOCATION/googleApiSources/GOOGLE_API_SOURCE_NAME",
    "verb": "delete",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

Os eventos de fontes do Google no mesmo projeto Google Cloud que o recursoGoogleApiSourceexcluído não são mais coletados e publicados.

Publicar eventos de vários projetos

Para coletar e publicar eventos de origem do Google de vários projetos Google Cloud , crie um recurso GoogleApiSource. Os projetos precisam estar na mesma organização que o recurso GoogleApiSource. Para mais informações sobre organizações, consulte Hierarquia de recursos.

Observe o seguinte:

• A publicação de eventos de vários projetos precisa ser configurada usando a CLI gcloud e não aparece no console Google Cloud .
• Se o projeto que contém o recurso GoogleApiSource for movido para uma organização diferente, a publicação de eventos de vários projetos não vai mais funcionar como esperado. É necessário atualizar ou recriar o recurso GoogleApiSource.

1. Conceda ao agente de serviço do Eventarc o papel apropriado do IAM

Para coletar eventos no nível da organização, use o comando gcloud organizations add-iam-policy-binding para conceder ao agente de serviço do Eventarc o papel apropriado do Identity and Access Management (IAM):

gcloud organizations add-iam-policy-binding ORGANIZATION_ID \
    --member="SERVICE_AGENT_EMAIL" \
    --role="roles/eventarc.multiProjectEventCollector"

Substitua:

• ORGANIZATION_ID: o ID do recurso da organização.

• SERVICE_AGENT_EMAIL: o endereço de e-mail do agente de serviço principal do Eventarc no projeto em que você está criando o recurso GoogleApiSource. O endereço de e-mail está no seguinte formato:

  service-PROJECT_NUMBER@gcp-sa-eventarc.iam.gserviceaccount.com
  

  Substitua PROJECT_NUMBER peloGoogle Cloud número do projeto. Encontre o número do projeto na página Boas-vindas do console do Google Cloud ou executando o seguinte comando:

  gcloud projects describe PROJECT_ID --format='value(projectNumber)'
  

2. Publicar de todos os projetos ou de uma lista de projetos

Para publicar eventos de fontes do Google em vários projetos, use o comando gcloud eventarc google-api-sources create de uma das seguintes maneiras:

• Publicar de todos Google Cloud os projetos na mesma organização que o recurso GoogleApiSource:

  gcloud eventarc google-api-sources create GOOGLE_API_SOURCE_NAME \
      --location=REGION \
      --destination-message-bus=BUS_NAME \
      --destination-message-bus-project=BUS_PROJECT_ID \
      --organization-subscription

• Publicar de uma lista de Google Cloud projetos na mesma organização que o recurso GoogleApiSource:

  gcloud eventarc google-api-sources create GOOGLE_API_SOURCE_NAME \
      --location=REGION \
      --destination-message-bus=BUS_NAME \
      --destination-message-bus-project=BUS_PROJECT_ID \
      --project-subscriptions=LIST_OF_PROJECTS

  Substitua:

  • GOOGLE_API_SOURCE_NAME: o ID ou identificador totalmente qualificado do recurso GoogleApiSource
  • REGION: o local do recurso GoogleApiSource
  • BUS_NAME: o ID ou identificador totalmente qualificado do ônibus para o qual você quer se inscrever em eventos da API do Google.
  • BUS_PROJECT_ID: o Google Cloud ID do projeto do barramento
  • LIST_OF_PROJECTS: uma lista delimitada por vírgulas de Google Cloud IDs ou números de projetos. É possível combinar IDs e números na mesma lista. Para publicar eventos do projetoGoogle Cloud que contém o recurso GoogleApiSource, é obrigatório incluir explicitamente o ID ou o número do projeto na lista.

A seguir

• Guia de início rápido: publicar eventos de uma fonte do Google
• Publicar eventos diretamente
• Formatar eventos recebidos
• Transformar eventos recebidos