Publicar e receber mensagens no Pub/Sub usando as bibliotecas de cliente
Nesta página, você aprende as seguintes ações com relação à verificação de tempo de atividade:
Criar um projeto e ativar o faturamento e o Pub/Sub Lite usando a Google Cloud CLI.
Criar reservas, tópicos e assinaturas do Lite usando a Google Cloud CLI.
Envie e receba mensagens com a biblioteca de cliente do Pub/Sub Lite para Go, Java e Python.
Antes de começar
- Faça login na sua conta do Google Cloud. Se você começou a usar o Google Cloud agora, crie uma conta para avaliar o desempenho de nossos produtos em situações reais. Clientes novos também recebem US$ 300 em créditos para executar, testar e implantar cargas de trabalho.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
Crie ou selecione um projeto do Google Cloud.
-
Crie um projeto do Google Cloud:
gcloud projects create PROJECT_ID
Substitua
PROJECT_ID
por um nome para o projeto do Google Cloud que você está criando. -
Selecione o projeto do Google Cloud que você criou:
gcloud config set project PROJECT_ID
Substitua
PROJECT_ID
pelo nome do projeto do Google Cloud.
-
-
Verifique se a cobrança está ativada para o seu projeto do Google Cloud.
-
Ative Pub/Sub Lite API:
gcloud services enable pubsublite.googleapis.com
-
Create local authentication credentials for your user account:
gcloud auth application-default login
-
Atribua os papéis à sua Conta do Google. Execute uma vez o seguinte comando para cada um dos seguintes papéis do IAM:
roles/pubsublite.admin
gcloud projects add-iam-policy-binding PROJECT_ID --member="user:EMAIL_ADDRESS" --role=ROLE
- Substitua
PROJECT_ID
pela ID do seu projeto. - Substitua
EMAIL_ADDRESS
pelo seu endereço de e-mail. - Substitua
ROLE
por cada papel individual.
- Substitua
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
Crie ou selecione um projeto do Google Cloud.
-
Crie um projeto do Google Cloud:
gcloud projects create PROJECT_ID
Substitua
PROJECT_ID
por um nome para o projeto do Google Cloud que você está criando. -
Selecione o projeto do Google Cloud que você criou:
gcloud config set project PROJECT_ID
Substitua
PROJECT_ID
pelo nome do projeto do Google Cloud.
-
-
Verifique se a cobrança está ativada para o seu projeto do Google Cloud.
-
Ative Pub/Sub Lite API:
gcloud services enable pubsublite.googleapis.com
-
Create local authentication credentials for your user account:
gcloud auth application-default login
-
Atribua os papéis à sua Conta do Google. Execute uma vez o seguinte comando para cada um dos seguintes papéis do IAM:
roles/pubsublite.admin
gcloud projects add-iam-policy-binding PROJECT_ID --member="user:EMAIL_ADDRESS" --role=ROLE
- Substitua
PROJECT_ID
pela ID do seu projeto. - Substitua
EMAIL_ADDRESS
pelo seu endereço de e-mail. - Substitua
ROLE
por cada papel individual.
- Substitua
Instale a biblioteca de cliente
Go
go get cloud.google.com/go/pubsublite
Java
If you are using Maven, add
the following to your pom.xml
file. For more information about
BOMs, see The Google Cloud Platform Libraries BOM.
If you are using Gradle, add the following to your dependencies:
If you are using sbt, add the following to your dependencies:
If you're using Visual Studio Code, IntelliJ, or Eclipse, you can add client libraries to your project using the following IDE plugins:
The plugins provide additional functionality, such as key management for service accounts. Refer to each plugin's documentation for details.
Python
pip install --upgrade google-cloud-pubsublite
Criar uma reserva do Lite
Para criar uma reserva do Lite, use o
gcloud pubsub lite-reservations create
kubectl. O exemplo a seguir cria uma reserva chamada testRes
.
gcloud pubsub lite-reservations create testRes \ --location=us-central1 \ --throughput-capacity=1
Criar um tópico regional do Lite
Para criar um tópico regional do Lite, use o comando gcloud pubsub lite-topics create
. O exemplo a seguir cria um tópico chamado testTopic
.
gcloud pubsub lite-topics create testTopic \ --location=us-central1 \ --partitions=1 \ --per-partition-bytes=30GiB \ --throughput-reservation=projects/PROJECT_ID/locations/us-central1/reservations/testRes \
Substitua:
PROJECT_ID: o ID do projeto
Criar uma assinatura do Lite
Para criar uma assinatura Lite, use o
gcloud pubsub lite-subscriptions create
kubectl. O exemplo a seguir cria uma assinatura chamada testSub
.
gcloud pubsub lite-subscriptions create testSub \ --location=us-central1 \ --topic=testTopic \ --delivery-requirement=deliver-immediately
Enviar mensagens
Envie mensagens para o tópico do Lite usando o seguinte app do editor:
Go
Antes de testar este exemplo, siga as instruções de configuração do Go na Guia de início rápido do Pub/Sub Lite usando bibliotecas de cliente. Para mais informações, consulte a API Pub/Sub Lite Go documentação de referência.
Para autenticar no Pub/Sub Lite, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Java
Python
Antes de testar este exemplo, siga as instruções de configuração do Python na Guia de início rápido do Pub/Sub Lite usando bibliotecas de cliente. Para mais informações, consulte a API Pub/Sub Lite Python documentação de referência.
Para autenticar no Pub/Sub Lite, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
O editor envia 100 mensagens para um tópico do Lite e imprime o número de mensagens que o serviço do Pub/Sub Lite recebe.
Receber mensagens
Receba mensagens da assinatura do Lite usando o seguinte aplicativo de assinante:
Go
Antes de testar este exemplo, siga as instruções de configuração do Go na Guia de início rápido do Pub/Sub Lite usando bibliotecas de cliente. Para mais informações, consulte a API Pub/Sub Lite Go documentação de referência.
Para autenticar no Pub/Sub Lite, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Java
Antes de testar este exemplo, siga as instruções de configuração do Java na Guia de início rápido do Pub/Sub Lite usando bibliotecas de cliente. Para mais informações, consulte a API Pub/Sub Lite Java documentação de referência.
Para autenticar no Pub/Sub Lite, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Python
Antes de testar este exemplo, siga as instruções de configuração do Python na Guia de início rápido do Pub/Sub Lite usando bibliotecas de cliente. Para mais informações, consulte a API Pub/Sub Lite Python documentação de referência.
Para autenticar no Pub/Sub Lite, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Depois que o assinante recebe uma mensagem, o assinante imprime o ID da mensagem e os dados dela.
Limpar
Para evitar cobranças na sua conta do Google Cloud pelos recursos usados nesta página, exclua o projeto do Google Cloud com esses recursos.
- Para evitar cobranças na sua conta do Google Cloud pelo
recursos usados neste guia, exclua o tópico e a assinatura.
gcloud pubsub lite-subscriptions delete testSub --location=us-central1 gcloud pubsub lite-topics delete testTopic --location=us-central1
-
Opcional: revogue as credenciais de autenticação que você criou e exclua o arquivo de credenciais local:
gcloud auth application-default revoke
-
Opcional: revogar credenciais da CLI gcloud.
gcloud auth revoke
A seguir
- Saiba mais sobre tópicos do Lite e assinaturas do Lite (links em inglês).
- Saiba mais sobre como enviar e como receber mensagens.
- Analise exemplos de código para a biblioteca de cliente.