Planifier et exécuter un job Cron

Ce guide de démarrage rapide vous explique comment effectuer certaines opérations de base à l'aide de Cloud Scheduler.

Dans le cadre de ce guide démarrage rapide, vous allez effectuer les étapes suivantes :

  1. créer un job Cron à l'aide de Cloud Scheduler ;
  2. définir un calendrier récurrent pour une tâche ;
  3. spécifier un sujet Pub/Sub comme cible de la tâche ;
  4. exécuter une tâche ;
  5. vérifier que la tâche a bien été exécutée.

Une version gratuite de Cloud Scheduler est disponible. Par conséquent, l'exécution de ce démarrage rapide ne vous coûtera rien. Pour en savoir plus, reportez-vous à la page Tarifs.


Pour obtenir des instructions détaillées sur cette tâche directement dans la console Google Cloud, cliquez sur Visite guidée :

Visite guidée


Avant de commencer

  1. 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.
  2. Dans Google Cloud Console, sur la page de sélection du projet, sélectionnez ou créez un projet Google Cloud.

    Accéder au sélecteur de projet

  3. Vérifiez que la facturation est activée pour votre projet Google Cloud.

  4. Installez Google Cloud CLI.
  5. Pour initialiser gcloudCLI, exécutez la commande suivante :

    gcloud init
  6. Dans Google Cloud Console, sur la page de sélection du projet, sélectionnez ou créez un projet Google Cloud.

    Accéder au sélecteur de projet

  7. Vérifiez que la facturation est activée pour votre projet Google Cloud.

  8. Installez Google Cloud CLI.
  9. Pour initialiser gcloudCLI, exécutez la commande suivante :

    gcloud init
  10. Si vous n'utilisez pas Cloud Shell, mettez à jour les composants de la Google Cloud CLI:
    gcloud components update
  11. Connectez-vous à votre compte :
    gcloud auth login
  12. Activez les API Cloud Scheduler et Pub/Sub:

    gcloud services enable cloudscheduler.googleapis.com pubsub.googleapis.com

Créer un sujet et un abonnement Pub/Sub

Un sujet Pub/Sub est une ressource à laquelle les éditeurs peuvent envoyer des messages. Pour recevoir des messages publiés dans un sujet, vous devez créer un abonnement associé à ce sujet.

  1. Configurez un sujet Pub/Sub à utiliser en tant que cible pour votre tâche Cron :

    gcloud pubsub topics create cron-topic
    

    Cette opération crée un sujet appelé cron-topic.

  2. Pour afficher les résultats de votre tâche, créez un abonnement Pub/Sub :

    gcloud pubsub subscriptions create cron-sub --topic cron-topic
    

Créer un job Cron à l'aide de Cloud Scheduler

Configurez une unité de travail planifiée appelée tâche Cron qui est envoyée à une cible selon une planification récurrente.

  1. Dans la console Google Cloud, accédez à la page Cloud Scheduler.

    Accéder à Cloud Scheduler

  2. Cliquez sur Créer une tâche.

  3. Attribuez un nom à votre tâche.

  4. Dans la liste Région, sélectionnez une région pour votre job.

  5. Spécifiez une fréquence pour votre job, en utilisant un format basé sur unix-cron. Exemple :

    30 16 * * 7
    

    Pour en savoir plus, consultez la section Configurer des job Cron Cron.

  6. Dans la liste Fuseau horaire, sélectionnez un fuseau horaire.

    Pour certains fuseaux horaires, le passage à l'heure d'été peut entraîner l'exécution ou une non-exécution des tâches de manière inattendue. Pour en savoir plus, consultez la section Fuseau horaire.

  7. Cliquez sur Continuer.

  8. Dans la liste Type de cible, sélectionnez Pub/Sub.

  9. Sélectionnez le sujet que vous avez créé précédemment : cron-topic.

  10. Dans le champ Corps du message, saisissez une chaîne à envoyer à votre sujet cible Pub/Sub. Exemple: "Bonjour à tous !"

  11. Cliquez sur Créer.

Vous avez créé une tâche qui envoie un message à un sujet Pub/Sub à 16h30 le dimanche. Vous pouvez maintenant exécuter le job.

Exécuter votre tâche

En plus de s'exécuter selon la planification spécifiée, vous pouvez forcer l'exécution immédiate de votre tâche.

  1. Dans la console Google Cloud, accédez à la page Cloud Scheduler.

    Accéder à Cloud Scheduler

    Votre tâche devrait apparaître dans la liste.

  2. Sur la ligne correspondant à votre tâche, cliquez sur Actions > Forcer l'exécution d'une tâche.

    Notez qu'en raison d'une configuration initiale, l'exécution de la première tâche créée dans un projet peut prendre quelques minutes.

  3. Dans la colonne État de la dernière exécution, l'état Success indique que la tâche Cron a bien été exécutée.

Vous pouvez ensuite vérifier que Pub/Sub a bien reçu le message.

Vérifier les résultats dans Pub/Sub

Vérifiez que votre sujet Pub/Sub reçoit les messages de votre job.

  1. Extrayez des messages Pub/Sub d'un abonnement :

    gcloud pubsub subscriptions pull cron-sub --limit 5
    

    Si aucun message n'a été initialement récupéré, exécutez de nouveau la commande.

  2. Consultez les résultats de l'exécution de votre tâche. Le résultat doit ressembler à ce qui suit :

    DATA: Hello world!
    MESSAGE_ID: 5028933846601543
    ORDERING_KEY:
    ATTRIBUTES:
    DELIVERY_ATTEMPT:
    ACK_ID: RFAGFixdRkhRNxkIaFEOT14jPzUgKEUQAgVPAihdeTFXLkFacGhRDRlyfWB9[...]
    

Effectuer un nettoyage

Pour éviter que les ressources utilisées sur cette page soient facturées sur votre compte Google Cloud, procédez comme suit :

  1. Supprimer le job Cron que vous avez créé :

    1. Dans la console Google Cloud, accédez à la page Cloud Scheduler.

      Accéder à Cloud Scheduler

    2. Cochez la case correspondant à votre tâche.

    3. Cliquez sur Supprimer, puis confirmez la suppression.

  2. Supprimez le sujet Pub/Sub :

    1. Dans la console Google Cloud, accédez à la page Pub/Sub.

      Accéder à Pub/Sub

    2. Cochez la case correspondant à votre sujet.

    3. Cliquez sur Supprimer, puis confirmez la suppression.

  3. Supprimez le projet :

    1. Dans la console Google Cloud, accédez à la page Gérer les ressources.

      Accéder à la page Gérer les ressources

    2. Dans la liste des projets, sélectionnez le projet que vous souhaitez supprimer, puis cliquez sur Supprimer.
    3. Dans la boîte de dialogue, saisissez l'ID du projet, puis cliquez sur Arrêter pour supprimer le projet.

Étapes suivantes