Publica y recibe mensajes en Pub/Sub mediante las bibliotecas cliente
Esta página te muestra cómo hacer lo siguiente:
Crea un proyecto, habilita la facturación y habilita la API de Pub/Sub Lite con Google Cloud CLI.
Crear reservas y temas y suscripciones Lite con Google Cloud CLI.
Envía y recibe mensajes con la biblioteca cliente de Pub/Sub Lite para Go, Java y Python.
Antes de comenzar
- Accede a tu cuenta de Google Cloud. Si eres nuevo en Google Cloud, crea una cuenta para evaluar el rendimiento de nuestros productos en situaciones reales. Los clientes nuevos también obtienen $300 en créditos gratuitos para ejecutar, probar y, además, implementar cargas de trabajo.
- 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.
-
-
Asegúrate de que la facturación esté habilitada para tu proyecto de Google Cloud.
-
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_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.
-
-
Asegúrate de que la facturación esté habilitada para tu proyecto de Google Cloud.
-
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_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
Instala la biblioteca 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
Crea una reserva de Lite
Para crear una reserva de Lite, usa el
gcloud pubsub lite-reservations create
kubectl. En el siguiente ejemplo, se crea una reserva llamada testRes
.
gcloud pubsub lite-reservations create testRes \ --location=us-central1 \ --throughput-capacity=1
Crea un tema regional de Lite
Para crear un tema de Lite regional, usa el comando gcloud pubsub lite-topics create
. En la siguiente muestra, se crea un tema llamado 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 \
Reemplaza lo siguiente:
PROJECT_ID: El ID del proyecto
Crea una suscripción Lite
Para crear una suscripción Lite, usa el comando gcloud pubsub lite-subscriptions create
. En la siguiente muestra, se crea una suscripción llamada testSub
.
gcloud pubsub lite-subscriptions create testSub \ --location=us-central1 \ --topic=testTopic \ --delivery-requirement=deliver-immediately
Envía mensajes
Envía mensajes al tema de Lite con la siguiente aplicación de publicador:
Go
Antes de probar esta muestra, sigue las instrucciones de configuración de Go que se encuentran en el Guía de inicio rápido de Pub/Sub Lite con bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Go de Pub/Sub Lite.
Para autenticarte en Pub/Sub Lite, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Java
Python
Antes de probar esta muestra, sigue las instrucciones de configuración de Python que se encuentran en el Guía de inicio rápido de Pub/Sub Lite con bibliotecas cliente. Para obtener más información, consulta la API de Python de Pub/Sub Lite documentación de referencia.
Para autenticarte en Pub/Sub Lite, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
El publicador envía 100 mensajes a un tema de Lite e imprime la cantidad de mensajes que recibe el servicio de Pub/Sub Lite.
Recibir mensajes
Recibe mensajes de la suscripción de Lite con la siguiente aplicación de suscriptor:
Go
Antes de probar esta muestra, sigue las instrucciones de configuración de Go que encontrarás en la guía de inicio rápido de Pub/Sub Lite con bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Go de Pub/Sub Lite.
Para autenticarte en Pub/Sub Lite, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Java
Antes de probar esta muestra, sigue las instrucciones de configuración de Java que encontrarás en la guía de inicio rápido de Pub/Sub Lite con bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Java de Pub/Sub Lite.
Para autenticarte en Pub/Sub Lite, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Python
Antes de probar esta muestra, sigue las instrucciones de configuración de Python que se encuentran en el Guía de inicio rápido de Pub/Sub Lite con bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Python de Pub/Sub Lite.
Para autenticarte en Pub/Sub Lite, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Después de que el suscriptor recibe un mensaje, el suscriptor imprime el ID de mensaje y los datos del mensaje.
Limpia
Para evitar que se apliquen cargos a tu cuenta de Google Cloud por los recursos que se usaron en esta página, borra el proyecto de Cloud que tiene los recursos.
- Para evitar que se apliquen cargos a tu cuenta de Google Cloud por los recursos que se usaron en esta guía, borra el tema y la suscripción.
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
¿Qué sigue?
- Obtén más información sobre los temas de Lite y las suscripciones Lite.
- Obtén más información sobre el envío y la recepción de mensajes.
- Revisa las muestras de código para la biblioteca cliente.