Configurer des planifications pour les pipelines

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

Azure Pipelines fournit plusieurs types de déclencheurs pour configurer le démarrage de votre pipeline.

• Les déclencheurs planifiés démarrent votre pipeline en fonction d’une planification, telle qu’une build nocturne. Cet article fournit des conseils sur l’utilisation de déclencheurs planifiés pour exécuter vos pipelines en fonction d’une planification.
• Les déclencheurs basés sur des événements démarrent votre pipeline en réponse à des événements, tels que la création d’une demande de tirage (pull request) ou l’envoi (push) vers une branche. Pour plus d’informations sur l’utilisation de déclencheurs basés sur des événements, consultez Déclencheurs dans Azure Pipelines.

Vous pouvez combiner des déclencheurs planifiés et basés sur des événements dans vos pipelines, par exemple pour valider la génération chaque fois qu’un push est effectué (déclencheur CI), lorsqu’une demande de tirage (déclencheur de tirage) est effectuée et qu’une génération nocturne (déclencheur planifié). Si vous souhaitez générer votre pipeline uniquement selon une planification, et non en réponse aux déclencheurs basés sur des événements, vérifiez que votre pipeline n’a pas d’autres déclencheurs activés. Par exemple, les pipelines YAML dans un référentiel GitHub ont des déclencheurs CI et des déclencheurs de demande de tirage activés par défaut. Pour plus d’informations sur la désactivation des déclencheurs par défaut, consultez Déclencheurs dans Azure Pipelines et accédez à la section qui couvre votre type de référentiel.

Déclencheurs planifiés

schedules:
- cron: string # cron syntax defining a schedule
  displayName: string # friendly name given to a specific schedule
  branches:
    include: [ string ] # which branches the schedule applies to
    exclude: [ string ] # which branches to exclude from the schedule
  always: boolean # whether to always run the pipeline or only if there have been source code or pipeline settings changes since the last successful scheduled run. The default is false.
  batch: boolean # Whether to run the pipeline if the previously scheduled run is in-progress; the default is false.
  # batch is available in Azure DevOps Server 2022.1 and higher

# YAML file in the main branch
schedules:
- cron: '0 0 * * *'
  displayName: Daily midnight build
  branches:
    include:
    - main

# YAML file in the new-feature-branch
schedules:
- cron: '0 0 * * *'
  displayName: Daily midnight build
  branches:
    include:
    - main
    - new-feature

# YAML file in the release branch
schedules:
- cron: '0 0 * * *'
  displayName: Daily midnight build
  branches:
    include:
    - main

# YAML file in the main branch with release added to the branches list
schedules:
- cron: '0 0 * * *'
  displayName: Daily midnight build
  branches:
    include:
    - main
    - release

- stage: stage1
  # Run this stage only when the pipeline is triggered by the 
  # "Daily midnight build" cron schedule
  condition: eq(variables['Build.CronSchedule.DisplayName'], 'Daily midnight build')

Examples

