blob: 3b38c99a0c846e363833ebe3490408bddcd3abc5 [file] [log] [blame]
James E. Blaireff5a9d2017-06-20 00:00:37 -07001:title: Timer Driver
2
3Timer
4=====
5
6The timer driver supports triggers only. It is used for configuring
7pipelines so that jobs run at scheduled times. No connection
8configuration is required.
9
10Trgger Configuration
11--------------------
12
13Timers don't require a special connection or driver. Instead they can
James E. Blaire9a0f9d2017-08-04 08:45:53 -070014simply be used by listing ``timer`` as the trigger.
James E. Blaireff5a9d2017-06-20 00:00:37 -070015
James E. Blaire9a0f9d2017-08-04 08:45:53 -070016This trigger will run based on a cron-style time specification. It
17will enqueue an event into its pipeline for every project defined in
18the configuration. Any job associated with the pipeline will run in
19response to that event.
James E. Blaireff5a9d2017-06-20 00:00:37 -070020
James E. Blaire9a0f9d2017-08-04 08:45:53 -070021.. attr:: pipeline.trigger.timer
22
23 The timer trigger supports the following attributes:
24
25 .. attr:: time
26 :required:
27
28 The time specification in cron syntax. Only the 5 part syntax
29 is supported, not the symbolic names. Example: ``0 0 * * *``
30 runs at midnight. The first weekday is Monday.