Configurer des planifications pour les pipelines

Par défaut, votre pipeline ne s’exécute pas comme prévu s’il n’y a eu aucune modification du code depuis la dernière exécution planifiée réussie. Par exemple, supposons que vous planifiez l’exécution d’un pipeline tous les soirs à 21h00. Pendant les jours de la semaine, vous envoyez diverses modifications à votre code. Le pipeline s’exécute conformément à la planification. Pendant les week-ends, vous n’apportez aucune modification à votre code. S’il n’y a pas eu de modifications de code depuis l’exécution planifiée le vendredi, le pipeline ne s’exécute pas comme prévu pendant le week-end.

Migration à partir de l’éditeur classique

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

• Exemple : build nocturne de dépôt Git sur plusieurs fuseaux horaires
• Exemple : build nocturne avec différentes fréquences

Exemple : build nocturne de dépôt Git sur plusieurs fuseaux horaires

Dans cet exemple, le déclencheur planifié de l’éditeur classique a deux entrées, ce qui produit les builds suivantes.

• Tous les lundis - vendredis à 03h00 (UTC + 5h30), générer des branches qui répondent aux critères de filtre de branche features/india/*

  

• Tous les lundis - vendredis à 03h00 (UTC - 5h), générer des branches qui répondent aux critères de filtre de branche features/nc/*

  

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, Build quotidienne pour l’Inde M-F 3:00 AM (UTC + 5:30), la syntaxe cron (mm HH DD MM DW) est 30 21 * * Sun-Thu.

• Minutes et heures - 30 21 - Mappé sur 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 build souhaitée de 3:00 AM pour arriver à l’heure UTC souhaitée à spécifier pour le déclencheur YAML.
• Les jours et les mois sont spécifiés en tant que caractères génériques, car cette planification ne spécifie pas de s’exécuter uniquement lors de certains jours du mois ou d’un mois spécifique.
• Jours de la semaine - Sun-Thu - en raison de la conversion de fuseau horaire, pour que nos builds s’exécutent à 3:00 AM dans le fuseau horaire UTC + 5:30 en Inde, nous devons spécifier leur démarrage le jour précédent en heure UTC. Nous pouvons également spécifier les jours de la semaine comme 0-4 ou 0,1,2,3,4.

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

• Minutes et heures - 0 8 - Mappé sur 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 build souhaitée de 3:00 AM pour arriver à l’heure UTC souhaitée à spécifier pour le déclencheur YAML.
• Les jours et les mois sont spécifiés en tant que caractères génériques, car cette planification ne spécifie pas de s’exécuter uniquement lors de certains jours du mois ou d’un mois spécifique.
• Jours de la semaine - Mon-Fri - étant donné que nos conversions de fuseau horaire ne s’étendent pas sur plusieurs jours de la semaine pour notre planification souhaitée, nous n’avons pas besoin d’effectuer une conversion ici. Nous pouvons également spécifier les jours de la semaine comme 1-5 ou 1,2,3,4,5.

Exemple : build nocturne avec différentes fréquences

Dans cet exemple, le déclencheur planifié de l’éditeur classique a deux entrées, ce qui produit les builds suivantes.

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

  

• Tous les dimanches à 3h00 UTC, créez la branche releases/lastversion, 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 AM (UTC), la syntaxe cron est 0 3 * * Mon-Fri.

• Minutes et heures - 0 3 - Mappé sur 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 en tant que caractères génériques, car cette planification ne spécifie pas de s’exécuter uniquement lors de certains jours du mois ou d’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 sont mappés directement à partir de la planification de l’éditeur classique. Nous pouvons également spécifier les jours de la semaine comme 1,2,3,4,5.

Dans la deuxième planification, Build hebdomadaire de la version la plus récente le dimanche à 3:00 AM (UTC), la syntaxe cron est 0 3 * * Sun.

• Minutes et heures - 0 3 - Mappé sur 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 en tant que caractères génériques, car cette planification ne spécifie pas de s’exécuter uniquement lors de certains jours du mois ou d’un mois spécifique.
• Jours de la semaine - Sun - étant donné que nos conversions de fuseau horaire ne s’étendent pas sur plusieurs jours de la semaine pour notre planification souhaitée, nous n’avons pas besoin d’effectuer une conversion ici. Nous pouvons également spécifier les jours de la semaine comme 0.
• Nous spécifions également always: true, étant donné que cette build est planifiée pour s’exécuter, que le code source ait été mis à jour ou non.

FAQ

• Je veux que mon pipeline s’exécute uniquement selon la planification et pas quand quelqu’un envoie une modification à une branche
• J’ai défini une planification dans le fichier YAML. Mais elle n’a pas été exécutée. Que s’est-il passé ?
• Mes plannings YAML fonctionnaient correctement. Mais ils ont cessé de travailler maintenant. Comment puis-je corriger cette erreur ?
• 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 pour l’autre. Comment la corriger ?

Je veux que mon pipeline s’exécute uniquement selon la planification et pas quand quelqu’un envoie une modification à une branche

Si vous souhaitez que votre pipeline s’exécute uniquement selon la planification, et non pas lorsque quelqu’un envoie (push) une modification à une branche ou fusionne une modification dans la branche primaire, 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 par des déclencheurs d’interface utilisateur.

trigger: none
pr: none

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

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

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

• Apportez une petite modification triviale à votre fichier YAML et envoyez cette mise à jour dans votre dépôt. S’il y a eu un problème lors de la lecture des planifications à partir du fichier YAML précédemment, il doit être résolu 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 aucune planification d’interface utilisateur en accédant à l’éditeur de votre pipeline, puis en sélectionnant Déclencheurs.

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

• Si aucune modification n’est apportée à votre code, il se peut qu’Azure Pipelines ne démarre pas de nouvelles exécutions. Découvrez comment remplacer ce comportement.

Mes plannings YAML fonctionnaient correctement. Mais ils ont cessé de travailler maintenant. Comment puis-je corriger cette erreur ?

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

• Le nombre de fois où vous pouvez planifier votre pipeline est limité. Vérifiez si vous avez dépassé ces limites.

• Vérifiez si quelqu’un a activé d’autres planifications dans l’interface utilisateur. Ouvrez l’éditeur de votre pipeline, puis sélectionnez Déclencheurs. Si quelqu’un a défini 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 pour votre pipeline.

• Vérifiez les exécutions suivantes qu’Azure Pipelines a planifiées pour votre pipeline. Vous pouvez trouver ces exécutions en sélectionnant l’action 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 dépôt. Cela devrait 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 tenté 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 du 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 activé 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 dépôt. 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 ne parvient pas à atteindre votre dépôt ou à obtenir ces informations, il crée une exécution informationnelle. Il s’agit d’une build factice pour vous informer qu’Azure Pipelines ne peut pas atteindre votre dépôt.

• Votre pipeline n’a peut-être pas une build complètement réussie. Pour déterminer s’il faut ou non planifier une nouvelle build, 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 n’a que 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, la planification peut ne pas s’exécuter, 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 que vous avez 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 pour l’autre. Comment la corriger ?

Les planifications sont définies dans les fichiers YAML, et ces fichiers sont associés à des 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 contient la planification cron définie et qu’il contient les inclusions de branche appropriées pour la planification. Dans cet exemple, le fichier YAML de la branche features/X doit avoir le schedule suivant :

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

Pour plus d’informations, consultez Considérations relatives aux branches pour les déclencheurs planifiés.