Konfigurace plánů pro kanály

Ve výchozím nastavení se kanál nespustí podle plánu, pokud od posledního úspěšného naplánovaného spuštění nedošlo k žádným změnám kódu. Představte si například, že jste naplánovali spuštění kanálu každou noc v 9:00. Během pracovních dnů nasdílíte do kódu různé změny. Kanál se spouští podle plánu. Během víkendů neproděláte žádné změny kódu. Pokud od naplánovaného spuštění v pátek nedošlo k žádným změnám kódu, kanál se během víkendu nespustí podle plánu.

Migrace z klasického editoru

Následující příklady ukazují, jak migrovat plány z klasického editoru do YAML.

• Příklad: Noční sestavení úložiště Git ve více časových pásmech
• Příklad: Noční sestavení s různými frekvencemi

Příklad: Noční sestavení úložiště Git ve více časových pásmech

V tomto příkladu má naplánovaný trigger klasického editoru dvě položky, které vytvářejí následující sestavení.

• Každé pondělí – pátek v 3:00 (UTC + 5:30 časové pásmo), větve sestavení, které splňují features/india/* kritéria filtru větví

  

• Každé pondělí až pátek v 3:00 (UTC – 5:00 časového pásma) sestavte větve, které splňují features/nc/* kritéria filtru větví.

  

Ekvivalentní naplánovaná aktivační událost YAML je:

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

V prvním plánu M-F 3:00 (UTC + 5:30) Indie denní sestavení, syntaxe cron (mm HH DD MM DW) je 30 21 * * Sun-Thu.

• Minuty a hodiny – 30 21 to se mapuje na 21:30 UTC (9:30 PM UTC). Vzhledem k tomu, že zadané časové pásmo v klasickém editoru je UTC + 5:30, musíme odečíst 5 hodin a 30 minut od požadovaného času sestavení 3:00, aby bylo možné zadat požadovaný čas UTC pro trigger YAML.
• Dny a měsíce se zadávají jako zástupné dny, protože tento plán nezadá, aby běžel jenom v určitých dnech v měsíci nebo v určitém měsíci.
• Dny v týdnu – Sun-Thu kvůli převodu časového pásma musí naše buildy běžet v 3:00 v časovém pásmu UTC + 5:30 Indie, musíme je zadat od předchozího dne v čase UTC. Mohli bychom také určit dny v týdnu jako 0-4 nebo 0,1,2,3,4.

V druhém plánu je syntaxe 0 8 * * Mon-Fricron 3:00 (UTC - 5) NC denní sestavení nc .

• Minuty a hodiny - 0 8 to se mapuje na 8:00 AM UTC. Vzhledem k tomu, že zadané časové pásmo v klasickém editoru je UTC – 5:00, musíme přidat 5 hodin od požadovaného času sestavení 3:00, aby se dostavil požadovaný čas UTC, abychom určili aktivační událost YAML.
• Dny a měsíce se zadávají jako zástupné dny, protože tento plán nezadá, aby běžel jenom v určitých dnech v měsíci nebo v určitém měsíci.
• Dny v týdnu – Mon-Fri protože naše převody časových pásem nepřesahují více dnů v týdnu pro požadovaný plán, nemusíme tady provádět žádné převody. Mohli bychom také určit dny v týdnu jako 1-5 nebo 1,2,3,4,5.

Příklad: Noční sestavení s různými frekvencemi

V tomto příkladu má naplánovaný trigger klasického editoru dvě položky, které vytvářejí následující sestavení.

• Každé pondělí – pátek v 3:00 UTC, sestavte větve, které splňují main releases/* kritéria filtru a větve.

  

• Každou neděli v 3:00 UTC sestavte releases/lastversion větev, i když se zdroj nebo kanál nezměnil.

  

Ekvivalentní naplánovaná aktivační událost YAML je:

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

V prvním plánu je 0 3 * * Mon-Frisyntaxe cron syntaxe M-F 3:00 (UTC) denně .

• Minuty a hodiny - 0 3 to se mapuje na 3:00 AM UTC. Vzhledem k tomu, že zadané časové pásmo v klasickém editoru je UTC, nemusíme provádět žádné převody časových pásem.
• Dny a měsíce se zadávají jako zástupné dny, protože tento plán nezadá, aby běžel jenom v určitých dnech v měsíci nebo v určitém měsíci.
• Dny v týdnu – Mon-Fri protože neexistuje žádný převod časového pásma, mapa dnů v týdnu přímo z klasického plánu editoru. Mohli bychom také zadat dny v týdnu jako 1,2,3,4,5.

Ve druhém plánu, neděle 3:00 (UTC) týdenní nejnovější verze sestavení, syntaxe cron je 0 3 * * Sun.

• Minuty a hodiny - 0 3 to se mapuje na 3:00 AM UTC. Vzhledem k tomu, že zadané časové pásmo v klasickém editoru je UTC, nemusíme provádět žádné převody časových pásem.
• Dny a měsíce se zadávají jako zástupné dny, protože tento plán nezadá, aby běžel jenom v určitých dnech v měsíci nebo v určitém měsíci.
• Dny v týdnu – Sun protože naše převody časových pásem nepřesahují více dnů v týdnu pro požadovaný plán, nemusíme tady provádět žádné převody. Mohli bychom také zadat dny v týdnu jako 0.
• Také určíme always: true , že je toto sestavení naplánované tak, aby se spustilo, jestli byl zdrojový kód aktualizován nebo ne.

Často kladené dotazy

• Chci, aby kanál běžel jenom podle plánu, a ne v případě, že někdo nasdílí změnu do větve
• V souboru YAML jsem definoval plán. Ale nešlo to. Co se stalo?
• Plány YAML fungovaly dobře. Ale teď přestali pracovat. Návody to ladit?
• Kód se nezměnil, ale naplánované sestavení se aktivuje. Proč?
• Na panelu Naplánovaná spuštění se zobrazuje naplánované spuštění. V tu chvíli se ale nespustí. Proč?
• Plány definované v kanálu YAML fungují pro jednu větev, ale ne pro druhou. Jak to můžu vyřešit?

Chci, aby kanál běžel jenom podle plánu, a ne v případě, že někdo nasdílí změnu do větve

Pokud chcete, aby váš kanál běžel jenom podle plánu, a ne když někdo nasdílí změnu do větve nebo sloučí změnu do hlavní větve, musíte v kanálu explicitně zakázat výchozí aktivační události CI a PR.

Pokud chcete zakázat výchozí triggery CI a PR, přidejte do kanálu YAML následující příkazy a ověřte, že jste nepřepsali triggery kanálu YAML pomocí triggerů uživatelského rozhraní.

trigger: none
pr: none

Další informace najdete v definici žádosti o přijetí změn a definici triggeru.

V souboru YAML jsem definoval plán. Ale nešlo to. Co se stalo?

• Zkontrolujte několik dalších spuštění, která pro váš kanál naplánovala služba Azure Pipelines. Tato spuštění najdete tak , že v kanálu vyberete akci Naplánovaná spuštění . Seznam se vyfiltruje tak, aby zobrazoval jen nadcházející několik spuštění za několik příštích dnů. Pokud to nesplňuje vaše očekávání, pravděpodobně se jedná o případ, že jste nesprávně zadali plán cron nebo nemáte plán definovaný ve správné větvi. Přečtěte si výše uvedené téma, ve které se dozvíte, jak nakonfigurovat plány. Znovu vyhodnocete syntaxi cron. Všechny časy pro plány cron jsou ve standardu UTC.

• Proveďte malou triviální změnu souboru YAML a nasdílejte ji do úložiště. Pokud při čtení plánů ze souboru YAML dříve došlo k nějakému problému, měli byste ho opravit.

• Pokud máte v uživatelském rozhraní definované nějaké plány, nebudou se vaše plány YAML respektovat. Ujistěte se, že nemáte žádné plány uživatelského rozhraní, a to tak, že přejdete do editoru pro váš kanál a vyberete Triggery.

• Počet spuštění, která můžete naplánovat pro kanál, je omezený. Přečtěte si další informace o limitech.

• Pokud kód neobsahuje žádné změny, nemusí azure Pipelines spouštět nová spuštění. Přečtěte si, jak toto chování přepsat .

Plány YAML fungovaly dobře. Ale teď přestali pracovat. Návody to ladit?

• Pokud jste ho nezadali always:true, nebude váš kanál naplánovaný, pokud nedojde k žádným aktualizacím kódu. Zkontrolujte, jestli nedošlo k nějakým změnám kódu a jak jste nakonfigurovali plány.

• Existuje limit, kolikrát můžete naplánovat kanál. Zkontrolujte, jestli jste tyto limity překročili.

• Zkontrolujte, jestli někdo povolil v uživatelském rozhraní víc plánů. Otevřete editor kanálu a vyberte Aktivační události. Pokud definovali plány v uživatelském rozhraní, nebudou se vaše plány YAML respektovat.

• Zkontrolujte, jestli je kanál pozastavený nebo zakázaný. Vyberte Nastavení pro váš kanál.

• Zkontrolujte několik dalších spuštění, která pro váš kanál naplánovala služba Azure Pipelines. Tato spuštění najdete tak , že v kanálu vyberete akci Naplánovaná spuštění . Pokud nevidíte plány, které jste očekávali, proveďte malou triviální změnu souboru YAML a nasdílejte aktualizaci do úložiště. Tím by se měly plány znovu synchronizovat.

• Pokud ke ukládání kódu používáte GitHub, je možné, že GitHub při pokusu o spuštění nového spuštění omezil Službu Azure Pipelines. Zkontrolujte, jestli můžete spustit nové spuštění ručně.

Kód se nezměnil, ale naplánované sestavení se aktivuje. Proč?

• Možná jste povolili možnost vždy spouštět naplánované sestavení, i když nedošlo k žádným změnám kódu. Pokud používáte soubor YAML, ověřte syntaxi plánu v souboru YAML. Pokud používáte klasické kanály, ověřte, jestli jste v naplánovaných aktivačních událostech zaškrtnuli tuto možnost.

• Možná jste aktualizovali kanál buildu nebo nějakou vlastnost kanálu. To způsobí naplánování nového spuštění, i když jste zdrojový kód neaktualizovali. Pomocí klasického editoru ověřte historii změn v kanálu.

• Možná jste aktualizovali připojení služby použité k připojení k úložišti. To způsobí naplánování nového spuštění, i když jste zdrojový kód neaktualizovali.

• Azure Pipelines nejprve zkontroluje, jestli kód obsahuje nějaké aktualizace. Pokud se Azure Pipelines nemůže spojit s vaším úložištěm nebo získat tyto informace, vytvoří informační spuštění. Jedná se o fiktivní build, který vám dá vědět, že Se službou Azure Pipelines se nemůže spojit s vaším úložištěm.

• Váš kanál nemusí mít úplně úspěšné sestavení. Pokud chcete zjistit, jestli chcete naplánovat nové sestavení, Azure DevOps vyhledá poslední zcela úspěšné naplánované sestavení. Pokud ho nenajdete, aktivuje se nové naplánované sestavení. Částečně úspěšné naplánované buildy se nepovažují za úspěšné, takže pokud váš kanál obsahuje jenom částečně úspěšné sestavení, Azure DevOps aktivuje naplánované buildy, i když se váš kód nezměnil.

Na panelu Naplánovaná spuštění se zobrazuje naplánované spuštění. V tu chvíli se ale nespustí. Proč?

• Na panelu Naplánovaná spuštění se zobrazují všechny potenciální plány. Pokud jste ale nepronesli skutečné aktualizace kódu, nemusí se ve skutečnosti spouštět. Pokud chcete vynutit, aby se plán vždy spustil, ujistěte se, že jste v kanálu YAML nastavili vždy vlastnost, nebo zaškrtněte možnost vždy spustit v klasickém kanálu.

Plány definované v kanálu YAML fungují pro jednu větev, ale ne pro druhou. Jak to můžu vyřešit?

Plány jsou definovány v souborech YAML a tyto soubory jsou přidruženy ke větvím. Pokud chcete, aby byl kanál naplánovaný pro určitou větev, řekněme features/X, ujistěte se, že soubor YAML v této větvi má definovaný plán cron a že obsahuje správné zahrnutí větví pro plán. Soubor YAML ve větvi by měl mít v tomto příkladu features/X následující schedule :

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

Další informace najdete v tématu Aspekty větve pro plánované triggery.