O Pub/Sub é um serviço de mensagens para trocar dados de eventos entre aplicativos e serviços. Um produtor de dados publica mensagens em um tópico do Pub/Sub. Um consumidor cria uma assinatura nesse tópico. Os assinantes solicitam mensagens de uma assinatura ou são configurados como webhooks para assinaturas de push. Cada assinante precisa confirmar todas as mensagens dentro de um período configurável.
Esta página mostra como publicar e consumir mensagens com um assinante de pull.
Antes de começar
-
Faça login na sua Conta do Google.
Se você ainda não tiver uma, inscreva-se.
- Configurar um projeto do Console do GCP.
Clique para:
- criar ou selecionar um projeto;
- ativar a(s) Pub/Sub API necessária(s) para o projeto.
É possível ver e gerenciar esses recursos a qualquer momento no Console do GCP.
- Instale e inicialize o SDK do Cloud..
Use a ferramenta de linha de comando gcloud
A ferramenta de linha de comando gcloud pode ser usada para executar operações no Pub/Sub.
A ferramenta de linha de comando gcloud está incluída no SDK do Cloud, instalado na seção Antes de começar.
Veja a seção gcloud pubsub na referência do gcloud para uma lista completa de comandos gcloud de Pub/Sub.
Este exemplo autossuficiente, para execução em bash, mostra as etapas necessárias:
- Crie um tópico.
- Assine o tópico.
- Publique uma mensagem no tópico.
- Receba a mensagem.
gcloud init gcloud pubsub topics create my-topic gcloud pubsub subscriptions create --topic my-topic my-sub gcloud pubsub topics publish my-topic --message "hello" gcloud pubsub subscriptions pull --auto-ack my-sub
Esse exemplo usa uma assinatura de pull. O Pub/Sub também aceita assinaturas de push, conforme descrito no guia do Assinante.
Todas as operações administrativas podem ser realizadas por meio da API, e a maior parte delas por meio da ferramenta gcloud e da IU do Console do Cloud Platform.
Como foi?
Observe que recursos e links extras estão disponíveis na página de suporte do Pub/Sub.
A seguir
Para mais informações sobre os conceitos discutidos nesta página, consulte os guias do editor e do assinante.
Dê os primeiros passos com o Pub/Sub na linguagem que preferir nas bibliotecas de cliente do Pub/Sub .
Consulte o Guia de início rápido: como usar bibliotecas de cliente
para encontrar um passo a passo sobre como usar as APIs da biblioteca de cliente para executar tarefas básicas do Cloud Pub/Sub.
Para uma visão geral detalhada do Pub/Sub, consulte O que é o Pub/Sub?