Criar um barramento para rotear mensagens

Console

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

   Acessar Bus

2. Clique em add_box Criar barramento.

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

   1. Digite um Nome do barramento. Esse é o ID do seu ônibus.
   2. Opcional: insira um Nome de exibição do barramento, que aparece na página Detalhes do barramento.
   3. Na lista Região, selecione uma região compatível para implantar seu ônibus.
   4. Na lista Gravidade do registro, selecione a gravidade mínima dos eventos descritos nas entradas de registro. O padrão é Nenhum. Para mais informações, consulte LogSeverity.
   5. Em Criptografia, aceite o padrão Google-managed encryption key ou selecione Chave do Cloud KMS. Para mais informações, consulte Usar chaves de criptografia gerenciadas pelo cliente (CMEK).

   6. Se você selecionar Chave do Cloud KMS, faça o seguinte:

      1. Na lista Tipo de chave, selecione um método para gerenciar suas chaves.

         É possível gerenciar as chaves manualmente ou usar a chave automática, que permite gerar keyrings e chaves sob demanda. Se a opção Cloud KMS com Autokey estiver desativada, ela ainda não estará integrada ao tipo de recurso atual.

      2. Em Selecionar uma chave do Cloud KMS, escolha uma chave.

         É necessário selecionar uma região antes de visualizar as chaves gerenciadas pelo cliente.

      3. Opcional: para inserir manualmente o nome do recurso da chave, na lista Selecionar uma chave gerenciada pelo cliente, clique em Inserir chave manualmente e insira o nome da chave no formato especificado.

      4. Se solicitado, conceda o papel cloudkms.cryptoKeyEncrypterDecrypter ao Agente de serviço do Eventarc.

   7. Opcional: para adicionar uma fonte de mensagem, clique em add Adicionar fonte.

      1. No painel Adicionar origem da mensagem, para o provedor de mensagens da API do Google, aceite o padrão google-api-source ou insira um nome de origem diferente.

      2. Clique em Criar.

         Isso permite a coleta automática de eventos diretamente de fontes do Google.

         Somente eventos de recursos no mesmo projeto Google Cloud do barramento são publicados. Para mais informações, consulte Publicar eventos de fontes do Google.

   8. Opcional: para adicionar rótulos, clique em add Adicionar rótulo. Os rótulos são pares de chave-valor que ajudam você a organizar seus recursos doGoogle Cloud . Para mais informações, consulte O que são rótulos?

4. Clique em Criar.

gcloud

1. Abra um terminal.

2. Crie um barramento usando o comando gcloud beta eventarc message-buses create.

   gcloud beta eventarc message-buses create BUS_NAME \
       --location=REGION
   

   Substitua:

   • BUS_NAME: o ID ou identificador totalmente qualificado do ônibus.

   • REGION: um local compatível para o ônibus

     Como alternativa, é possível definir a propriedade de local da Google Cloud CLI:

     gcloud config set eventarc/location REGION
     

   Opcional: você também pode usar as seguintes flags:

   • --async para retornar do comando imediatamente, sem aguardar a conclusão da operação em andamento.
   • --crypto-key para especificar o nome totalmente qualificado de uma chave de criptografia gerenciada pelo cliente. Se não for especificado, Google-owned and managed keys serão usados.
   • --logging-config para configurar a gravidade mínima dos eventos descritos nas entradas de registro. Precisa ser uma destas opções: NONE, DEBUG, INFO, NOTICE, WARNING, ERROR, CRITICAL, ALERT, EMERGENCY. O padrão é NONE. Para mais informações, consulte LogSeverity.

API REST

Para criar um ônibus, use o método projects.locations.messageBuses.create.

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

• BUS_NAME: o nome de exibição do seu ônibus, por exemplo, my_bus.
• LABEL_KEY e LABEL_VALUE: opcional. Um mapa de pares de chave e valor de rótulo que ajudam a organizar seus recursos do Google Cloud . Para mais informações, consulte O que são rótulos?
• ANNOTATION_KEY e ANNOTATION_VALUE: opcional. Um mapa de pares de chave e valor de anotação de texto em formato livre. É possível usá-las para anexar informações arbitrárias associadas ao recurso. Para mais informações, consulte Anotações.
• ENCRYPT_KEY: opcional. Uma chave do Cloud KMS que o barramento precisa usar para criptografia de dados no formato projects/PROJECT_NAME/locations/LOCATION/keyRings/RING_NAME/cryptoKeys/KEY_NAME. Para mais informações, consulte Usar chaves de criptografia gerenciadas pelo cliente.
• PROJECT_ID: o ID do projeto do Google Cloud.
• LOCATION: a região em que o barramento será criado, por exemplo, us-central1.
• LOG_SEVERITY: opcional. A gravidade mínima do evento descrito em uma entrada de registro. Uma destas opções: NONE, DEBUG, INFO, NOTICE, WARNING, ERROR, CRITICAL, ALERT, EMERGENCY. O padrão é NONE. Para mais informações, consulte LogSeverity.

Corpo JSON da solicitação:

{
  "display_name": "BUS_NAME",
  "labels": {"LABEL_KEY":"LABEL_VALUE"},
  "annotations": {"ANNOTATION_KEY":"ANNOTATION_VALUE"},
  "cryptoKeyName": "ENCRYPT_KEY",
  "loggingConfig": {"logSeverity":"LOG_SEVERITY"}
}

Para enviar a solicitação, expanda uma destas opções:

cat > request.json << 'EOF'
{
  "display_name": "BUS_NAME",
  "labels": {"LABEL_KEY":"LABEL_VALUE"},
  "annotations": {"ANNOTATION_KEY":"ANNOTATION_VALUE"},
  "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/messageBuses?messageBusId=BUS_NAME"

@'
{
  "display_name": "BUS_NAME",
  "labels": {"LABEL_KEY":"LABEL_VALUE"},
  "annotations": {"ANNOTATION_KEY":"ANNOTATION_VALUE"},
  "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/messageBuses?messageBusId=BUS_NAME" | Select-Object -Expand Content

Se houver êxito, o corpo da resposta conterá uma instância de Operation:

{
  "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/messageBuses/BUS_NAME",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

Console

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

   Acessar Bus

   A página Detalhes do ônibus é aberta.

2. Clique em delete Excluir.

3. Quando for solicitado a excluir o barramento, marque a caixa de seleção Quer continuar? para confirmar que as origens de mensagem configuradas para usar o barramento não poderão mais fazer isso.

4. Para confirmar a exclusão, digite Delete.

5. Clique em Excluir.

gcloud

1. Abra um terminal.

2. Exclua um barramento usando o comando gcloud beta eventarc message-buses delete.

   gcloud beta eventarc message-buses delete BUS_NAME \
       --location=REGION
   

   Substitua:

   • BUS_NAME: o ID ou identificador totalmente qualificado do ônibus.
   • REGION: o local compatível para o ônibus

API REST

Para excluir um ônibus, use o método projects.locations.messageBuses.delete.

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

• PROJECT_ID: o ID do projeto do Google Cloud.
• LOCATION: a região em que o barramento é criado, por exemplo, us-central1.
• BUS_NAME: o nome do barramento que você quer excluir.

Para enviar a solicitação, expanda uma destas opções:

curl -X DELETE \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://eventarc.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/messageBuses/BUS_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/messageBuses/BUS_NAME" | Select-Object -Expand Content

Se houver êxito, o corpo da resposta conterá uma instância de Operation:

{
  "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/messageBuses/BUS_NAME",
    "verb": "delete",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}