Cette page vous explique comment :
- Créer des sujets Lite et des abonnements Lite à l'aide de Google Cloud Console.
- Envoyer et recevoir des messages à l'aide de la bibliothèque cliente Pub/Sub Lite pour Java
Avant de commencer
- Connectez-vous à votre compte Google.
Si vous n'en possédez pas déjà un, vous devez en créer un.
-
Dans Google Cloud Console, sur la page de sélection du projet, sélectionnez ou créez un projet Google Cloud.
-
Assurez-vous que la facturation est activée pour votre projet Cloud. Découvrez comment vérifier que la facturation est activée pour votre projet.
- Activez Pub/Sub Lite API.
-
Créez un compte de service :
-
Dans Cloud Console, accédez à la page Créer un compte de service.
Accéder à la page "Créer un compte de service" - Sélectionnez un projet.
-
Dans le champ Nom du compte de service, saisissez un nom. Cloud Console remplit le champ ID du compte de service en fonction de ce nom.
Dans le champ Description du compte de service, saisissez une description. Exemple :
Service account for quickstart
. - Cliquez sur Create (Créer).
-
Cliquez sur le champ Sélectionner un rôle.
Dans la section Accès rapide, cliquez sur Basique, puis sur Propriétaire.
- Cliquez sur Continuer.
-
Cliquez sur OK pour terminer la création du compte de service.
Ne fermez pas la fenêtre de votre navigateur. Vous en aurez besoin lors de la tâche suivante.
-
-
Créez une clé de compte de service :
- Dans Cloud Console, cliquez sur l'adresse e-mail du compte de service que vous avez créé.
- Cliquez sur Clés.
- Cliquez sur Ajouter une clé, puis sur Créer une clé.
- Cliquez sur Create (Créer). Un fichier de clé JSON est téléchargé sur votre ordinateur.
- Cliquez sur Close (Fermer).
-
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.
Installer la bibliothèque cliente
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.
Python
pip install --upgrade google-cloud-pubsublite
Créer un sujet Lite
Pour créer un sujet Lite à l'aide de Cloud Console, procédez comme suit :
Dans Cloud Console, accédez à la page Sujets Lite.
Cliquez sur Créer un sujet Lite.
Sélectionnez une région et une zone dans cette région.
Dans la section Nom, saisissez
your-lite-topic
comme ID du sujet Lite. Le nom du sujet Lite inclut l'ID du sujet Lite, la zone et le numéro du projet.Cliquez sur Create (Créer).
Créer un abonnement Lite
Pour créer un abonnement Lite avec Cloud Console, procédez comme suit :
Dans Cloud Console, accédez à la page Abonnements Lite.
Cliquez sur Créer un abonnement Lite.
Dans le champ ID de l'abonnement Lite, saisissez
your-lite-subscription
.Sélectionnez un sujet Lite pour recevoir des messages de celui-ci.
Dans la section Critère de distribution, sélectionnez Distribuer les messages après leur stockage.
Cliquez sur Create (Créer).
L'abonnement Lite se trouve dans la même zone que le sujet Lite.
Envoyer des messages
Envoyez des messages au sujet Lite à l'aide de l'application d'éditeur suivante :
Go
Java
Python
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
Java
Python
Une fois que l'abonné a reçu un message, il imprime l'ID et les données du message.
Nettoyer
Pour éviter que les ressources utilisées dans ce guide de démarrage rapide soient facturées sur votre compte Google Cloud, procédez comme suit :
Dans Cloud Console, accédez à la page Sujets Lite.
Cliquez sur your-lite-topic.
Sur la page Détails du sujet Lite, cliquez sur Supprimer.
Dans le champ qui s'affiche, saisissez
delete
pour confirmer la suppression du sujet Lite.Cliquez sur Supprimer.
É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.