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 manipula eventos Pub/Sub usando functions.pubsub .

Acionar 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 que acione sua função e definir o evento no manipulador de eventos onPublish() :

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

Acessar a carga útil da mensagem pub/sub

A carga da mensagem do Pub/Sub pode ser acessada 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 um payload JSON simples:

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

Você pode acessar uma carga útil 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);
  }
index.js

Outros payloads não JSON estão contidos 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;
index.js

Acessar atributos de mensagem

A mensagem do Pub/Sub pode ser enviada com atributos de dados definidos no comando de publicação. Por exemplo, você pode publicar uma mensagem com um atributo de 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;
index.js

Você pode perceber 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);
});