Publier et recevoir des messages dans Pub/Sub à l'aide des bibliothèques clientes
Cette page vous explique comment :
Créer un projet, et activer la facturation et le service Pub/Sub Lite à l'aide de la Google Cloud CLI.
Créer des réservations Lite, des sujets Lite et des abonnements Lite à l'aide de la Google Cloud CLI.
Envoyer et recevoir des messages à l'aide de la bibliothèque cliente Pub/Sub Lite pour Go, Java et Python.
Avant de commencer
- Connectez-vous à votre compte Google Cloud. Si vous débutez sur Google Cloud, créez un compte pour évaluer les performances de nos produits en conditions réelles. Les nouveaux clients bénéficient également de 300 $ de crédits gratuits pour exécuter, tester et déployer des charges de travail.
- Installez Google Cloud CLI.
-
Pour initialiser gcloudCLI, exécutez la commande suivante :
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.
-
-
Vérifiez que la facturation est activée pour votre projet Google Cloud.
-
Activer Pub/Sub Lite API :
gcloud services enable pubsublite.googleapis.com
-
Créez des identifiants d'authentification locaux pour votre compte Google :
gcloud auth application-default login
-
Attribuez des rôles à votre compte Google. Exécutez la commande suivante une fois pour chacun des rôles IAM suivants :
roles/pubsublite.admin
gcloud projects add-iam-policy-binding PROJECT_ID --member="user:EMAIL_ADDRESS" --role=ROLE
- en remplaçant
PROJECT_ID
par l'ID de votre projet : - Remplacez
EMAIL_ADDRESS
par votre adresse e-mail. - Remplacez
ROLE
par chaque rôle individuel.
- en remplaçant
- Installez Google Cloud CLI.
-
Pour initialiser gcloudCLI, exécutez la commande suivante :
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.
-
-
Vérifiez que la facturation est activée pour votre projet Google Cloud.
-
Activer Pub/Sub Lite API :
gcloud services enable pubsublite.googleapis.com
-
Créez des identifiants d'authentification locaux pour votre compte Google :
gcloud auth application-default login
-
Attribuez des rôles à votre compte Google. Exécutez la commande suivante une fois pour chacun des rôles IAM suivants :
roles/pubsublite.admin
gcloud projects add-iam-policy-binding PROJECT_ID --member="user:EMAIL_ADDRESS" --role=ROLE
- en remplaçant
PROJECT_ID
par l'ID de votre projet : - Remplacez
EMAIL_ADDRESS
par votre adresse e-mail. - Remplacez
ROLE
par chaque rôle individuel.
- en remplaçant
Installer la bibliothèque 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
Créer une réservation Lite
Pour créer une réservation Lite, utilisez la
gcloud pubsub lite-reservations create
. L'exemple suivant crée une réservation appelée testRes
.
gcloud pubsub lite-reservations create testRes \ --location=us-central1 \ --throughput-capacity=1
Créer un sujet Lite régional
Pour créer un sujet Lite régional, utilisez la commande gcloud pubsub lite-topics create
. L'exemple suivant crée un sujet appelé 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 \
Remplacez les éléments suivants :
PROJECT_ID : ID du projet
Créer un abonnement Lite
Pour créer un abonnement Lite, utilisez le
gcloud pubsub lite-subscriptions create
. L'exemple suivant crée un abonnement appelé testSub
.
gcloud pubsub lite-subscriptions create testSub \ --location=us-central1 \ --topic=testTopic \ --delivery-requirement=deliver-immediately
Envoyer des messages
Envoyez des messages au sujet Lite à l'aide de l'application d'éditeur suivante :
Go
Avant d'essayer cet exemple, suivez les instructions de configuration de Go dans le Guide de démarrage rapide de Pub/Sub Lite avec bibliothèques clientes. Pour en savoir plus, consultez les API Go Pub/Sub Lite documentation de référence.
Pour vous authentifier auprès de Pub/Sub Lite, configurez les identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Java
Python
Avant d'essayer cet exemple, suivez les instructions de configuration de Python dans le Guide de démarrage rapide de Pub/Sub Lite avec bibliothèques clientes. Pour en savoir plus, consultez les API Python Pub/Sub Lite documentation de référence.
Pour vous authentifier auprès de Pub/Sub Lite, configurez les identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
L'éditeur envoie 100 messages à un sujet Lite et imprime le nombre de messages que le service Pub/Sub Lite reçoit.
Recevoir des messages
Recevez des messages de l'abonnement Lite à l'aide de l'application d'abonné suivante :
Go
Avant d'essayer cet exemple, suivez les instructions de configuration de Go dans le Guide de démarrage rapide de Pub/Sub Lite avec bibliothèques clientes. Pour en savoir plus, consultez les API Go Pub/Sub Lite documentation de référence.
Pour vous authentifier auprès de Pub/Sub Lite, configurez les identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Java
Avant d'essayer cet exemple, suivez les instructions de configuration de Java dans le Guide de démarrage rapide de Pub/Sub Lite avec bibliothèques clientes. Pour en savoir plus, consultez les API Java Pub/Sub Lite documentation de référence.
Pour vous authentifier auprès de Pub/Sub Lite, configurez les identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Python
Avant d'essayer cet exemple, suivez les instructions de configuration de Python dans le Guide de démarrage rapide de Pub/Sub Lite avec bibliothèques clientes. Pour en savoir plus, consultez les API Python Pub/Sub Lite documentation de référence.
Pour vous authentifier auprès de Pub/Sub Lite, configurez les identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Une fois que l'abonné a reçu un message, il imprime l'ID et les données du message.
Effectuer un nettoyage
Pour éviter que les ressources utilisées sur cette page ne soient facturées sur votre compte Google Cloud, supprimez le projet Google Cloud contenant les ressources.
- Afin d'éviter que des frais ne soient facturés sur votre compte Google Cloud pour
les ressources utilisées dans ce guide, supprimez le sujet et l'abonnement.
gcloud pubsub lite-subscriptions delete testSub --location=us-central1 gcloud pubsub lite-topics delete testTopic --location=us-central1
-
Facultatif : Révoquez les identifiants d'authentification que vous avez créés et supprimez le fichier d'identifiants local.
gcloud auth application-default revoke
-
Facultatif : Révoquez les identifiants de la CLI gcloud.
gcloud auth revoke
Étape suivante
- Apprenez-en plus sur les sujets Lite et les abonnements Lite.
- Apprenez-en plus sur l'envoi et la réception de messages.
- Consultez des exemples de code pour la bibliothèque cliente.