Le service Pub/Sub permet aux applications d'échanger des messages de manière fiable, rapide et asynchrone. Pour cela, un producteur de données publie un message dans un sujet Pub/Sub. Un client abonné crée ensuite un abonnement associé à ce sujet et utilise les messages de l'abonnement. Pub/Sub conserve les messages qui n'ont pas pu être distribués de manière fiable pendant sept jours au maximum. Sur cette page, nous vous expliquons comment faire vos premiers pas avec Pub/Sub pour publier des messages à l'aide de bibliothèques clientes.
Avant de commencer
- Connectez-vous à votre compte Google.
Si vous n'en possédez pas déjà un, vous devez en créer un.
-
Configurez un projet Cloud Console.
Cliquez pour effectuer les opérations suivantes :
- Créer ou sélectionner un projet
- Activez l'API Pub/Sub pour ce projet.
- Créez un compte de service.
- Téléchargez une clé privée au format JSON.
Vous pouvez consulter et gérer ces ressources à tout moment dans Cloud Console.
-
Définissez la variable d'environnement
GOOGLE_APPLICATION_CREDENTIALS
pour qu'elle pointe vers le chemin du fichier JSON contenant la clé de votre compte de service. Cette variable ne s'applique qu'à la session de shell actuelle. Par conséquent, si vous ouvrez une nouvelle session, vous devez de nouveau la définir. - Installez et initialisez le SDK Cloud.
Installer les bibliothèques clientes
Les exemples suivants vous montrent comment installer les bibliothèques clientes :
Python
Pour en savoir plus sur la configuration de votre environnement de développement Python, consultez le guide de configuration d'un environnement de développement Python.
# ensure that you are using virtualenv
# as described in the python dev setup guide
pip install --upgrade google-cloud-pubsub
C++
Pour en savoir plus sur l'installation de la bibliothèque C++, consultez la page GitHub README
.
C#
Install-Package Google.Cloud.PubSub.V1 -Pre
Go
go get -u cloud.google.com/go/pubsub
Java
Si vous utilisez Maven, ajoutez les lignes suivantes à votre fichier pom.xml
. Pour en savoir plus sur les BOM, consultez la page The Google Cloud Platform Libraries BOM (BOM des bibliothèques Google Cloud Platform).
Si vous utilisez Gradle, ajoutez les éléments suivants à vos dépendances :
Si vous utilisez sbt, ajoutez les éléments suivants à vos dépendances :
Si vous utilisez IntelliJ ou Eclipse, vous pouvez ajouter des bibliothèques clientes à votre projet à l'aide des plug-ins IDE suivants :
Les plug-ins offrent des fonctionnalités supplémentaires, telles que la gestion des clés pour les comptes de service. Reportez-vous à la documentation de chaque plug-in pour plus de détails.
Node.js
npm install --save @google-cloud/pubsub
PHP
composer require google/cloud-pubsub
Ruby
gem install google-cloud-pubsub
Créer un sujet et un abonnement
Après avoir créé un sujet, vous pouvez vous y abonner ou y publier des messages.
Exécutez la commande gcloud pubsub topics create pour créer un sujet :
gcloud pubsub topics create my-topic
Exécutez la commande gcloud pubsub subscriptions create pour créer un abonnement. Seuls les messages publiés dans le sujet après la création de l'abonnement sont disponibles pour les applications d'abonnés.
gcloud pubsub subscriptions create my-sub --topic my-topic
Pour en savoir plus sur l'attribution de nom à vos sujets et à vos abonnements, consultez la section Noms de ressources.
Publier des messages
Dans les exemples suivants, utilisez my-topic
pour l'ID de votre sujet.
Python
C++
C#
Go
Java
Node.js
PHP
Ruby
Recevoir des messages
Configurez un abonné pour extraire les messages que vous venez de publier. Les abonnés doivent accuser réception de chaque message pendant une période configurable. Les messages non confirmés seront à nouveau distribués. Notez que Pub/Sub distribue parfois un message plusieurs fois pour garantir que tous les messages parviennent à un abonné au moins une fois.
Dans les exemples suivants, utilisez my-sub
pour l'ID de votre abonnement.
Python
C++
C#
Go
Java
Node.js
PHP
Ruby
Comment ça s'est passé ?
Effectuer un nettoyage (facultatif)
Pour éviter que les ressources utilisées dans ce guide soient facturées sur votre compte Google Cloud Platform, vous pouvez supprimer le sujet et l'abonnement à l'aide de la ligne de commande.
gcloud pubsub subscriptions delete my-sub gcloud pubsub topics delete my-topic
Étape suivante
Consultez la page Qu'est-ce que Pub/Sub ?
Pour obtenir un exemple de bout en bout, consultez la section Créer un système Pub/Sub.
Pour les autres cas d'utilisation, consultez les tutoriels Pub/Sub.
Si vous souhaitez en savoir plus sur la bibliothèque cliente pour le langage de votre choix, consultez la section relative aux bibliothèques clientes.
Pour en savoir plus sur les concepts abordés sur cette page, consultez les guides pour les éditeurs et les abonnés.