kiwi- simple, consistent, powerful
Simple cron-jobs for kiwi-scp
kiwi-cron comes with a (slightly) opinionated cron daemon config for periodic jobs.
Just drop your scripts into the relevant directory under /kiwi-cron, that's it.
You will likely want to automate some tasks regarding your docker infrastructure.
That's why the kiwi-cron images package a current docker-cli – you can just mount your docker.sock in its containers and use docker commands normally.
kiwi-cron images include the tzdata package and automatically handle /etc/localtime on startup. By default, "Etc/UTC" is set as the container time zone.
To use a different time zone, change the container environment variable TZ to your liking, e.g. "Europe/Berlin".
On startup, kiwi-cron checks for possible job files in the /kiwi-cron directory structure.
For each subdirectory, a random valid cron schedule is generated, so that:
/kiwi-cron/hourlyruns once every hour (random minute)/kiwi-cron/dailyruns once every day (random nighttime value between 9 pm and 3 am)/kiwi-cron/weeklyruns once every weekend (random nighttime value on Saturday or Sunday)/kiwi-cron/monthlyruns once every month (random nighttime value on a random day <= 28)/kiwi-cron/yearlyand/kiwi-cron/annuallyruns once a year (random nighttime value on a random day <= 28 in January or February)
Cron schedules are regenerated once on each startup, only for directories that have files.
Directories like /kiwi-cron/every/5_minutes will run scripts every 5 minutes.
kiwi-cron picks up on that format and generates valid cron schedules on startup.
This way, you can define schedules to be run every N minutes, hours, days, or months by creating the corresponding directories.
Scheduling for every N weeks (or years) doesn't work though; jobs in those directories will instead be run every week (or every year).
Checking the generated cron schedules is done using the standard crontab command:
docker exec kiwi-cron-container crontab -l will show the effective schedules.