El servicio Pub/Sub permite que las aplicaciones intercambien mensajes de manera confiable, rápida y asíncrona. Para lograr esto, un productor de datos publica mensajes en un tema de Pub/Sub. Luego, un cliente suscriptor crea una suscripción al tema y consume mensajes desde la suscripción. Pub/Sub conserva los mensajes que no se pudieron enviar de manera confiable durante un máximo de siete días. En esta página, se muestra cómo comenzar a publicar mensajes con Pub/Sub mediante el uso de las bibliotecas cliente.
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.
- Configura un proyecto de Cloud Console.
Haz clic para realizar alguna de las siguientes acciones:
- Crea o selecciona un proyecto.
- Habilita la API de Pub/Sub para ese proyecto.
- Crea una cuenta de servicio.
- Descargar una clave privada como JSON
Puedes ver y administrar estos recursos en cualquier momento desde Cloud Console.
-
Configura la variable de entorno
GOOGLE_APPLICATION_CREDENTIALS
en la ruta del archivo JSON que contiene la clave de tu cuenta de servicio. Esta variable solo se aplica a la sesión actual de shell. Por lo tanto, si abres una sesión nueva, deberás volver a configurar la variable. - Instala e inicializa el SDK de Cloud.
Instala bibliotecas cliente
En los siguientes ejemplos, se muestra cómo instalar las bibliotecas cliente:
Python
Para obtener más información sobre la configuración de tu entorno de desarrollo de Python, consulta Configurar un entorno de programación de Python.
# ensure that you are using virtualenv
# as described in the python dev setup guide
pip install --upgrade google-cloud-pubsub
C++
Si deseas obtener más información para instalar la biblioteca C++, consulta README
de GitHub.
C#
Install-Package Google.Cloud.PubSub.V1 -Pre
Go
go get -u cloud.google.com/go/pubsub
Java
Si usas Maven, agrega lo siguiente al archivo pom.xml
. Para obtener más información sobre las BOM, consulta Las bibliotecas de BOM de Google Cloud Platform.
Si usas Gradle, agrega lo siguiente a las dependencias:
Si usas sbt, agrega lo siguiente a las dependencias:
Si usas IntelliJ o Eclipse, puedes agregar bibliotecas cliente a tu proyecto mediante los siguientes complementos de IDE:
Los complementos brindan funcionalidades adicionales, como administración de claves para las cuentas de servicio. Consulta la documentación de cada complemento para obtener más detalles.
Node.js
npm install --save @google-cloud/pubsub
PHP
composer require google/cloud-pubsub
Ruby
gem install google-cloud-pubsub
Crea un tema y una suscripción
Una vez que crees un tema, puedes suscribirte o publicarlo.
Usa el comando gcloud pubsub themes create para crear un tema:
gcloud pubsub topics create my-topic
Usa el comando gcloud pubsub suscripciones create para crear una suscripción. Solo los mensajes publicados en el tema después de crear la suscripción están disponibles para las aplicaciones de suscriptor.
gcloud pubsub subscriptions create my-sub --topic my-topic
Para obtener más información sobre cómo nombrar tus temas y suscripciones, consulta Nombres de recursos.
Publica mensajes
En las siguientes muestras, usa my-topic
para tu ID de tema.
Python
C++
C#
Comienza a usarlo
Java
Node.js
PHP
Ruby
Recibe mensajes
Configura un suscriptor para que extraiga los mensajes que acabas de publicar. Cada suscriptor debe confirmar cada mensaje dentro de un período configurable. Los mensajes no confirmados se vuelven a entregar. Ten en cuenta que, en ocasiones, Pub/Sub entrega un mensaje varias veces para garantizar que todos los mensajes lleguen al suscriptor al menos una vez.
En las siguientes muestras, usa my-sub
para tu ID de suscripción.
Python
C++
C#
Comienza a usarlo
Java
Node.js
PHP
Ruby
¿Cómo fue?
Realiza una limpieza (opcional)
Para evitar que se apliquen cargos a tu cuenta de Google Cloud Platform por los recursos que se usan en esta guía, puedes usar la línea de comandos para borrar el tema y la suscripción.
gcloud pubsub subscriptions delete my-sub gcloud pubsub topics delete my-topic
¿Qué sigue?
Consulta la documentación sobre Pub/Sub.
Para obtener un ejemplo de extremo a extremo, consulta la página sobre cómo compilar un sistema de Pub/Sub.
Para ver casos prácticos adicionales, consulta los instructivo de Pub/Sub.
Si deseas obtener detalles sobre la biblioteca cliente para el lenguaje que elijas, consulta la página sobre bibliotecas cliente.
Para obtener más información sobre los conceptos discutidos en esta página, consulta las guías de publicador y suscriptor.