Guia de início rápido: como usar a ferramenta de linha de comando gcloud

O Cloud 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 Cloud 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.

Nesta página, você aprende a publicar e consumir mensagens com um assinante de pull.

Observação: caso não esteja familiarizado com o Cloud Pub/Sub, recomendamos que comece pelo tutorial interativo.

Antes de começar

1. Faça login na sua Conta do Google.

   Se você ainda não tiver uma, inscreva-se.

2. Configure um projeto do Console do GCP.

   Configurar um projeto

   Clique para:

   • criar ou selecionar um projeto;
   • ativar Cloud Pub/Sub API para o projeto;

   É possível ver e gerenciar esses recursos a qualquer momento no Console do GCP.

3. Instale e inicialize o SDK do Cloud.
   Observação: também é possível usar o Cloud Shell para executar comandos do gcloud sem precisar instalar o SDK do Cloud.

Usar a ferramenta de linha de comando gcloud

Você pode usar a ferramenta de linha de comando gcloud para executar operações no Cloud Pub/Sub. A ferramenta de linha de comando gcloud está incluída no SDK do Cloud instalado na etapa Antes de começar. Consulte a seção gcloud pubsub na referência do gcloud para uma lista completa de comandos gcloud do Cloud Pub/Sub.

Este exemplo autossuficiente, para execução em bash, mostra as etapas necessárias:

1. Crie um tópico.
2. Assine o tópico.
3. Publique uma mensagem no tópico.
4. 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 Cloud Pub/Sub também aceita inscrições de push, conforme descrito no Guia do inscrito.

Você pode executar todas as operações administrativas por meio da API e a maior parte delas com a ferramenta gcloud e a IU do Console do GCP.

Próximas etapas

Para mais informações sobre os conceitos discutidos nesta página, consulte os guias do editor e do assinante.

Comece a usar o Cloud Pub/Sub na linguagem que preferir com as Bibliotecas de cliente do Cloud Pub/Sub.

Consulte 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 Cloud Pub/Sub, consulte O que é o Cloud Pub/Sub?