schedules:
- cron: '0 0 * * *'
  displayName: Daily midnight build
  branches:
    include:
    - main
    - releases/*
    exclude:
    - releases/ancient/*
- cron: '0 12 * * 0'
  displayName: Weekly Sunday build
  branches:
    include:
    - releases/*
  always: true

mm HH DD MM DW
 \  \  \  \  \__ Days of week
  \  \  \  \____ Months
   \  \  \______ Days
    \  \________ Hours
     \__________ Minutes

Build a UTC cron expression for Monday, Wednesday, and Friday at 6:00 PM Eastern Standard Time

Convert the following cron expression from Eastern Standard Time to UTC: 0 18 * * Mon,Wed,Fri

Build a UTC cron expression for Monday through Friday at 12:30 AM Central European Standard Time

Build a UTC cron expression for Monday through Friday at 12:30 AM Central European Standard Time and explain the different parts of the cron expression

Vue Exécutions planifiées

schedules:
- cron: '0 0 * * *'
  displayName: Daily midnight build
  branches:
    include:
    - main

Exécution même en l’absence de modifications de code

Par défaut, votre pipeline ne s’exécute pas comme prévu s’il n’y a pas eu de modifications de code depuis la dernière exécution planifiée réussie. Par exemple, pensez à planifier l’exécution d’un pipeline tous les soirs à 19h00. Pendant les jours de semaine, vous envoyez plusieurs modifications à votre code. Le pipeline s’exécute selon la planification. Pendant les week-ends, vous n’apportez aucune modification à votre code. Si aucun code n’a été modifié depuis l’exécution planifiée le vendredi, le pipeline ne s’exécute pas comme prévu pendant le week-end.

schedules:
- cron: ...
  ...
  always: true

Migration à partir de l’éditeur classique

Les exemples suivants vous montrent comment migrer vos planifications de l’éditeur classique vers YAML.

• Exemple : Build nocturne du référentiel Git dans plusieurs fuseaux horaires
• Exemple : Génération nocturne avec différentes fréquences

Exemple : Build nocturne du référentiel Git dans plusieurs fuseaux horaires

Dans cet exemple, le déclencheur planifié de l’éditeur classique comporte deux entrées, produisant les builds suivantes.

• Tous les lundis - vendredi à 3h00 (UTC + 5:30 fuseau horaire), créez des branches qui répondent aux critères de features/india/* filtre de branche

  

• Tous les lundis - vendredi à 3h00 (UTC - 5:00 fuseau horaire), créez des branches qui répondent aux critères de features/nc/* filtre de branche

  

Le déclencheur planifié YAML équivalent est le suivant :

schedules:
- cron: '30 21 * * Sun-Thu'
  displayName: M-F 3:00 AM (UTC + 5:30) India daily build
  branches:
    include:
    - /features/india/*
- cron: '0 8 * * Mon-Fri'
  displayName: M-F 3:00 AM (UTC - 5) NC daily build
  branches:
    include:
    - /features/nc/*

Dans la première planification, M-F 3:00 (UTC + 5:30) Build quotidienne inde, la syntaxe cron (mm HH DD MM DW) est 30 21 * * Sun-Thu.

• Minutes et heures - 30 21 Cette valeur est mappée à 21:30 UTC (9:30 PM UTC). Étant donné que le fuseau horaire spécifié dans l’éditeur classique est UTC + 5:30, nous devons soustraire 5 heures et 30 minutes de l’heure de génération souhaitée de 3:00 pour arriver à l’heure UTC souhaitée pour spécifier pour le déclencheur YAML. Vous pouvez obtenir de l’aide sur l’IA de GitHub Copilot pour créer votre expression cron.
• Les jours et les mois sont spécifiés comme caractères génériques, car cette planification ne spécifie pas de s’exécuter uniquement sur certains jours du mois ou sur un mois spécifique.
• Jours de la semaine - Sun-Thu en raison de la conversion du fuseau horaire, pour que nos builds s’exécutent à 3:00 dans le fuseau horaire UTC + 5:30 Inde, nous devons spécifier leur démarrage le jour précédent dans l’heure UTC. Nous pourrions également spécifier les jours de la semaine en tant que 0-4 ou 0,1,2,3,4.

Dans la deuxième planification, la build quotidienne M-F 3:00 (UTC - 5) NC, la syntaxe cron est 0 8 * * Mon-Fri.

• Minutes et heures - 0 8 Cette opération est mappée à 8:00 AM UTC. Étant donné que le fuseau horaire spécifié dans l’éditeur classique est UTC - 5:00, nous devons ajouter 5 heures à partir de l’heure de génération souhaitée de 3:00 pour arriver à l’heure UTC souhaitée pour spécifier pour le déclencheur YAML. Vous pouvez obtenir de l’aide sur l’IA de GitHub Copilot pour créer votre expression cron.
• Les jours et les mois sont spécifiés comme caractères génériques, car cette planification ne spécifie pas de s’exécuter uniquement sur certains jours du mois ou sur un mois spécifique.
• Jours de la semaine - Mon-Fri Étant donné que nos conversions de fuseau horaires ne s’étendent pas sur plusieurs jours de la semaine pour notre planification souhaitée, nous n’avons pas besoin d’effectuer de conversion ici. Nous pourrions également spécifier les jours de la semaine en tant que 1-5 ou 1,2,3,4,5.

Exemple : Génération nocturne avec différentes fréquences

Dans cet exemple, le déclencheur planifié de l’éditeur classique comporte deux entrées, produisant les builds suivantes.

• Tous les lundis - vendredi à 3h00 UTC, créez des branches qui répondent aux critères de filtre de branche et main de releases/* branche

  

• Tous les dimanches à 3h00 UTC, générez la releases/lastversion branche, même si la source ou le pipeline n’a pas changé

  

Le déclencheur planifié YAML équivalent est le suivant :

schedules:
- cron: '0 3 * * Mon-Fri'
  displayName: M-F 3:00 AM (UTC) daily build
  branches:
    include:
    - main
    - /releases/*
- cron: '0 3 * * Sun'
  displayName: Sunday 3:00 AM (UTC) weekly latest version build
  branches:
    include:
    - /releases/lastversion
  always: true

Dans la première planification, M-F 3:00 (UTC) build quotidienne, la syntaxe cron est 0 3 * * Mon-Fri.

• Minutes et heures - 0 3 Cette opération est mappée à 3:00 AM UTC. Étant donné que le fuseau horaire spécifié dans l’éditeur classique est UTC, nous n’avons pas besoin d’effectuer de conversions de fuseau horaire.
• Les jours et les mois sont spécifiés comme caractères génériques, car cette planification ne spécifie pas de s’exécuter uniquement sur certains jours du mois ou sur un mois spécifique.
• Jours de la semaine : Mon-Fri étant donné qu’il n’y a pas de conversion de fuseau horaire, les jours de la semaine correspondent directement à la planification de l’éditeur classique. Nous pourrions également spécifier les jours de la semaine en tant que 1,2,3,4,5.

Dans la deuxième planification, dimanche 3:00 (UTC) la dernière version hebdomadaire, la syntaxe cron est 0 3 * * Sun.

• Minutes et heures - 0 3 Cette opération est mappée à 3:00 AM UTC. Étant donné que le fuseau horaire spécifié dans l’éditeur classique est UTC, nous n’avons pas besoin d’effectuer de conversions de fuseau horaire.
• Les jours et les mois sont spécifiés comme caractères génériques, car cette planification ne spécifie pas de s’exécuter uniquement sur certains jours du mois ou sur un mois spécifique.
• Jours de la semaine - Sun Étant donné que nos conversions de fuseau horaires ne s’étendent pas sur plusieurs jours de la semaine pour notre planification souhaitée, nous n’avons pas besoin d’effectuer de conversion ici. Nous pourrions également spécifier les jours de la semaine en tant que 0.
• Nous spécifions always: true également, car cette build est planifiée pour s’exécuter si le code source a été mis à jour ou non.

Questions fréquentes (FAQ)

• Je souhaite que mon pipeline s’exécute uniquement selon la planification et non lorsque quelqu’un envoie une modification à une branche
• J’ai défini une planification dans le fichier YAML. Mais ça ne s’est pas exécuté. Que s’est-il passé ?
• Mes planifications YAML fonctionnaient correctement. Mais ils ont cessé de travailler maintenant. Comment déboguer cela ?
• Mon code n’a pas changé, mais une build planifiée est déclenchée. Pourquoi?
• Je vois l’exécution planifiée dans le panneau Exécutions planifiées. Toutefois, elle ne s’exécute pas à ce moment-là. Pourquoi?
• Les planifications définies dans le pipeline YAML fonctionnent pour une branche, mais pas l’autre. Comment résoudre ce problème ?

Je souhaite que mon pipeline s’exécute uniquement selon la planification et non lorsque quelqu’un envoie une modification à une branche

Si vous souhaitez que votre pipeline s’exécute uniquement selon la planification, et non lorsque quelqu’un envoie une modification à une branche ou fusionne une modification vers la branche principale, vous devez désactiver explicitement les déclencheurs CI et PR par défaut sur le pipeline.

Pour désactiver les déclencheurs CI et PR par défaut, ajoutez les instructions suivantes à votre pipeline YAML et vérifiez que vous n’avez pas remplacé les déclencheurs de pipeline YAML avec des déclencheurs d’interface utilisateur.

trigger: none
pr: none

Pour plus d’informations, consultez définition de pr et définition de déclencheur.

J’ai défini une planification dans le fichier YAML. Mais ça ne s’est pas exécuté. Que s’est-il passé ?

• Vérifiez les prochaines exécutions planifiées par Azure Pipelines pour votre pipeline. Vous pouvez trouver ces exécutions en sélectionnant l’action d’exécutions planifiées dans votre pipeline. La liste est filtrée pour vous montrer uniquement les quelques prochaines exécutions au cours des prochains jours. Si cela ne répond pas à vos attentes, c’est probablement le cas que vous avez mal tapé votre planification cron ou que vous n’avez pas la planification définie dans la branche appropriée. Lisez la rubrique ci-dessus pour comprendre comment configurer des planifications. Réévaluez votre syntaxe cron. Toutes les heures des planifications cron sont au format UTC.

• Apportez une petite modification triviale à votre fichier YAML et envoyez cette mise à jour dans votre référentiel. S’il y a eu un problème lors de la lecture des planifications à partir du fichier YAML précédemment, elle doit être corrigée maintenant.

• Si vous avez des planifications définies dans l’interface utilisateur, vos planifications YAML ne sont pas respectées. Vérifiez que vous n’avez pas de planifications d’interface utilisateur en accédant à l’éditeur de votre pipeline, puis en sélectionnant Déclencheurs.

• Il existe une limite quant au nombre d’exécutions que vous pouvez planifier pour un pipeline. En savoir plus sur les limites.

• S’il n’existe aucune modification de votre code, Azure Pipelines peut ne pas démarrer de nouvelles exécutions. Découvrez comment remplacer ce comportement.

Mes planifications YAML fonctionnaient correctement. Mais ils ont cessé de travailler maintenant. Comment déboguer cela ?

• Si vous n’avez pas spécifié always:true, votre pipeline ne sera pas planifié, sauf s’il existe des mises à jour apportées à votre code. Vérifiez s’il y a eu des modifications de code et comment vous avez configuré les planifications.

• Il existe une limite quant au nombre de fois que vous pouvez planifier votre pipeline. Vérifiez si vous avez dépassé ces limites.

• Vérifiez si une personne a activé plus de planifications dans l’interface utilisateur. Ouvrez l’éditeur de votre pipeline, puis sélectionnez Déclencheurs. Si elles définissent des planifications dans l’interface utilisateur, vos planifications YAML ne seront pas respectées.

• Vérifiez si votre pipeline est suspendu ou désactivé. Sélectionnez Paramètres de votre pipeline.

• Vérifiez les prochaines exécutions planifiées par Azure Pipelines pour votre pipeline. Vous pouvez trouver ces exécutions en sélectionnant l’action d’exécutions planifiées dans votre pipeline. Si vous ne voyez pas les planifications attendues, apportez une petite modification triviale à votre fichier YAML et envoyez la mise à jour à votre référentiel. Cela doit resynchroniser les planifications.

• Si vous utilisez GitHub pour stocker votre code, il est possible qu’Azure Pipelines ait été limité par GitHub lorsqu’il a essayé de démarrer une nouvelle exécution. Vérifiez si vous pouvez démarrer une nouvelle exécution manuellement.

Mon code n’a pas changé, mais une build planifiée est déclenchée. Pourquoi?

• Vous avez peut-être activé une option pour toujours exécuter une build planifiée, même s’il n’y a aucune modification de code. Si vous utilisez un fichier YAML, vérifiez la syntaxe de la planification dans le fichier YAML. Si vous utilisez des pipelines classiques, vérifiez si vous avez coché cette option dans les déclencheurs planifiés.

• Vous avez peut-être mis à jour le pipeline de build ou une propriété du pipeline. Cela entraîne la planification d’une nouvelle exécution même si vous n’avez pas mis à jour votre code source. Vérifiez l’historique des modifications dans le pipeline à l’aide de l’éditeur classique.

• Vous avez peut-être mis à jour la connexion de service utilisée pour vous connecter au référentiel. Cela entraîne la planification d’une nouvelle exécution même si vous n’avez pas mis à jour votre code source.

• Azure Pipelines vérifie d’abord s’il existe des mises à jour de votre code. Si Azure Pipelines n’est pas en mesure d’atteindre votre référentiel ou d’obtenir ces informations, il crée une exécution informationnelle. Il s’agit d’une build factice pour vous informer que Azure Pipelines n’est pas en mesure d’atteindre votre référentiel.

• Votre pipeline peut ne pas avoir de build complètement réussie. Pour déterminer s’il faut planifier une nouvelle build ou non, Azure DevOps recherche la dernière build planifiée complètement réussie. S’il n’en trouve pas, il déclenche une nouvelle build planifiée. Les builds planifiées partiellement réussies ne sont pas considérées comme réussies. Par conséquent, si votre pipeline a uniquement des builds partiellement réussies, Azure DevOps déclenche des builds planifiées, même si votre code n’a pas changé.

Je vois l’exécution planifiée dans le panneau Exécutions planifiées. Toutefois, elle ne s’exécute pas à ce moment-là. Pourquoi?

• Le panneau Exécutions planifiées affiche toutes les planifications potentielles. Toutefois, elle ne peut pas s’exécuter réellement, sauf si vous avez effectué des mises à jour réelles du code. Pour forcer l’exécution d’une planification, vérifiez que vous avez défini la propriété always dans le pipeline YAML ou activé l’option pour toujours s’exécuter dans un pipeline classique.

Les planifications définies dans le pipeline YAML fonctionnent pour une branche, mais pas l’autre. Comment résoudre ce problème ?

Les planifications sont définies dans les fichiers YAML et ces fichiers sont associés aux branches. Si vous souhaitez qu’un pipeline soit planifié pour une branche particulière, par exemple features/X, assurez-vous que le fichier YAML de cette branche a la planification cron définie dans celle-ci et qu’il a les inclusions de branche correctes pour la planification. Le fichier YAML dans la features/X branche doit avoir les éléments suivants schedule dans cet exemple :

schedules: 
- cron: '0 12 * * 0'   # replace with your schedule
  branches: 
    include: 
    - features/X  

Pour plus d’informations, consultez Considérations relatives à la branche pour les déclencheurs planifiés.