Forge Home

cron

Adds cron jobs from parameters

10,789 downloads

10,095 latest version

3.4 quality score

We run a couple of automated
scans to help you access a
module's quality. Each module is
given a score based on how well
the author has formatted their
code and documentation and
modules are also checked for
malware using VirusTotal.

Please note, the information below
is for guidance only and neither of
these methods should be considered
an endorsement by Puppet.

Support the Puppet Community by contributing to this module

You are welcome to contribute to this module by suggesting new features, currency updates, or fixes. Every contribution is valuable to help ensure that the module remains compatible with the latest Puppet versions and continues to meet community needs. Complete the following steps:

  1. Review the module’s contribution guidelines and any licenses. Ensure that your planned contribution aligns with the author’s standards and any legal requirements.
  2. Fork the repository on GitHub, make changes on a branch of your fork, and submit a pull request. The pull request must clearly document your proposed change.

For questions about updating the module, contact the module’s author.

Version information

  • 0.0.4 (latest)
  • 0.0.3
  • 0.0.2
  • 0.0.1
released Jul 4th 2014

Start using this module

  • r10k or Code Manager
  • Bolt
  • Manual installation
  • Direct download

Add this module to your Puppetfile:

mod 'gbrown-cron', '0.0.4'
Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

bolt module add gbrown-cron
Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install gbrown-cron --version 0.0.4

Direct download is not typically how you would use a Puppet module to manage your infrastructure, but you may want to download the module in order to inspect the code.

Download

Documentation

gbrown/cron — version 0.0.4 Jul 4th 2014

Cron puppet module

About

This is a generic cron module for puppet.

init.pp

This contains the main cron class and simply ensures that cron is running.

crontab class

The parameter $jobs is taken and wrapped with the create_resources function as such this simply takes cron jobs with the standard puppet cron type attributes.

There is also a $defaults parameter intended to minimise boiler plate. This enables default attributes to be set once and applied for all puppet defined cron jobs. In this class this is set to ensure the jobs is enabled and that root is the user to execute the jobs.

hourly, daily, weekly and monthly classes

These are similar to the crontab class but differ in that it is taking the puppet file type for the $jobs. To provide a consistent interface you simply need to specify the name of the job and the command to execute. This will likely be the same as jobs passed to the crontab class. See examples below.

Note: Creating jobs via parameters for these classes requires parser = future.

These classes also support pulling files from the files directory of the module itself on the puppet master. For example placing a file in files/hourly would result in the client picking up that file in /etc/cron.hourly/.

hiera_hash

If the $heria_hash parameter is true values for $jobs across all hierarchies are used so cron jobs can be defined at multiple levels. This allows for a base set of cron jobs to be defined at a low level of the hierarchy and more specific cron jobs to be defined further up the hierarchy closer to what is likely more relevant definitions. This is definable in each of the classes expect in the service class. If defined in the main cron class as true it will take precedence over definitions in other classes.

purge

All classes with the exception of the service class take a $purge parameter which if set to true will cause puppet to remove any cron jobs that are not provided by puppet. If defined in the main cron class as true it will take precedence over definitions in other classes.

Usage

A basic example of adding some cron jobs in YAML.

# Add two cron jobs to crontab

cron::crontab::jobs: 
  first_job: 
    command:  '/bin/echo "This is run as root every 12 hours"'
    hour:     '12'
  second_job: 
    command:  '/bin/echo "This is run as puppet every 12 hours"'
    hour:     '12'
    user:     'puppet'

# Only allow puppet controlled jobs in /etc/cron.daily

cron::daily::pruge: 'true'

# Add job to /etc/cron.daily/

cron::daily::jobs: 
  once_a_day: 
    command: '/bin/echo "Today is $(/bin/date)"'

Dependencies

This module depends upon puppetlabs/stdlib for validation checks.