Planifier et exécuter une job Cron à l'aide de la Google Cloud console

Planifier et exécuter une job Cron à l'aide de la Google Cloud console

Ce guide de démarrage rapide vous explique comment utiliser la Google Cloud console pour effectuer des 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 sujet Pub/Sub à configurer comme cible de votre tâche Cloud Scheduler.
2. Créer une job Cron à l'aide de Cloud Scheduler et configurer une planification récurrente pour la tâche.
3. Exécuter votre tâche.
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 Google Cloud console, cliquez sur Visite guidée:

Visite guidée

---

Avant de commencer

Connectez-vous à votre Google Cloud compte. 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 sans frais pour exécuter, tester et déployer des charges de travail.

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

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

Verify that billing is enabled for your Google Cloud project.

Enable the Cloud Scheduler and Pub/Sub APIs.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

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

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

Verify that billing is enabled for your Google Cloud project.

Enable the Cloud Scheduler and Pub/Sub APIs.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

Rôles requis

Pour obtenir les autorisations nécessaires pour suivre ce guide de démarrage rapide, demandez à votre administrateur de vous accorder les rôles IAM suivants sur votre projet :

• Administrateur Cloud Scheduler (roles/cloudscheduler.admin)
• Éditeur Pub/Sub (roles/pubsub.editor)

Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.

Vous pouvez également obtenir les autorisations requises avec des rôles personnalisés ou d'autres rôles prédéfinis.

Créer un sujet et un abonnement Pub/Sub

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

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

   Accéder à Pub/Sub

2. Cliquez sur Créer un sujet.

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

4. Conservez les valeurs 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 une 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 Google Cloud console, 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 tâche.

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 la section 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 plus d'informations, 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 : "Hello world!"

11. Cliquez sur Créer.

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

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 tâche.

1. Dans la Google Cloud console, 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.

   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 job Cron a bien été exécutée.

Vous pouvez ensuite vérifier que Pub/Sub a 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 Google Cloud console, accédez à la page Abonnements Pub/Sub.

   Accéder à Pub/Sub

2. Cliquez sur l'abonnement de 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 dans cette démonstration soient facturées sur votre Google Cloud compte pour les ressources utilisées sur cette page, 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 Google Cloud console, 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 :

   Attention : La suppression d'un projet aura les effets suivants :

   • Tout le contenu du projet est supprimé. Si vous avez utilisé un projet existant pour les tâches décrites dans ce document et que vous le supprimez, vous supprimerez également tout autre travail effectué dans le projet.
   • Les ID de projets personnalisés sont perdus. Lorsque vous avez créé ce projet, vous avez peut-être créé un ID de projet personnalisé que vous souhaitez utiliser à l'avenir. Pour conserver les URL qui utilisent l'ID de projet, telle qu'une URL appspot.com, supprimez les ressources sélectionnées dans le projet au lieu de supprimer l'ensemble du projet.

   Si vous envisagez d'explorer plusieurs architectures, tutoriels et guides de démarrage rapide, réutiliser des projets peut vous aider à ne pas dépasser les limites de quotas des projets.

   1. Dans la Google Cloud console, 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 Arrêter pour supprimer le projet.

Étape suivante

• Découvrez Cloud Scheduler.
• Découvrez comment afficher les journaux de Cloud Scheduler.