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
- Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
Create or select a Google Cloud project.
-
Create a Google Cloud project:
gcloud projects create PROJECT_ID
Replace
PROJECT_ID
with a name for the Google Cloud project you are creating. -
Select the Google Cloud project that you created:
gcloud config set project PROJECT_ID
Replace
PROJECT_ID
with your Google Cloud project name.
-
-
Make sure that billing is enabled for your Google Cloud project.
-
Enable the Pub/Sub Lite API:
gcloud services enable pubsublite.googleapis.com
-
Create local authentication credentials for your user account:
gcloud auth application-default login
-
Grant roles to your user account. Run the following command once for each of the following IAM roles:
roles/pubsublite.admin
gcloud projects add-iam-policy-binding PROJECT_ID --member="user:USER_IDENTIFIER" --role=ROLE
- Replace
PROJECT_ID
with your project ID. -
Replace
USER_IDENTIFIER
with the identifier for your user account. For example,user:myemail@example.com
. - Replace
ROLE
with each individual role.
- Replace
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
Create or select a Google Cloud project.
-
Create a Google Cloud project:
gcloud projects create PROJECT_ID
Replace
PROJECT_ID
with a name for the Google Cloud project you are creating. -
Select the Google Cloud project that you created:
gcloud config set project PROJECT_ID
Replace
PROJECT_ID
with your Google Cloud project name.
-
-
Make sure that billing is enabled for your Google Cloud project.
-
Enable the Pub/Sub Lite API:
gcloud services enable pubsublite.googleapis.com
-
Create local authentication credentials for your user account:
gcloud auth application-default login
-
Grant roles to your user account. Run the following command once for each of the following IAM roles:
roles/pubsublite.admin
gcloud projects add-iam-policy-binding PROJECT_ID --member="user:USER_IDENTIFIER" --role=ROLE
- Replace
PROJECT_ID
with your project ID. -
Replace
USER_IDENTIFIER
with the identifier for your user account. For example,user:myemail@example.com
. - Replace
ROLE
with each individual role.
- Replace
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
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
-
Optional: Revoke the authentication credentials that you created, and delete the local credential file.
gcloud auth application-default revoke
-
Optional: Revoke credentials from the gcloud CLI.
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.