CronTrigger Tags

name

An alphanumeric string (underscores are permitted) that identifies the resource.

type

Must be CronTrigger for this resource type.

configuration

Specifies all configuration selections for the resource.

Tag

Description

Required/Optional

interval

A cron expression string that specifies the time(s) or interval to trigger the step.

The interval tag uses standard Cron expression and takes the following format:

Format

interval: * * * * *                                 
          │ │ │ │ │_________ day of the week (1-7 or SUN-SAT)
          | | | |__________ month (1 - 12)
          | | |__________ day of the month (1 - 31)
          | |__________ hour (0 - 23)
          |__________ minute (0 - 59)

Examples

CRON Expression	Meaning
`0 12 * * *`	12 PM (noon) every day.
`25 10 * * *`	10:25 AM every day.
`15 22 * * *`	10:15 PM every day.
`* 16 * * *`	Every minute starting at 4 PM and ending at 4:59 PM, every day.
`0/5 13 * * *`	Every 5 minutes starting at 1 PM and ending at 1:55 PM, every day.
`0/5 15,18 * * *`	Every 5 minutes starting at 3 PM and ending at 3:55 PM, and every 5 minutes starting at 6 PM and ending at 6:55 PM, every day.
`0-5 18 * * *`	Every minute starting at 6 PM and ending at 6:05 PM, every day.
`10,44 15 * 5 MON`	3:10 PM and at 3:44 PM every Monday in the month of May.
`45 10 * * MON-FRI`	10:45 AM every Monday, Tuesday, Wednesday, Thursday and Friday.
`30 10 10 * *`	10:30 AM on the 10th day of every month.
`0 12 1/5 * *`	12 PM (noon) on every 5th day-of-month from 1 through 31.
`11 11 11 11 *`	Every November 11th at 11:11 AM.

Note

For more information, see Cron expression.
It is recommended that you first test your Cron expression using an online tool before using it.

Required

branches

For use in multibranch pipelines, though it will also work with single branch pipelines. An object where include and exclude regex patterns are used to control which branches are triggered by the resource.

If an include pattern is supplied, any branch not matching the pattern will not trigger.
If an exclude pattern is supplied, any branch matching the pattern will not trigger.

Note

When include or exclude is not provided, the cronTrigger resource will trigger every branch in a multibranch pipeline. Most multibranch pipelines should use this configuration.

Optional

environmentVariables

Add environment variables as key-value pairs.

Example

    configuration:
      interval: '*/30 * * * *' # Every 10 minutes
      environmentVariables:
        first: env
        second: env