Cron jobs

How to create cron jobs

Understanding cron jobs

Cron jobs let you run scripts and other jobs periodically, either based on an interval (for example, every ten minutes) or on a schedule (for example, every Tuesday at 03:00 AM).

Creating a cron job in your environment

To create cron jobs in Release, edit your "Environment Configuration" under Settings.

At the end of the YAML, add a section called cron_jobs and define any jobs you want to run following the example below.

# ...
  - name: hello-cron
    schedule: "0/5 * * * *"
    image: busybox
      - sh
      - "-c"
      - "echo 'hi from cron'"

Press Save as new version.

Back in your Environment Settings page, apply this new configuration to your environment. This will redeploy your existing instances, and also add a new one to run the cron job you defined.

Wait for the new environment to deploy. If you used the configuration from the example above, you should see a new instance come up every five minutes. Viewing the logs of that instance will confirm that the job ran as expected.

The difference between cron jobs and jobs

Cron jobs are distinct from jobs in that:

  • Cron jobs are run on a schedule or timer.

  • Jobs are run manually or based on events, for example, after a backend service comes up.

The cron jobs schema

Instead of choosing an image to base your cron job on, you can define from_services to base your cron job on an existing service. You can find more examples and the full schema in the schema docs.

Last updated