Ce tutoriel montre comment utiliser Cloud Scheduler et Pub/Sub pour déclencher une fonction Cloud. Il est courant d'utiliser Cloud Scheduler afin de planifier l'exécution d'une fonction Cloud Functions. Vous découvrirez comment :
- créer une fonction Cloud simple qui s'abonne à un sujet Pub/Sub ;
- créer un sujet Pub/Sub pour déclencher cette fonction ;
- Créer une tâche Cloud Scheduler qui appelle le déclencheur Pub/Sub
- exécuter la tâche Cloud Scheduler ;
- vérifier le bon déroulement de l'opération.
Avant de commencer
Dans ce tutoriel, nous partons du principe que vous avez déjà effectué le Démarrage rapide de Cloud Scheduler. Par conséquent, vous disposez des outils et ressources suivants:Un projet Google Cloud avec facturation activée.
L'API Cloud Scheduler et l'API Pub/Sub sont toutes deux activées sur le projet. Vous activerez l'API Cloud Functions au cours de ce tutoriel.
Coûts
Ce tutoriel utilise les composants facturables suivants de Google Cloud :
- Cloud Functions
- Pub/Sub
- Cloud Scheduler
Obtenez une estimation des coûts en fonction de votre utilisation prévue à l'aide du simulateur de coût.
Créer une fonction Cloud Functions
Dans Google Cloud Console, accédez à la page Cloud Functions.
Cliquez sur Enable API (Activer l'API).
Cliquez sur Create function (Créer une fonction).
Attribuez un nom à votre fonction. Acceptez la valeur par défaut pour l'allocation de mémoire.
Dans la liste Déclencheur, sélectionnez Cloud Pub/Sub.
Sélectionnez un sujet existant dans le menu déroulant ou utilisez le pop-up Créer un sujet pour en créer un. Votre fonction est désormais abonnée au sujet. Notez le nom du sujet. Vous en aurez besoin par la suite.
Acceptez les valeurs par défaut pour tout le reste, y compris les exemples de code
index.js
etpackage.json
.Cliquez sur Create (Créer).
Créer une tâche Cloud Scheduler
Dans la console Google Cloud, accédez à la page Cloud Scheduler.
Cliquez sur Create a job (Créer une tâche).
Si nécessaire, sélectionnez la région dans laquelle exécuter votre tâche.
Attribuez un nom à votre tâche. Vous pouvez éventuellement ajouter une description.
Dans le champ Frequency (Fréquence), spécifiez la fréquence de votre tâche en utilisant le format unix-cron.
30 16 * * 7
Pour en savoir plus, consultez Configurer des planifications de tâches Cron.
Sélectionnez votre fuseau horaire.
Cliquez sur Continuer.
Dans la liste Cible, sélectionnez Pub/Sub.
Sélectionnez le nom de votre thème.
Ajoutez une brève chaîne de message à envoyer à votre cible.
Cliquez sur Create (Créer).
Vous disposez maintenant d'une tâche Cron qui envoie un message à votre sujet Pub/Sub le dimanche à 16h30. Votre fonction Cloud Functions est abonnée à ce sujet.
Exécuter votre tâche
Vous pouvez maintenant exécuter la tâche que vous avez créée.
Dans Google Cloud Console, accédez à la page Cloud Scheduler.
Cliquez sur Exécuter maintenant.
La première exécution de la première tâche créée dans un projet peut prendre quelques minutes, étant donné que des opérations de configuration sont requises.
Observez la colonne Result (Résultat).
Félicitations ! Vous venez d'utiliser la console pour afficher les résultats de l'exécution d'une tâche Cron qui envoie un message à Pub/Sub. Dans la prochaine étape, vous allez découvrir comment vérifier que votre fonction Cloud Functions a bien été exécutée.
Vérifier les résultats dans Cloud Functions
Pour vérifier que votre fonction Cloud est correctement déclenchée par votre tâche Cron:
Dans la console Google Cloud, accédez à la page Cloud Functions.
Cliquez sur le nom de la fonction.
La page Informations sur la fonction s'ouvre. Vérifiez les appels de fonction.
Félicitations ! Votre fonction a été exécutée.
Cliquez sur View logs (Afficher les journaux).
Consultez les détails de l'appel.
Nettoyer
Pour éviter que les ressources utilisées dans ce tutoriel soient facturées sur votre compte Google Cloud:
Supprimer la tâche Cloud Scheduler
Dans la console Google Cloud, accédez à la page Cloud Scheduler.
Cochez la case située en regard de votre tâche.
Cliquez sur
Supprimer, puis confirmez la suppression.
Supprimer le sujet Pub/Sub
Dans Google Cloud Console, accédez à la page Cloud Pub/Sub.
Cochez la case située à côté de votre thème.
Cliquez sur
Supprimer, puis confirmez la suppression.
Supprimer la fonction Cloud Functions
Dans la console Google Cloud, accédez à la page Cloud Functions.
Cochez la case située à côté de votre fonction.
Cliquez sur
Supprimer, puis confirmez la suppression.
Supprimer le projet
Si vous avez créé un projet seulement pour ce tutoriel :
- Dans la console, accédez à la page Gérer les ressources.
- Dans la liste des projets, sélectionnez le projet que vous souhaitez supprimer, puis cliquez sur Supprimer.
- Dans la boîte de dialogue, saisissez l'ID du projet, puis cliquez sur Arrêter pour supprimer le projet.