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.
- Instala Google Cloud CLI.
-
Para inicializar la CLI de gcloud, ejecuta el siguiente comando:
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.
-
Habilita la Pub/Sub Lite API:
gcloud services enable pubsublite.googleapis.com
-
Crea credenciales de autenticación locales para tu Cuenta de Google:
gcloud auth application-default login
-
Otorga roles a tu Cuenta de Google. Ejecuta el siguiente comando una vez para cada uno de los siguientes roles de IAM:
roles/pubsublite.admin
gcloud projects add-iam-policy-binding PROJECT_ID --member="user:EMAIL_ADDRESS" --role=ROLE
- Reemplaza
PROJECT_ID
con el ID del proyecto. - Reemplaza
EMAIL_ADDRESS
por tu dirección de correo electrónico. - Reemplaza
ROLE
por cada rol individual.
- Reemplaza
- Instala Google Cloud CLI.
-
Para inicializar la CLI de gcloud, ejecuta el siguiente comando:
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.
-
Habilita la Pub/Sub Lite API:
gcloud services enable pubsublite.googleapis.com
-
Crea credenciales de autenticación locales para tu Cuenta de Google:
gcloud auth application-default login
-
Otorga roles a tu Cuenta de Google. Ejecuta el siguiente comando una vez para cada uno de los siguientes roles de IAM:
roles/pubsublite.admin
gcloud projects add-iam-policy-binding PROJECT_ID --member="user:EMAIL_ADDRESS" --role=ROLE
- Reemplaza
PROJECT_ID
con el ID del proyecto. - Reemplaza
EMAIL_ADDRESS
por tu dirección de correo electrónico. - Reemplaza
ROLE
por cada rol individual.
- Reemplaza
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 comando gcloud pubsub lite-reservations create
. En el siguiente ejemplo, se crea una reserva llamada testRes
.
gcloud pubsub lite-reservations create testRes \ --location=us-central1 \ --throughput-capacity=1
Crear un tema Lite regional
Para crear un tema Lite regional, usa el comando gcloud pubsub lite-topics create
. En el siguiente ejemplo, 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 el siguiente ejemplo, 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 la guía de inicio rápido de Pub/Sub Lite sobre el uso de 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 la guía de inicio rápido de Pub/Sub Lite sobre el uso de 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.
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 se encuentran en la guía de inicio rápido de Pub/Sub Lite sobre el uso de 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 se encuentran en la guía de inicio rápido de Pub/Sub Lite sobre el uso de 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 la guía de inicio rápido de Pub/Sub Lite sobre el uso de 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
-
Opcional: Revoca las credenciales de autenticación que creaste y borra el archivo local de credenciales.
gcloud auth application-default revoke
-
Opcional: Revoca credenciales desde 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.