Planifier et exécuter un job cron à l'aide de la console Google Cloud

Ce guide de démarrage rapide vous explique comment utiliser la console Google Cloud pour effectuer des opérations de base avec Cloud Scheduler.

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

  1. Créez un sujet Pub/Sub à configurer comme cible de votre tâche Cloud Scheduler.
  2. Créez un job Cron à l'aide de Cloud Scheduler et configurez une planification récurrente pour le job.
  3. Exécutez votre job.
  4. vérifier que la tâche a bien été exécutée.

Une version sans frais 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. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  3. Make sure that billing is enabled for your Google Cloud project.

  4. Enable the Cloud Scheduler, Pub/Sub APIs.

    Enable the APIs

  5. Make sure that you have the following role or roles on the project: Cloud Scheduler Admin, Pub/Sub Editor

    Check for the roles

    1. In the Google Cloud console, go to the IAM page.

      Go to IAM
    2. Select the project.

    3. In the Principal column, find all rows that identify you or a group that you're included in. To learn which groups you're included in, contact your administrator.

    4. For all rows that specify or include you, check the Role column to see whether the list of roles includes the required roles.

    Grant the roles

    1. In the Google Cloud console, go to the IAM page.

      Accéder à IAM
    2. Sélectionnez le projet.
    3. Cliquez sur Accorder l'accès.

    4. Dans le champ Nouveaux comptes principaux, saisissez votre identifiant utilisateur. Il s'agit généralement de l'adresse e-mail d'un compte Google.

    5. Dans la liste Sélectionner un rôle, sélectionnez un rôle.
    6. Pour attribuer des rôles supplémentaires, cliquez sur Ajouter un autre rôle et ajoutez chaque rôle supplémentaire.
    7. Cliquez sur Enregistrer.

  6. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  7. Make sure that billing is enabled for your Google Cloud project.

  8. Enable the Cloud Scheduler, Pub/Sub APIs.

    Enable the APIs

  9. Make sure that you have the following role or roles on the project: Cloud Scheduler Admin, Pub/Sub Editor

    Check for the roles

    1. In the Google Cloud console, go to the IAM page.

      Go to IAM
    2. Select the project.

    3. In the Principal column, find all rows that identify you or a group that you're included in. To learn which groups you're included in, contact your administrator.

    4. For all rows that specify or include you, check the Role column to see whether the list of roles includes the required roles.

    Grant the roles

    1. In the Google Cloud console, go to the IAM page.

      Accéder à IAM
    2. Sélectionnez le projet.
    3. Cliquez sur Accorder l'accès.

    4. Dans le champ Nouveaux comptes principaux, saisissez votre identifiant utilisateur. Il s'agit généralement de l'adresse e-mail d'un compte Google.

    5. Dans la liste Sélectionner un rôle, sélectionnez un rôle.
    6. Pour attribuer des rôles supplémentaires, cliquez sur Ajouter un autre rôle et ajoutez chaque rôle supplémentaire.
    7. Cliquez sur Enregistrer.

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. Dans la console Google Cloud , accédez à la page Pub/Sub.

    Accéder à Pub/Sub

  2. Cliquez sur Create topic (Créer un sujet).

  3. Dans le champ ID du sujet, saisissez cron-topic comme ID de votre sujet.

  4. Conservez les paramètres par défaut, y compris l'option Ajouter un abonnement par défaut.

  5. Ne sélectionnez aucune autre option.

  6. Cliquez sur Créer.

Cela crée un sujet Pub/Sub nommé cron-topic et un abonnement à ce sujet nommé cron-topic-sub.

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 tâche, en utilisant un format basé sur unix-cron. Exemple :

    30 16 * * 7

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

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

    Pour certains fuseaux horaires, l'heure d'été peut entraîner l'exécution ou la non-exécution inattendue de tâches. Pour en savoir plus, consultez 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. Par exemple : "Bonjour !"

  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 l'exécution selon la planification spécifiée, vous pouvez forcer l'exécution immédiate de votre job.

  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 job, cliquez sur Actions > Forcer l'exécution.

    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 des messages de votre tâche en extrayant les messages Pub/Sub de l'abonnement.

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

    Accéder à Pub/Sub

  2. Cliquez sur l'abonnement à votre sujet Pub/Sub.

  3. Cliquez sur l'onglet Messages.

  4. Cliquez sur Extraire.

Le message que vous avez publié doit s'afficher, avec le corps du message, Hello world, et l'heure à laquelle il a été publié.

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 l'abonnement Pub/Sub :

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

      Accéder à Pub/Sub

    2. Cochez la case correspondant à votre abonnement.

    3. Cliquez sur Supprimer, puis confirmez la suppression.

  4. Si vous avez créé un projet pour apprendre à utiliser Cloud Scheduler et que vous n'en avez plus besoin, supprimez-le :

    1. In the Google Cloud console, go to the Manage resources page.

      Go to Manage resources

    2. In the project list, select the project that you want to delete, and then click Delete.
    3. In the dialog, type the project ID, and then click Shut down to delete the project.

Étapes suivantes