Démarrage rapide de Cloud Scheduler

Ce guide de démarrage rapide vous explique comment effectuer les opérations Cloud Scheduler de base suivantes :

  • Créer une tâche Cloud Scheduler
  • Définir un calendrier récurrent pour une tâche
  • Spécifiez un sujet Pub/Sub en tant que cible de tâche.
  • Exécuter une tâche
  • Vérifier le bon déroulement de la tâche

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 section Tarification.

Avant de commencer

Utilisez les instructions suivantes pour préparer ce démarrage rapide. Il se peut que vous ayez déjà réalisé certaines de ces étapes.

Installez et configurez l'outil de ligne de commande gcloud :

  1. Installer et initialiser le SDK Cloud

  2. Mettez à jour tous les composants :

     gcloud components update
    

Créer un projet avec une application App Engine

Vous pouvez également utiliser un projet existant, le cas échéant.

  1. Ouvrez un terminal sur la machine sur laquelle vous avez installé le SDK Cloud et créez un projet Cloud :

     gcloud projects create [PROJECT_ID]
    

    PROJECT_ID correspond à l'ID du projet que vous souhaitez créer. Les ID de projet doivent commencer par une lettre minuscule et peuvent comporter des lettres ASCII minuscules, des chiffres ou des traits d'union. Ils doivent comporter entre 6 et 30 caractères.

  2. Configurez gcloud pour utiliser le projet que vous avez choisi :

     gcloud config set project [PROJECT-ID]
    

    PROJECT_ID est l'ID que vous avez défini précédemment.

  3. Créez à présent l'application :

     gcloud app create [--region=REGION]
    

    où [REGION] est l'emplacement dans lequel l'application est exécutée. Sachez que deux emplacements, appelés europe-west et us-central dans les commandes App Engine, sont appelés respectivement europe-west1 et us-central1 dans les commandes Cloud Scheduler.

    Vous pouvez vérifier la région d'une application existante à l'aide de la commande suivante :

     gcloud app describe
    

    La région est répertoriée par locationId. Votre emplacement, par exemple, peut être affiché en tant que locationId: us-central.

    Une fois que vous avez défini une zone pour l'application App Engine, vous ne pouvez pas la modifier.

Activer les fonctionnalités à l'aide de Google Cloud Console :

  1. Activez la facturation pour votre projet.

  2. Activez l'API Cloud Scheduler.

  3. Activer l'API Pub/Sub

Configurer Pub/Sub à l'aide de gcloud :

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

    gcloud pubsub topics create cron-topic
    

    Cette commande crée un sujet appelé "cron-topic". Notez ce nom, vous en aurez besoin dans la suite de ce démarrage rapide.

  2. Créez un abonnement Pub/Sub requis pour afficher les résultats de votre tâche.

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

Créer une tâche

  1. Accédez à la page Cloud Scheduler de la console :

    Cloud Scheduler

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

  3. Attribuez un nom à votre tâche. Vous pouvez éventuellement ajouter une description.

    image

  4. 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. Les développeurs qui connaissent le format Cron d'App Engine peuvent l'utiliser.

  5. Sélectionnez votre fuseau horaire.

  6. Pour le champ Target (Cible), sélectionnez Pub/Sub topic (Sujet Pub/Sub) dans le menu déroulant et saisissez le nom du sujet que vous avez créé précédemment (cron-topic).

  7. Ajoutez une chaîne Payload (Charge utile) à envoyer à votre cible Pub/Sub.

    image

  8. Cliquez sur Créer.

Vous disposez maintenant d'une tâche qui envoie un message à votre sujet Pub/Sub chaque minute. Exécutons la tâche que vous venez de créer.

Exécuter votre tâche

  1. Dans la page Cloud Scheduler de la console qui est ouverte pour votre projet, cliquez sur le bouton Run now (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.

  2. Examinez les résultats qui s'affichent dans la colonne Résultat.

    image

Félicitations ! Vous venez d'afficher dans la console les résultats de l'exécution d'une tâche Cron qui envoie un message à Pub/Sub. Maintenant, vous allez apprendre à vérifier que Pub/Sub a bien reçu le message.

Vérifier les résultats dans Pub/Sub

Pour vérifier que votre sujet Pub/Sub reçoit des messages de votre tâche :

  1. Appelez la commande suivante :

     gcloud pubsub subscriptions pull cron-sub --limit 5
    
  2. Affichez les résultats. Vous devriez voir une sortie semblable à ce qui suit.

     +-------------+----------------+------------+-----------------------------+
     | DATA        | MESSAGE_ID     | ATTRIBUTES | ACK_ID                      |
     +-------------+----------------+------------+-----------------------------+
     | hello cron! | 56344662920621 |            | EkwnGERJUytDCypYEU4EISE-... |
     +-------------+----------------+------------+-----------------------------+
     | hello cron! | 56340561244339 |            | EkwnGERJUytDCypYEU4EISE-... |
     +-------------+----------------+------------+-----------------------------+
     | hello cron! | 56340388879975 |            | EkwnGERJUytDCypYEU4EISE-... |
     +-------------+----------------+------------+-----------------------------+
     | hello cron! | 56337745052761 |            | EkwnGERJUytDCypYEU4EISE...  |
     +-------------+----------------+------------+-----------------------------+
     | hello cron! | 56337890896134 |            | EkwnGERJUytDCypYEU4EISE-... |
     +-------------+----------------+------------+-----------------------------+
    

Nettoyer

Pour éviter que les ressources utilisées dans ce guide démarrage rapide soient facturées sur votre compte Google Cloud :

Supprimer la tâche Cloud Scheduler

  1. Accédez à la page Cloud Scheduler dans Cloud Console.

    Accéder à la page Scheduler

  2. Cochez la case située en regard de votre tâche.

  3. Cliquez sur le bouton Supprimer en haut de la page et confirmez la suppression.

Supprimer le sujet Pub/Sub

  1. Accédez à la page Cloud Pub/Sub dans Cloud Console.

    Accéder à la page Pub/Sub

  2. Cochez la case située en regard de votre sujet.

  3. 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 démarrage rapide :

  1. Dans 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 sur Arrêter pour supprimer le projet.

Étape suivante