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 devez déjà disposer des outils et ressources suivants :Un projet Google Cloud avec facturation activée.
Une application App Engine située dans l'un des emplacements compatibles avec App Engine
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 fait appel à des composants facturables de Cloud Platform, en particulier :
- Google Cloud Functions
- Google Cloud Pub/Sub
- Google Cloud Scheduler
Utilisez le simulateur de coût pour générer une estimation des coûts en fonction de votre utilisation prévue.
Les nouveaux utilisateurs de Cloud Platform peuvent bénéficier d'un essai gratuit.Créer une fonction Cloud Functions
Accédez à la page Cloud Functions de la console :
Cliquez sur le bouton Activer l'API.
Cliquez sur le bouton Créer une fonction.
Attribuez un nom à votre fonction. Acceptez la valeur par défaut pour l'allocation de mémoire.
Sélectionnez Cloud Pub/Sub dans la liste déroulante Trigger (Déclencheur).
Sélectionnez un sujet existant dans le menu déroulant, ou utilisez la fenêtre contextuelle 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.jsetpackage.json.Cliquez sur Créer.
Créer une tâche Cloud Scheduler
Accédez à la page Cloud Scheduler de la console.
Cliquez sur le bouton Créer une tâche.
Si nécessaire, sélectionnez une région dans laquelle votre tâche doit s'exécuter.
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.
* * * * *Reportez-vous à la rubrique Configurer les programmations de tâches Cron pour en savoir plus.
Sélectionnez votre fuseau horaire.
Sélectionnez Pub/Sub dans le menu déroulant Cible.
Saisissez le nom du sujet que vous avez sélectionné précédemment.
Ajoutez une brève chaîne de charge utile à envoyer à votre cible.
Cliquez sur Créer.
Vous disposez maintenant d'une tâche Cron qui envoie un message à votre sujet Pub/Sub chaque minute. Votre fonction Cloud Functions est abonnée à ce sujet.
Exécutons la tâche que vous venez de créer.
Exécuter votre tâche
Ouvrez la page Cloud Scheduler de la console.
Cliquez sur le bouton Exécuter.
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. Vous devrez peut-être patienter un peu.
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 Functions est correctement déclenchée par votre tâche Cron :
Accédez à la page Cloud Functions de la console :
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, procédez comme suit :
Supprimer la tâche Cloud Scheduler
Accédez à la page Cloud Scheduler dans Cloud Console.
Cochez la case située en regard de votre tâche.
Cliquez sur le bouton Supprimer en haut de la page et confirmez la suppression.
Supprimer le sujet Pub/Sub
Accédez à la page Cloud Pub/Sub dans Cloud Console.
Cochez la case située en regard de votre sujet.
Cliquez sur le bouton Supprimer en haut de la page et confirmez la suppression.
Supprimer la fonction Cloud Functions
Accédez à la page Cloud Functions dans Cloud Console.
Cochez la case située en regard de votre fonction.
Cliquez sur le bouton Supprimer en haut de la page et confirmez la suppression.
Supprimer le projet
Si vous avez créé un projet seulement pour ce tutoriel :
- Dans Cloud 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.