配置管道的计划

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

Azure Pipelines 提供了多种类型的触发器来配置管道的启动方式。

• 计划触发器会根据计划（如夜间生成）启动管道。 本文提供有关使用计划触发器基于计划运行管道的指导。
• 基于事件的触发器启动管道以响应事件，例如创建拉取请求或推送到分支。 有关使用基于事件的触发器的信息，请参阅 Azure Pipelines 中的触发器。

可以在管道中合并计划触发器和基于事件的触发器，例如，每次进行推送（CI 触发器）、发出拉取请求时（PR 触发器）和夜间生成（计划触发器）时验证生成。 如果只想按计划生成管道，而不是响应基于事件的触发器，请确保管道未启用任何其他触发器。 例如，GitHub 存储库中的 YAML 管道默认启用 CI 触发器和 PR 触发器。 有关禁用默认触发器的信息，请参阅 Azure Pipelines 中的触发器 ，并导航到涵盖存储库类型的部分。

计划的触发器

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.

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')

例子

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

计划运行视图

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

即使没有代码更改，也运行

默认情况下，如果自上次成功计划的运行以来没有代码更改，则管道不会按计划运行方式运行。 例如，请考虑已计划每天晚上 9：00 运行管道。 在工作日中，将各种更改推送到代码。 管道按计划运行。 在周末，你不会对代码进行任何更改。 如果自上周五的计划运行以来没有代码更改，则管道不会按计划在周末运行。

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

从经典编辑器迁移

以下示例演示如何将计划从经典编辑器迁移到 YAML。

• 示例：多个时区中的 Git 存储库的夜间生成
• 示例：具有不同频率的夜间生成

示例：多个时区中的 Git 存储库的夜间生成

在此示例中，经典编辑器计划触发器有两个条目，生成以下版本。

