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 l'appeler à l'aide de Cloud Scheduler.

Avant de commencer

  • Activez l'API Cloud Build.

    Activer l'API

Planifier des compilations

Pour planifier votre compilation, procédez comme suit:

  1. Ouvrez la page Déclencheurs :

    Ouvrir la page Déclencheurs

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

  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 de votre déclencheur.

    Nous vous recommandons de sélectionner le compte de service de planification par défaut, qui utilise 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 Éditeur Cloud Build. Vous devrez peut-être attendre jusqu'à une heure pour que les tâches Cloud Scheduler existantes redémarrent après la recréation du compte de service.

  7. Cliquez sur Continuer.

    Si aucune région n'est sélectionnée, vous pouvez être invité à le faire 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 pouvez pas modifier la région de votre projet ultérieurement. Pour en savoir plus, consultez la section Régions où le service est disponible.

  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 tous les jours à 6h du matin, vous pouvez spécifier votre fréquence dans la syntaxe Cron au format suivant : 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 de planification pour chaque déclencheur manuel.

  10. Si vous souhaitez afficher la tâche Cloud Scheduler, cliquez sur Afficher. Sinon, cliquez sur OK pour fermer le panneau.

Mettre à jour votre tâche Cloud Scheduler

Si vous mettez à jour le champ Révision de 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 pour votre déclencheur manuel, vous devez modifier manuellement le nom de la branche dans votre tâche.

Pour mettre à jour votre tâche Cloud Scheduler, procédez comme suit:

  1. Ouvrez 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. Obtenez l'ID de votre déclencheur en exécutant la commande suivante, où TRIGGER_NAME correspond au nom de votre 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 que vous souhaitez mettre à jour.

  4. Cliquez sur Modifier en haut de la page.

    Un formulaire vous permet de mettre à jour votre tâche Cloud Scheduler.

  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 votre tâche Cloud Scheduler

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

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

Étapes suivantes