Forge Home


Puppet module to handle Yum updates


7,184 latest version

4.3 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.

Version information

  • 0.4.0 (latest)
  • 0.3.0
  • 0.2.1
  • 0.1.0
released Nov 2nd 2017
This version is compatible with:
  • Puppet Enterprise 2017.2.x, 2017.1.x, 2016.5.x, 2016.4.x
  • Puppet >= 4.0.0 < 5.0.0
  • ,

Start using this module

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

Add this module to your Puppetfile:

mod 'jgazeley-yumupdate', '0.4.0'
Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

bolt module add jgazeley-yumupdate
Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install jgazeley-yumupdate --version 0.4.0

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.



jgazeley/yumupdate — version 0.4.0 Nov 2nd 2017


Table of Contents

  1. Overview
  2. Usage - Configuration options and additional functionality
  3. Limitations - OS compatibility, etc.
  4. Development - Guide for contributing to the module


Manage yum.conf and schedule automatic yum updates.


Default behaviour is for the module to hash the node's IP address to generate an hour and a minute for the update cron job to run, to stagger yum updates across your esate between 02:00 and 07:59 on weekdays.


Cron hour that the update job should run, from 0-23. Default: $::cron_hour (a random value between 2-7)


Cron minute that the update job should run, from 0-59. Default: $::cron_minute (a random value between 0-59)


Day(s) of the week that the update job should run, specified as an array. Default: ['1-5'] (weekdays only)


Array of packages to exclude from the update job

include ::yumupdate

If you want to force the same time on every node, set these parameters:

class { 'yumupdate':
  hour   => 5,
  minute => 30,

Example where we don't upgrade the kernel:

class { 'yumupdate':
  exclude => ['kernel'],


Only works on systems that use Yum for package management. Designed with CentOS but should work on any RHEL-compatible Linux distribution.


Pull requests welcome.