Acionadores do Pub/Sub


O Pub/Sub do Google Cloud é um barramento de mensagens distribuído globalmente que é dimensionado automaticamente conforme necessário. Você pode criar uma função que processa eventos do Pub/Sub usando functions.pubsub .

Acione uma função pub/sub

Você pode acionar uma função sempre que uma nova mensagem do Pub/Sub for enviada para um tópico específico. Você deve especificar o nome do tópico do Pub/Sub que deseja acionar sua função e definir o evento no manipulador de eventos onPublish() :

exports.helloPubSub = functions.pubsub.topic('topic-name').onPublish((message) => {
  // ...
});

Acesse a carga útil da mensagem pub/sub {:#access-pub/sub}

O payload da mensagem do Pub/Sub pode ser acessado no objeto Message retornado à sua função. Para mensagens com JSON no corpo da mensagem do Pub/Sub, o SDK do Firebase para Cloud Functions tem uma propriedade auxiliar para decodificar a mensagem. Por exemplo, aqui está uma mensagem publicada com uma carga JSON simples:

gcloud pubsub topics publish topic-name --message '{"name":"Xenia"}'

Você pode acessar uma carga de dados JSON como esta por meio da propriedade json :

  // Get the `name` attribute of the PubSub message JSON body.
  let name = null;
  try {
    name = message.json.name;
  } catch (e) {
    functions.logger.error('PubSub message was not JSON', e);
  }

Outras cargas não JSON estão contidas na mensagem do Pub/Sub como strings codificadas em base64 no objeto de mensagem. Para ler uma mensagem como a seguinte, você deve decodificar a string codificada em base64 conforme mostrado:

gcloud pubsub topics publish topic-name --message 'MyMessage'

// Decode the PubSub Message body.
const messageBody = message.data ? Buffer.from(message.data, 'base64').toString() : null;

Atributos de mensagem de acesso {:#access-message}

A mensagem do Pub/Sub pode ser enviada com atributos de dados definidos no comando de publicação. Por exemplo, você poderia publicar uma mensagem com um atributo name :

gcloud pubsub topics publish topic-name --attribute name=Xenia

Você pode ler esses atributos em Message.attributes :

// Get the `name` attribute of the message.
const name = message.attributes.name;

Você pode notar que alguns dados básicos, como o ID da mensagem ou o horário de publicação da mensagem, não estão disponíveis em Message.attributes . Para contornar isso, você pode acessar esses detalhes no EventContext do evento acionador. Por exemplo:

exports.myFunction = functions.pubsub.topic('topic1').onPublish((message, context) => {
    console.log('The function was triggered at ', context.timestamp);
    console.log('The unique ID for the event is', context.eventId);
});