Schedule chain runs

You can specify a condition that triggers a chain, or run a chain on a schedule. By default, a chain is set to be triggered manually.

To specify the conditions for running chains:

  1. On the top navigation bar, select a space from the spaces list.
  2. On the Products page, open a product or Git repository.
  3. On the sidebar, select Chains.

  4. Open a chain from the chain list and click Edit.

  5. In the chain's editing window, select the Triggers tab.

  6. From the Run chain list, select the option for running the chain:

    Option Description
    Manually run (Default) Trigger chain runs manually.
    On every changeset Trigger the chain every time a changeset is delivered.
    When a pull request is published Trigger the chain every time a pull request is published.

    Hourly

    Specify the interval (in hours) for running the chain, for example, every 12 hours at 15 minutes past the hour. The Hourly schedule reflects your local time zone.

    To trigger the chain even if no changes were delivered between the runs, select Run as scheduled even if no new changesets have been created since the last run.

    Daily

    Specify the interval (in days) and the time when to run the chain, for example every 3 days at 19:00. The Daily schedule is set in a 24-hour format using your local time zone.

    To trigger the chain even if no changes were delivered between the runs, select Run as scheduled even if no new changesets have been created since the last run.

    Weekly

    Specify the week days and the time when to run the chain, for example, Tuesday and Saturday, at 19:00. The Weekly schedule is set in a 24-hour format using your local time zone.

    To trigger the chain even if no changes were delivered between the runs, select Run as scheduled even if no new changesets have been created since the last run.

    Cron

    Enter a cron expression to set the schedule for running the chain. For example, to run the chain every day at noon, enter 0 0 12 ? * MON-FRI. Cron expressions are interpreted in the UTC time zone.

    To trigger the chain even if no changes were delivered between the runs, select Run as scheduled even if no new changesets have been created since the last run.

    Chain is disabled Select this option to disable the chain.
  7. For Matching streams, enter a pattern to specify the streams in which to run the chain. Use asterisks (*) and commas (,) to specify multiple streams, for example, mainline,feature-*

  8. In the Path filtering field, enter Ant patterns (one per line) to run changesets only on paths that match the pattern. The chain is triggered if at least one path in the changeset matches the pattern.

    Leave the field empty to run the chain on all changesets.

  9. Click Save.

Back to top

See also: