autoupdate

Build Status

Table of Contents

  1. Overview
  2. Module Description - What the module does and why it is useful
  3. Setup - The basics of getting started with autoupdate
  4. Usage - Configuration options and additional functionality
  5. Reference - An under-the-hood peek at what the module is doing and how
  6. Limitations - OS compatibility, etc.
  7. Development - Guide for contributing to the module

Overview

This module sets up automatic updates in the system. It is easy to use module with one scheduled job and email support.

Module Description

This module offers unified simplified way to handle automatic updates in Debian-like and RedHat-like systems.

On Debian cron-apt tool is used.

On RedHat yum-autoupdate tool is used (using aco-yum_autoupdate puppet module).

Setup

What autoupdate affects

Debian

  • cron-apt package installed
  • /etc/cron-apt/config
  • /etc/cron-apt/action.d/*
  • /etc/cron.d/cron-apt - removed
  • crontab

RedHat

See https://github.com/antoineco/aco-yum_autoupdate#setup.

Beginning with autoupdate

Example: default parameters without email notification

include autoupdate

Updates at random time 5:00 - 6:00 each day.

Usage

Example: some parameters and email

class { 'autoupdate':
  email      => 'email@example.com',
  hour       => 7,
  minute     => 0,
  randomwait => 1200,
}

Update at random time 7:00 - 7:20 each day and send email notification, if someting was updated.

Reference

Parameters

email

Email to sent notifications. Default is undef.

randomwait

Random time to wait before update in seconds. Default is to leave it to the autoupdate tools (1 hour for cron-apt and yum-autoupdate).

update

Update type. Default is 'default'.

  • cron-apt: default, dist
  • yum_autoupdate: default, security, minimal, ...

Unknown types translates to default.

hour

minute

month

monthday

weekday

special

Parameters for cron job. Beware the defaults are *!

Limitations

RedHat-like and Debian-like systems are supported.

Development