Skip to content

Run cron jobs in a standardized environment with logs and locking

License

Notifications You must be signed in to change notification settings

instacart/ohmycron

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

10 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ohmycron -- Cron simplified

OhMyCron Logo

Frequently when debugging cron jobs, one finds that:

  • One needs to use locks to keep more than one copy of frequently running jobs from running at the same time.

  • One wishes to load the user environment -- /etc/profile as well as RC files in HOME.

  • Generally, one would cd to HOME for application specific users.

  • The path should include /usr/local/bin.

  • The output of the cron job should be logged to Syslog, which both prevents cron from raising errors about mailers and allows you to see what went wrong if something did.

ohmycron does all this and more, managing locks with a POSIX API, so that the OS takes care of cleaning up locks for failed proceseses.

ohmycron as a wrapper

Prepending ohmycron to the commands in your crontab keeps your crontab clean and transparently adds logging, locking and environment loading.

* * * * *  root  ohmycron sleep 10
* * * * *  root  ohmycron --tag update:ohmycron -- curl -sSfL 'https://raw.githubusercontent.com/instacart/ohmycron/master/ohmycron' -o /usr/local/bin/ohmycron

ohmycron as the cron shell

Setting SHELL=/usr/local/bin/ohmycron (or another path if you have installed ohmycron elsewhere) transparently adds locks, logging and environment setup to all the jobs in a cron file. (Tasks are actually run with Bash.) It is does something the wrapper can't do, too: support multi-statement commands which use the shell operators &&, |, || and so forth.

SHELL=/usr/local/bin/ohmycron
* * * * *  root  sleep 10
* * * * *  root  : update:ohmycron ; curl -sSfL 'https://raw.githubusercontent.com/instacart/ohmycron/master/ohmycron' -o /usr/local/bin/ohmycron

You can explicitly name a cron job with a Bash "no-op comment": : <some words> ;. (In Bash, : is a no-op; the arguments to the no-op command are ignored.)

Installation

sudo curl -sSfL 'https://raw.githubusercontent.com/instacart/ohmycron/master/ohmycron' -o /usr/local/bin/ohmycron
sudo chmod a+rx /usr/local/bin/ohmycron

About

Run cron jobs in a standardized environment with logs and locking

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages