Gatilhos do Pub/Sub

No Cloud Run functions, um acionador Pub/Sub permite que uma função seja chamada em resposta a mensagens do Pub/Sub. Ao especificar um acionador do Pub/Sub para uma função, você também especifica um tópico do Pub/Sub. A função será chamada sempre que uma mensagem for publicada no tópico especificado.

Um gatilho do Pub/Sub é implementado como uma função do CloudEvent, em que os dados de evento do Pub/Sub são transmitidos para a função no formato CloudEvents e o payload de dados do CloudEvent é do tipo MessagePublishedData.

O repositório Eventos do Google contém outros recursos para trabalhar com dados de eventos.

Implantação

É possível especificar um acionador Pub/Sub ao implantar uma função. Consulte Implantar uma função do Cloud para instruções gerais sobre como implantar uma função. Veja abaixo mais informações específicas para configurar acionadores do Pub/Sub durante a implantação.

gcloud

Se você estiver implantando usando a CLI gcloud, as sinalizações mostradas abaixo serão usadas para configurar acionadores do Pub/Sub:

gcloud functions deploy YOUR_FUNCTION_NAME \
--trigger-topic=YOUR_PUBSUB_TOPIC \
[--retry] \
...
  • A sinalização --trigger-topic especifica o tópico do Pub/Sub que o gatilho vai monitorar. As mensagens publicadas neste tópico acionarão chamadas para sua função.
  • A sinalização --retry controla se as chamadas de função com falha são repetidas automaticamente. Consulte Como repetir funções orientadas a eventos para mais informações.

Console

Para implantar usando o Console do Google Cloud, configure um gatilho do Pub/Sub na seção Acionador:

  1. No campo Tipo de gatilho, selecione Cloud Pub/Sub.
  2. No campo Tópico do Cloud Pub/Sub, selecione um tópico para o gatilho monitorar. As mensagens publicadas neste tópico acionarão chamadas para sua função.
  3. Marque ou desmarque a caixa de seleção Tentar novamente em caso de falha para controlar se o Cloud Run functions repetirá automaticamente uma invocação de função que falhou. Consulte Como repetir funções orientadas a eventos para mais informações.

  4. Clique em Mais opções para fazer outras configurações no gatilho:

    • No campo Tipo de gatilho, especifique uma das Fontes do Google, Personalizado ou Terceiros:

      • As Fontes do Google permitem especificar gatilhos para o Pub/Sub, Cloud Storage, Firestore e outros provedores de eventos do Google. No painel Gatilho do Eventarc, use o campo Provedor de eventos para selecionar o produto que fornece o tipo de evento que você quer que acione sua função. Em seguida, no campo Evento, selecione o evento que você quer usar como gatilho.

      • A opção Personalizada permite produzir e consumir eventos do código do aplicativo. Siga as instruções no painel Gatilho do Eventarc para criar um canal. Um canal é um recurso usado como pipeline para entregar eventos personalizados de produtores a consumidores. Eventos personalizados são publicados em um canal, e um gatilho do Eventarc é inscrito nesses eventos.

      • A opção Terceiros permite a integração com provedores que não são do Google que oferecem uma fonte do Eventarc. Consulte Eventos de terceiros no Eventarc para mais detalhes.

    • No campo Evento, selecione um evento de gatilho. O padrão é google.cloud.pubsub.topic.v1.messagePublished.

    • Opcionalmente, no campo Conta de serviço, selecione uma conta de serviço a ser usada como a identidade do acionador do Eventarc. Consulte Identidade do gatilho para mais informações.

  5. Clique em Salvar acionador.

Próximas etapas