• 每个星期一 - 星期五上午 3：00 （UTC + 5：30 时区），生成符合分支筛选条件的 features/india/* 分支

  

• 每个星期一 - 星期五上午 3：00 （UTC - 5：00 时区），生成符合分支筛选条件的 features/nc/* 分支

  

等效的 YAML 计划触发器为：

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

在第一个时间表中， M-F 上午 3：00 （UTC + 5：30） 印度每日生成，cron 语法 （mm HH DD MM DW） 为 30 21 * * Sun-Thu。

• 分钟和小时 - 30 21 这映射到 21:30 UTC （9:30 PM UTC）。 由于经典编辑器中的指定时区为 UTC + 5：30，因此我们需要从所需的生成时间 3：00 AM 减去 5 小时 30 分钟，才能到达指定 YAML 触发器所需的 UTC 时间。 可以从 GitHub Copilot 获取 AI 帮助来创建 cron 表达式。
• 天数和月份被指定为通配符，因为此计划不指定仅在月份的特定日期或特定月份运行。
• 一周中的天数 - Sun-Thu 由于时区转换，我们的内部版本要在 UTC + 5：30 印度时区的凌晨 3：00 运行，因此我们需要指定在 UTC 时间前一天启动它们。 还可以将一周中的天数指定为 0-4 或 0,1,2,3,4。

第二个计划 是 M-F 上午 3：00（UTC - 5） NC 每日生成，cron 语法为 0 8 * * Mon-Fri。

• 分钟和小时 - 0 8 这映射到 8:00 AM UTC。 由于经典编辑器中的指定时区为 UTC - 5：00，因此我们需要从所需的生成时间 3：00 AM 添加 5 小时，才能到达所需的 UTC 时间来指定 YAML 触发器。 可以从 GitHub Copilot 获取 AI 帮助来创建 cron 表达式。
• 天数和月份被指定为通配符，因为此计划不指定仅在月份的特定日期或特定月份运行。
• 一周中的天数 - Mon-Fri 由于时区转换不会跨越一周中的多个天，因此我们不需要在此处进行任何转换。 还可以将一周中的天数指定为 1-5 或 1,2,3,4,5。

示例：具有不同频率的夜间生成

在此示例中，经典编辑器计划触发器有两个条目，生成以下版本。

• 每个星期一 - 星期五上午 3：00 UTC，生成满足和main分支筛选条件的releases/*分支

  

• 每天上午 3：00 UTC，生成 releases/lastversion 分支，即使源或管道未更改

  

等效的 YAML 计划触发器为：

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

在第一个计划 中，M-F 上午 3：00（UTC）每日生成，cron 语法为 0 3 * * Mon-Fri。

• 分钟和小时 - 0 3 这映射到 3:00 AM UTC。 由于经典编辑器中的指定时区为 UTC，因此无需执行任何时区转换。
• 天数和月份被指定为通配符，因为此计划不指定仅在月份的特定日期或特定月份运行。
• 一周中的天数 - Mon-Fri 由于没有时区转换，因此一周中的天数直接从经典编辑器计划映射。 还可以将一周中的天数指定为 1,2,3,4,5。

第二个时间表是 星期天凌晨 3：00（UTC）每周最新版本生成，cron 语法为 0 3 * * Sun。

• 分钟和小时 - 0 3 这映射到 3:00 AM UTC。 由于经典编辑器中的指定时区为 UTC，因此无需执行任何时区转换。
• 天数和月份被指定为通配符，因为此计划不指定仅在月份的特定日期或特定月份运行。
• 一周中的天数 - Sun 由于时区转换不会跨越一周中的多个天，因此我们不需要在此处进行任何转换。 还可以将一周中的天数指定为 0。
• 我们还指定 always: true ，因为此生成计划运行源代码是否已更新。

FAQ

• 我希望我的管道仅在计划上运行，而不是有人将更改推送到分支时
• 我在 YAML 文件中定义了计划。 但它没有运行。 发生了什么事？
• 我的 YAML 计划正常工作。 但是，他们现在停止工作。 如何调试此项？
• 我的代码尚未更改，但会触发计划的生成。 为什么？
• 我在“计划运行”面板中看到计划的运行。 但是，它当时不会运行。 为什么？
• YAML 管道中定义的计划适用于一个分支，但不适用于另一个分支。 如何解决此问题？

我希望我的管道仅在计划上运行，而不是有人将更改推送到分支时

如果希望管道仅在计划上运行，而不是有人将更改推送到分支或合并到主分支的更改时，则必须显式禁用管道上的默认 CI 和 PR 触发器。

若要禁用默认 CI 和 PR 触发器，请将以下语句添加到 YAML 管道，并 验证是否尚未使用 UI 触发器重写 YAML 管道触发器。

trigger: none
pr: none

有关详细信息，请参阅 pr 定义 和 触发器定义。

我在 YAML 文件中定义了计划。 但它没有运行。 发生了什么事？

• 检查 Azure Pipelines 已为管道安排的后续几次运行。 可以通过在管道中选择 “计划运行 ”作来查找这些运行。 该列表经过筛选，仅显示未来几天即将进行的几次运行。 如果这不符合预期，则可能是因为你键入了 cron 计划，或者没有正确分支中定义的计划。 阅读上面的主题，了解如何配置计划。 重新计算 cron 语法。 cron 计划的所有时间都采用 UTC 格式。

• 对 YAML 文件进行一个小的更改，并将该更新推送到存储库中。 如果之前从 YAML 文件读取计划时出现问题，现在应修复此问题。

• 如果在 UI 中定义了任何计划，则不遵循 YAML 计划。 通过导航到管道的编辑器并选择 “触发器”，确保没有任何 UI 计划。

• 可以计划管道的运行数有限制。 详细了解 限制。

• 如果代码没有更改，则 Azure Pipelines 可能无法启动新的运行。 了解如何 重写 此行为。

我的 YAML 计划正常工作。 但是，他们现在停止工作。 如何调试此项？

• 如果未指定 always:true，则除非对代码进行任何更新，否则不会计划管道。 检查是否存在任何代码更改以及 配置计划的方式。

• 可以计划管道的次数 有限制 。 检查是否已超过这些限制。

• 检查某人是否在 UI 中启用了更多计划。 打开管道的编辑器，然后选择 “触发器”。 如果在 UI 中定义了计划，则不会遵循 YAML 计划。

• 检查管道是否已暂停或禁用。 选择管道 的设置 。

• 检查 Azure Pipelines 已为管道安排的后续几次运行。 可以通过在管道中选择 “计划运行 ”作来查找这些运行。 如果未看到预期的计划，请对 YAML 文件进行一个小的更改，并将更新推送到存储库。 这应重新同步计划。

• 如果使用 GitHub 来存储代码，则尝试启动新运行时，GitHub 可能会限制 Azure Pipelines。 检查是否可以手动启动新运行。

我的代码尚未更改，但会触发计划的生成。 为什么？

• 你可能已启用一个选项来 始终 运行计划的生成，即使没有代码更改。 如果使用 YAML 文件，请验证 YAML 文件中计划语法。 如果使用经典管道，请验证是否在计划的触发器中选中了此选项。

• 你可能已更新生成管道或管道的某些属性。 这将导致计划新的运行，即使尚未更新源代码也是如此。 使用经典编辑器验证管道中更改的 历史记录 。

• 你可能已更新用于连接到存储库的服务连接。 这将导致计划新的运行，即使尚未更新源代码也是如此。

• Azure Pipelines 首先检查代码是否有任何更新。 如果 Azure Pipelines 无法访问存储库或获取此信息，它将创建 信息运行。 这是一个虚拟生成，可让你知道 Azure Pipelines 无法访问存储库。

• 管道可能无法完全成功生成。 为了确定是否计划新生成，Azure DevOps 查找最后一个完全成功的计划生成。 如果找不到，则会触发新的计划生成。 部分成功的计划生成不被视为成功，因此，如果管道只有部分成功的生成，即使代码未更改，Azure DevOps 也会触发计划生成。

我在“计划运行”面板中看到计划的运行。 但是，它当时不会运行。 为什么？

• “ 计划运行 ”面板显示所有可能的计划。 但是，除非你对代码进行了真正的更新，否则它可能不会实际运行。 若要强制计划始终运行，请确保已在 YAML 管道中设置 always 属性，或选中选项以始终在经典管道中运行。

YAML 管道中定义的计划适用于一个分支，但不适用于另一个分支。 如何解决此问题？

计划在 YAML 文件中定义，这些文件与分支相关联。 如果希望为特定分支计划管道，例如 features/X，请确保 该分支中的 YAML 文件具有在其中定义的 cron 计划，并且它具有计划的正确分支包含。 分支中的 features/X YAML 文件应在此示例中具有以下内容 schedule ：

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

有关详细信息，请参阅 计划的触发器的分支注意事项。