Skip to content
This repository has been archived by the owner on Jan 17, 2023. It is now read-only.
/ go-crond Public archive
forked from webdevops/go-crond

⏰ Cron daemon written in golang (for eg. usage in docker images)

License

Notifications You must be signed in to change notification settings

BCDevOps/go-crond

 
 

Repository files navigation

title description resourceType personas labels
go-crond
Can't live without cron in your OpenShift project? Check out [go-crond](https://github.com/BCDevOps/go-crond) it's an OpenShift compatible cron daemon written in golang.
Components
Developer
Product Owner
Designer
cron

BCDevOps/go-crond Repository

Lifecycle:Retired

This fork of webdevops/go-crond is deprecated and is no longer maintained. Please use the upstream project instead. The changes to go-crond that prompted this fork have been integrated into the upstream project.

go-crond

GitHub release license Build Status Github All Releases Github Releases

Can't live without cron in your OpenShift project? Check out go-crond it's an OpenShift compatible cron daemon written in golang.

Inspired by https://github.com/anarcher/go-cron

Using https://godoc.org/github.com/robfig/cron

Features

  • system crontab (with username inside)
  • user crontabs (without username inside)
  • run-parts support
  • Logging to STDOUT and STDERR (instead of sending mails)
  • Keep current environment (eg. for usage in Docker containers)
  • Supports Linux, MacOS, ARM/ARM64 (Rasbperry Pi and others)

Usage

Usage:
  go-crond

Application Options:
      --threads=            Number of parallel executions (default: 20)
      --default-user=       Default user (default: root)
      --include=            Include files in directory as system crontabs (with user)
      --system-defaults     Include standard paths for distribution
      --run-parts=          Execute files in directory with custom spec (like run-parts; spec-units:ns,us,s,m,h; format:time-spec:path; eg:10s,1m,1h30m)
      --run-parts-1min=     Execute files in directory every beginning minute (like run-parts)
      --run-parts-15min=    Execute files in directory every beginning 15 minutes (like run-parts)
      --run-parts-hourly=   Execute files in directory every beginning hour (like run-parts)
      --run-parts-daily=    Execute files in directory every beginning day (like run-parts)
      --run-parts-weekly=   Execute files in directory every beginning week (like run-parts)
      --run-parts-monthly=  Execute files in directory every beginning month (like run-parts)
      --allow-unprivileged  Allow daemon to run as non root (unprivileged) user
  -v, --verbose             verbose mode
  -V, --version             show version and exit
      --dumpversion         show only version number and exit
  -h, --help                show this help message

Crontab files can be added as arguments or automatic included by using eg. --include-crond=path/

Examples

Run crond with a system crontab:

go-crond examples/crontab

Run crond with user crontabs (without user in it) under specific users:

go-crond \
    root:examples/crontab-root \ 
    guest:examples/crontab-guest

Run crond with auto include of /etc/cron.d and script execution of hourly, weekly, daily and monthly:

go-crond \
    --include=/etc/cron.d \
    --run-parts-hourly=/etc/cron.hourly \
    --run-parts-weekly=/etc/cron.weekly \
    --run-parts-daily=/etc/cron.daily \
    --run-parts-monthly=/etc/cron.monthly

Run crond with run-parts with custom time spec:

go-crond \
    --run-parts=1m:/etc/cron.minute \
    --run-parts=15m:/etc/cron.15min

Run crond with run-parts with custom time spec and different user:

go-crond \
    --run-parts=1m:application:/etc/cron.minute \
    --run-parts=15m:admin:/etc/cron.15min

Installation

GOCROND_VERSION=0.6.0 \
&& wget -O /usr/local/bin/go-crond https://github.com/webdevops/go-crond/releases/download/$GOCROND_VERSION/go-crond-64-linux \
&& chmod +x /usr/local/bin/go-crond

Docker images

Image Description
webdevops/go-crond:latest Latest release, binary only
webdevops/go-crond:master Current development version in branch master

About

⏰ Cron daemon written in golang (for eg. usage in docker images)

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Go 83.3%
  • Makefile 14.2%
  • Dockerfile 2.5%