Konfigurera scheman för pipelines

Pipelinen körs som standard inte som schemalagd om det inte har gjorts några kodändringar sedan den senaste lyckade schemalagda körningen. Anta till exempel att du har schemalagt att en pipeline ska köras varje kväll klockan 21:00. Under vardagar skickar du olika ändringar i koden. Pipelinen körs enligt schema. Under helgerna gör du inga ändringar i koden. Om det inte har gjorts några kodändringar sedan den schemalagda körningen i fredags körs inte pipelinen som planerat under helgen.

Migrera från den klassiska redigeraren

I följande exempel visas hur du migrerar dina scheman från den klassiska redigeraren till YAML.

• Exempel: Nattligt bygge av Git-lagringsplats i flera tidszoner
• Exempel: Skapa varje natt med olika frekvenser

Exempel: Nattligt bygge av Git-lagringsplats i flera tidszoner

I det här exemplet har den klassiska schemalagda utlösaren för redigeraren två poster som skapar följande versioner.

• Varje måndag – fredag kl. 03:00 (UTC + 5:30 tidszon), skapar grenar som uppfyller villkoret features/india/* för grenfilter

  

• Varje måndag – fredag kl. 03:00 (UTC– 5:00 tidszon) skapar grenar som uppfyller villkoret features/nc/* för grenfilter

  

Motsvarande schemalagda YAML-utlösare är:

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/*

I det första schemat, M-F 03:00 (UTC + 5:30) Indien daglig version, är 30 21 * * Sun-Thucron-syntaxen (mm HH DD MM DW) .

• Minuter och timmar – 30 21 – Detta mappar till 21:30 UTC (9:30 PM UTC). Eftersom den angivna tidszonen i den klassiska redigeraren är UTC + 5:30 måste vi subtrahera 5 timmar och 30 minuter från önskad byggtid på 03:00 för att komma fram till önskad UTC-tid för att ange för YAML-utlösaren.
• Dagar och månader anges som jokertecken eftersom det här schemat inte anger att endast ska köras vissa dagar i månaden eller en viss månad.
• Dagar i veckan – Sun-Thu – på grund av tidszonskonverteringen, för att våra versioner ska köras kl. 03:00 i tidszonen UTC + 5:30 Indien, måste vi ange att de ska startas föregående dag i UTC-tid. Vi kan också ange veckodagarna som 0-4 eller 0,1,2,3,4.

I det andra schemat, M-F 03:00 (UTC – 5) NC daglig version, är 0 8 * * Mon-Fricron-syntaxen .

• Minuter och timmar – 0 8 – Detta mappar till 8:00 AM UTC. Eftersom den angivna tidszonen i den klassiska redigeraren är UTC – 5:00 måste vi lägga till 5 timmar från önskad byggtid på 03:00 för att komma fram till önskad UTC-tid för att ange för YAML-utlösaren.
• Dagar och månader anges som jokertecken eftersom det här schemat inte anger att endast ska köras vissa dagar i månaden eller en viss månad.
• Dagar i veckan – Mon-Fri – Eftersom våra tidszonskonverteringar inte sträcker sig över flera dagar i veckan för önskat schema behöver vi inte göra någon konvertering här. Vi kan också ange veckodagarna som 1-5 eller 1,2,3,4,5.

Exempel: Skapa varje natt med olika frekvenser

I det här exemplet har den klassiska schemalagda utlösaren för redigeraren två poster som skapar följande versioner.

• Varje måndag – fredag kl. 03:00 UTC skapar du grenar som uppfyller main villkoren för grenfilter och releases/* grenfilter

  

• Varje söndag kl. 03:00 UTC skapar du grenen releases/lastversion , även om källan eller pipelinen inte har ändrats

  

Motsvarande schemalagda YAML-utlösare är:

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

I det första schemat, M-F 3:00 AM (UTC) daily build, är 0 3 * * Mon-Fricron-syntaxen .

• Minuter och timmar – 0 3 – Detta mappar till 3:00 AM UTC. Eftersom den angivna tidszonen i den klassiska redigeraren är UTC behöver vi inte göra några tidszonskonverteringar.
• Dagar och månader anges som jokertecken eftersom det här schemat inte anger att endast ska köras vissa dagar i månaden eller en viss månad.
• Veckodagar – – Mon-Fri eftersom det inte finns någon tidszonskonvertering mappar veckodagarna direkt från det klassiska redigeringsschemat. Vi kan också ange veckodagarna som 1,2,3,4,5.

I det andra schemat, söndag 03:00 (UTC) veckovis senaste versionsversion, är 0 3 * * Suncron-syntaxen .

• Minuter och timmar – 0 3 – Detta mappar till 3:00 AM UTC. Eftersom den angivna tidszonen i den klassiska redigeraren är UTC behöver vi inte göra några tidszonskonverteringar.
• Dagar och månader anges som jokertecken eftersom det här schemat inte anger att endast ska köras vissa dagar i månaden eller en viss månad.
• Dagar i veckan – Sun – Eftersom våra tidszonskonverteringar inte sträcker sig över flera dagar i veckan för önskat schema behöver vi inte göra någon konvertering här. Vi kan också ange veckodagarna som 0.
• Vi anger always: true också eftersom den här versionen är schemalagd att köra om källkoden har uppdaterats eller inte.

Vanliga frågor

• Jag vill att min pipeline endast ska köras enligt schemat och inte när någon skickar en ändring till en gren
• Jag definierade ett schema i YAML-filen. Men den sprang inte. Vad hände?
• Mina YAML-scheman fungerade bra. Men de slutade fungera nu. Hur gör jag för att felsöka det här?
• Min kod har inte ändrats, men en schemalagd version utlöses. Varför?
• Jag ser den planerade körningen i panelen Schemalagda körningar. Den körs dock inte vid den tidpunkten. Varför?
• Scheman som definierats i YAML-pipelinen fungerar för en gren men inte den andra. Hur åtgärdar jag detta?

Jag vill att min pipeline endast ska köras enligt schemat och inte när någon skickar en ändring till en gren

Om du bara vill att pipelinen ska köras enligt schemat, och inte när någon skickar en ändring till en gren eller sammanfogar en ändring av huvudgrenen, måste du uttryckligen inaktivera ci- och PR-standardutlösare på pipelinen.

Om du vill inaktivera ci- och PR-standardutlösare lägger du till följande instruktioner i YAML-pipelinen och kontrollerar att du inte har åsidosatt YAML-pipelineutlösare med UI-utlösare.

trigger: none
pr: none

Mer information finns i pr-definition och utlösardefinition.

Jag definierade ett schema i YAML-filen. Men den sprang inte. Vad hände?

• Kontrollera de kommande körningarna som Azure Pipelines har schemalagt för din pipeline. Du hittar dessa körningar genom att välja åtgärden Schemalagda körningar i pipelinen. Listan filtreras ned för att bara visa de kommande körningarna under de närmaste dagarna. Om detta inte uppfyller dina förväntningar är det förmodligen så att du har feltypat cron-schemat, eller så har du inte det schema som definierats i rätt gren. Läs avsnittet ovan för att förstå hur du konfigurerar scheman. Omvärdera cron-syntaxen. Alla tider för cron-scheman finns i UTC.

• Gör en liten trivial ändring av YAML-filen och skicka uppdateringen till lagringsplatsen. Om det uppstod problem med att läsa scheman från YAML-filen tidigare bör det åtgärdas nu.

• Om du har några scheman som definierats i användargränssnittet respekteras inte dina YAML-scheman. Se till att du inte har några gränssnittsscheman genom att gå till redigeraren för din pipeline och sedan välja Utlösare.

• Det finns en gräns för hur många körningar du kan schemalägga för en pipeline. Läs mer om gränser.

• Om koden inte ändras kanske Azure Pipelines inte startar nya körningar. Lär dig hur du åsidosätter det här beteendet.

Mina YAML-scheman fungerade bra. Men de slutade fungera nu. Hur gör jag för att felsöka det här?

• Om du inte angav always:truekommer pipelinen inte att schemaläggas om det inte finns några uppdateringar av koden. Kontrollera om det har gjorts några kodändringar och hur du har konfigurerat schemana.

• Det finns en gräns för hur många gånger du kan schemalägga din pipeline. Kontrollera om du har överskridit dessa gränser.

• Kontrollera om någon har aktiverat fler scheman i användargränssnittet. Öppna redigeraren för pipelinen och välj Utlösare. Om de har definierat scheman i användargränssnittet kommer dina YAML-scheman inte att uppfyllas.

• Kontrollera om pipelinen är pausad eller inaktiverad. Välj Inställningar för din pipeline.

• Kontrollera de kommande körningarna som Azure Pipelines har schemalagt för din pipeline. Du hittar dessa körningar genom att välja åtgärden Schemalagda körningar i pipelinen. Om du inte ser de scheman som du förväntade dig gör du en liten trivial ändring av YAML-filen och push-överför uppdateringen till lagringsplatsen. Detta bör synkronisera om schemana.

• Om du använder GitHub för att lagra din kod är det möjligt att Azure Pipelines kan ha begränsats av GitHub när den försökte starta en ny körning. Kontrollera om du kan starta en ny körning manuellt.

Min kod har inte ändrats, men en schemalagd version utlöses. Varför?

• Du kan ha aktiverat ett alternativ för att alltid köra en schemalagd version även om det inte finns några kodändringar. Om du använder en YAML-fil kontrollerar du syntaxen för schemat i YAML-filen. Om du använder klassiska pipelines kontrollerar du om du har markerat det här alternativet i de schemalagda utlösarna.

• Du kan ha uppdaterat bygg-pipelinen eller någon egenskap för pipelinen. Detta gör att en ny körning schemaläggs även om du inte har uppdaterat källkoden. Kontrollera historiken för ändringar i pipelinen med hjälp av den klassiska redigeraren.

• Du kan ha uppdaterat tjänstanslutningen som används för att ansluta till lagringsplatsen. Detta gör att en ny körning schemaläggs även om du inte har uppdaterat källkoden.

• Azure Pipelines kontrollerar först om det finns några uppdateringar av koden. Om Azure Pipelines inte kan nå din lagringsplats eller hämta den här informationen skapar den en informationskörning. Det är en dummy-version som låter dig veta att Azure Pipelines inte kan nå din lagringsplats.

• Din pipeline kanske inte har en helt lyckad version. För att avgöra om en ny version ska schemaläggas eller inte letar Azure DevOps upp den senaste helt lyckade schemalagda versionen. Om den inte hittar någon utlöser den en ny schemalagd version. Delvis lyckade schemalagda versioner anses inte vara lyckade, så om din pipeline bara har delvis lyckade versioner utlöser Azure DevOps schemalagda versioner, även om koden inte har ändrats.

Jag ser den planerade körningen i panelen Schemalagda körningar. Den körs dock inte vid den tidpunkten. Varför?

• Panelen Schemalagda körningar visar alla potentiella scheman. Men den kanske inte körs om du inte har gjort verkliga uppdateringar av koden. Om du vill tvinga ett schema att alltid köras kontrollerar du att du har angett egenskapen always i YAML-pipelinen eller kontrollerat alternativet att alltid köras i en klassisk pipeline.

Scheman som definierats i YAML-pipelinen fungerar för en gren men inte den andra. Hur åtgärdar jag detta?

Scheman definieras i YAML-filer och dessa filer är associerade med grenar. Om du vill att en pipeline ska schemaläggas för en viss gren, till exempel features/X, kontrollerar du att YAML-filen i den grenen har cron-schemat definierat i den och att den har rätt greninkluderingar för schemat. YAML-filen i grenen features/X bör ha följande schedule i det här exemplet:

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

Mer information finns i Branch considerations for scheduled triggers (Grenöverväganden för schemalagda utlösare).