更新时间:2026-03-20 GMT+08:00
分享

配置定时任务

定时任务目前仅支持周期性触发模式,在on.schedules下进行配置。yaml文件示例如下。

on:
  schedules: 
    - type: 'periodic' 
      name: 定时任务2  
      enable: true  
      policies: [ 执行方案1 ]  
      days: [ 1,2,3,4,5,6,7 ] 
      start: 00:00 
      end: 00:01 
      timezone: Asia/Shanghai 
      interval: 900 
表1 参数解释

参数名

说明

schedules

定义配置定时任务,最多可配置10个定时任务,且名称不可重复。

type

触发定时任务的模式,当前仅支持周期触发模式。可设置为periodic。

name

定时任务的名称,仅支持输入中文、大小写英文字母、数字、中划线或下划线,长度为1-128个字符。

enable

是否启用定时任务。默认为true。

  • true:是。
  • false:否。

policies

定义定时任务的执行方案,执行方案名称长度为1-128个字符。若不配置,将根据流水线的默认配置执行。

days

配置定时任务的周期,不可为空。长度为1-7,取值范围为1-7。

1:周日;2:周一;3:周二;4:周三;5:周四;6:周五;7:周六。

start

定时任务开始时间,格式为HH:mm。

end

定时任务结束时间,格式为HH:mm。结束时间必须大于开始时间。

timezone

定时任务的时区,包含以下取值。

  • UTC。
  • America/Sao_Paulo。
  • America/Santiago。
  • America/Chicago。
  • Africa/Cairo。
  • Europe/Moscow。
  • Asia/Bangkok。
  • Asia/Shanghai。
  • Asia/Singapore。

interval

触发定时任务的时间间隔。单位为秒,设置时不得少于900秒。在定时任务开始到结束的时间区间内,每隔interval将触发一次流水线。

相关文档