Créer des déclencheurs planifiés

Cette page explique comment exécuter des compilations selon un calendrier prédéfini à l'aide de Google Cloud Console. Pour planifier des compilations, vous devez créer un déclencheur manuel, puis appeler le déclencheur à l'aide de Cloud Scheduler.

Avant de commencer

  • Activez l'API Cloud Build

    Activer l'API

  • Préparez votre code source.
  • Si ce n'est pas déjà fait, créez un déclencheur manuel. Vous ne pouvez planifier des builds que si votre déclencheur est un déclencheur manuel.

Planifier des compilations

Pour planifier votre compilation:

  1. Ouvrez la page Déclencheurs :

    Ouvrir la page Déclencheurs

  2. Localisez la ligne contenant le nom du déclencheur manuel que vous souhaitez exécuter selon le calendrier.

  3. Cliquez sur le menu (trois points alignés verticalement) situé à l'extrémité droite de la ligne contenant votre déclencheur.

  4. Cliquez sur Exécuter selon un planning pour planifier la compilation.

    Le panneau Exécuter le déclencheur selon un planning s'affiche alors sur le côté droit.

  5. Activez l'API Cloud Scheduler.

    Vous serez invité à activer l'API Cloud Scheduler la première fois que vous planifiez une compilation.

  6. Sélectionnez le compte de service que Cloud Scheduler doit utiliser lors de l'appel du déclencheur.

    Nous vous recommandons de sélectionner le compte de service de planification par défaut, qui a le format suivant, où PROJECT_ID correspond à l'ID de votre projet:

     cloud-build-trigger-scheduler@PROJECT_ID.iam.gserviceaccount.com
    

    Lorsque vous sélectionnez le compte de service de planification par défaut, il est automatiquement créé avec le rôle IAM Éditeur Cloud Build attribué. Nous vous recommandons de ne pas supprimer ce compte de service, car il est utilisé par Cloud Scheduler pour planifier les compilations. Si vous supprimez accidentellement ce compte de service ou révoquez l'une de ses autorisations IAM, vous pouvez accéder à la page IAM pour ajouter manuellement le compte de service et lui accorder le rôle Éditeur Cloud Build Vous devrez peut-être attendre une heure avant que les tâches Cloud Scheduler existantes reprennent après la recréation du compte de service.

  7. Cliquez sur Continuer.

    Si vous n'avez pas sélectionné de région, vous pouvez être invité à en sélectionner une pour vos tâches Cloud Scheduler avant de passer à l'étape suivante. Lorsque vous sélectionnez une région, une application App Engine est automatiquement créée dans votre projet. Vous ne pourrez pas modifier la région de votre projet ultérieurement. Pour en savoir plus, consultez la section Régions compatibles.

  8. Saisissez les paramètres de tâche Cloud Scheduler suivants :

    • Nom : nom de votre tâche Cloud Scheduler.
    • Description (facultatif) : description de votre tâche Cloud Scheduler.
    • Fréquence : sélectionnez la fréquence à laquelle vous souhaitez que le déclencheur s'exécute. Vous pouvez choisir une fréquence dans le menu déroulant ou saisir une valeur personnalisée à l'aide de la syntaxe Cron. Par exemple, si vous souhaitez que votre déclencheur manuel s'exécute chaque jour à 6 h 00, vous pouvez en spécifier la fréquence selon la syntaxe Cron avec 0 6 * * *. Pour en savoir plus sur la syntaxe Cron, consultez la page Configurer la planification de tâches Cron.
    • Fuseau horaire : sélectionnez votre fuseau horaire.
  9. Cliquez sur Créer pour créer votre tâche Cloud Scheduler.

    Vous pouvez créer plusieurs tâches planifiées pour chaque déclencheur manuel.

  10. Si vous souhaitez afficher la tâche Cloud Scheduler, cliquez sur View (Afficher). Sinon, cliquez sur Terminé pour fermer le panneau.

Mettre à jour votre tâche Cloud Scheduler

Si vous mettez à jour le champ Révision dans votre déclencheur manuel, vous devez mettre à jour manuellement la tâche Cloud Scheduler associée à votre déclencheur. Par exemple, si vous mettez à jour le nom de la branche de votre déclencheur manuel, vous devrez mettre à jour manuellement le nom de la branche de votre tâche.

Pour mettre à jour votre tâche Cloud Scheduler:

  1. Ouvrir la page Cloud Scheduler

    Ouvrir la page Cloud Scheduler

    La liste de vos tâches Cloud Scheduler s'affiche.

  2. [Facultatif] Identifiez la tâche Cloud Scheduler associée à votre déclencheur:

    1. Pour obtenir l'ID du déclencheur, exécutez la commande suivante, où TRIGGER_NAME correspond au nom du déclencheur.

      gcloud beta builds triggers describe TRIGGER_NAME
      
    2. Prenez note de votre ID de déclencheur.

    3. Saisissez l'ID de votre déclencheur dans la barre de filtre en haut du tableau.

    La liste des tâches Cloud Scheduler associées à votre déclencheur s'affiche.

  3. Cliquez sur la ligne contenant le nom de la tâche à mettre à jour.

  4. Cliquez sur Modifier en haut de la page.

    Un formulaire permettant de mettre à jour votre tâche Cloud Scheduler s'affiche.

  5. Dans le champ Corps, mettez à jour votre révision.

  6. Cliquez sur Mettre à jour.

Vous avez maintenant mis à jour la révision associée à votre déclencheur pour votre tâche Cloud Scheduler.

Supprimer une tâche Cloud Scheduler

La suppression ou la désactivation de votre déclencheur ne supprime pas automatiquement toutes les tâches Cloud Scheduler créées automatiquement lors de la planification. déclencheur. Vos tâches existent et les compilations peuvent continuer à être appelées.

Pour vous assurer que votre déclencheur ne s'exécutera plus à une heure spécifiée, supprimez votre tâche Cloud Scheduler.

Étapes suivantes