Skip to main content

Schedule pipelines using triggers

You can schedule Pipeline executions using Cron-based Triggers.

For example, you can have a Pipeline run every Monday at 1AM. Harness will generate the Cron expression (0 1 * * MON).

For general Triggers reference, see Triggers Reference.

Before you begin

Add a trigger to a pipeline

Open your Harness pipeline in Pipeline Studio.

  1. Select Triggers.

  2. Select New Trigger.

  3. Select Cron.

    For Git-based Trigger types or CodeCommit, see Trigger Pipelines using Git Events.

  4. In Trigger Overview, enter a name, description, and tags for the trigger.

Schedule the trigger

In Schedule, use the settings to schedule the trigger.

When you edit a Cron trigger later, you can type or paste in a Cron expression.

The Cron expression will be evaluated against UTC time.

There are two types of supported cron expressions, QUARTZ and UNIX.

Following are the QUARTZ and UNIX expression formatting samples:

QUARTZ Expression

0 0 4 7 ? 2014  
| | | | | |
| | | | | \------- YEAR (2014)
| | | | \--------- DAY_OF_WEEK (NOT_SPECIFIED)
| | | \------------- MONTH (JULY)
| | \--------------- DAY_OF_MONTH (4th)
| \----------------- HOUR (0- MIDNIGHT LOCAL TIME)
\------------------- MINUTE (0)

UNIX Expression

5 0 * * 5
| | | | |
| | | | \-------DAY_OF_WEEK (Friday)
| | | \---------MONTH (Any month)
| | \-----------DAY_OF_MONTH (Any day of the month)
| \-------------HOUR(0- MIDNIGHT LOCAL TIME)

Set pipeline input

Pipelines often have Runtime inputs like codebase branch names or artifact versions and tags.

Provide values for the inputs. You can also use Input sets.

Select Create Trigger.

The Trigger is now added to the Triggers page.

Enable or disable trigger

Use the enable setting to turn the trigger on and off.

Your pipeline will run when the Cron expression equals the current time.

Run once

To specify a run-once schedule, specify a fully qualified date and time.

Enter the time, day of month, month, and then allow for any day of the week.

The below example runs on At 1:45 PM, on day 13 of the month, and on Tuesday, only in September

45 13 13 09 Tue

See also