Skip to content

REFERENCE.md

Latest commit

 

History

History
401 lines (236 loc) · 10.7 KB

REFERENCE.md

File metadata and controls

401 lines (236 loc) · 10.7 KB

Reference

Table of Contents

Classes

  • os_patching: This manifest sets up a script and cron job to populate the os_patching fact.

Tasks

  • clean_cache: Clean patch caches (yum/dpkg) via a task
  • patch_server: Carry out OS patching on the server, optionally including a reboot and/or only applying security related updates
  • refresh_fact: Force a refresh of the os_patching fact cache via a task

Plans

Classes

os_patching

This manifest sets up a script and cron job to populate the os_patching fact.

Examples

assign node to 'Week3' patching window, force a reboot and create a blackout window for the end of the year
class { 'os_patching':
  patch_window     => 'Week3',
  reboot_override  => 'always',
  blackout_windows => { 'End of year change freeze':
    {
      'start': '2018-12-15T00:00:00+10:00',
      'end': '2019-01-15T23:59:59+10:00',
    }
  },
}
An example profile to setup patching, sourcing blackout windows from hiera
class profiles::soe::patching (
  $patch_window     = undef,
  $blackout_windows = undef,
  $reboot_override  = undef,
){
  # Pull any blackout windows out of hiera
  $hiera_blackout_windows = lookup('profiles::soe::patching::blackout_windows',Hash,hash,{})

  # Merge the blackout windows from the parameter and hiera
  $full_blackout_windows = $hiera_blackout_windows + $blackout_windows

  # Call the os_patching class to set everything up
  class { 'os_patching':
    patch_window     => $patch_window,
    reboot_override  => $reboot_override,
    blackout_windows => $full_blackout_windows,
  }
}
JSON hash to specify a change freeze from 2018-12-15 to 2019-01-15
{"End of year change freeze": {"start": "2018-12-15T00:00:00+10:00", "end": "2019-01-15T23:59:59+10:00"}}
Run patching on the node centos.example.com using the smart reboot option
puppet task run os_patching::patch_server --params '{"reboot": "smart"}' --targets centos.example.com
Remove from a managed system
class { 'os_patching':
  ensure => absent,
}

Parameters

The following parameters are available in the os_patching class:

puppet_binary

Data type: Stdlib::Absolutepath

Location of the Puppet binary

patch_data_owner

Data type: String

User name for the owner of the patch data

patch_data_group

Data type: String

Group name for the owner of the patch data

patch_cron_user

Data type: String

User who runs the cron job

manage_yum_utils

Data type: Boolean

Should the yum_utils package be managed by this module on RedHat family nodes? If true, use the parameter yum_utils to determine how it should be manged

block_patching_on_warnings

Data type: Boolean

If there are warnings present in the os_patching fact, should the patching task run? If true the run will abort and take no action If false the run will continue and attempt to patch (default)

yum_utils

Data type: Enum['installed', 'absent', 'purged', 'held', 'latest']

If managed, what should the yum_utils package set to?

fact_upload

Data type: Boolean

Should puppet fact upload be run after any changes to the fact cache files?

apt_autoremove

Data type: Boolean

Should apt-get autoremove be run during reboot?

manage_delta_rpm

Data type: Boolean

Should the deltarpm package be managed by this module on RedHat family nodes? If true, use the parameter delta_rpm to determine how it should be manged

delta_rpm

Data type: Enum['installed', 'absent', 'purged', 'held', 'latest']

If managed, what should the delta_rpm package set to?

manage_yum_plugin_security

Data type: Boolean

Should the yum_plugin_security package be managed by this module on RedHat family nodes? If true, use the parameter yum_plugin_security to determine how it should be manged

yum_plugin_security

Data type: Enum['installed', 'absent', 'purged', 'held', 'latest']

If managed, what should the yum_plugin_security package set to?

reboot_override

Data type: Optional[Variant[Boolean, Enum['always', 'never', 'patched', 'smart', 'default']]]

Controls on a node level if a reboot should/should not be done after patching. This overrides the setting in the task

patch_window

Data type: Optional[String]

A freeform text entry used to allocate a node to a specific patch window (Optional)

Default value: undef

pre_patching_command

Data type: Optional[Stdlib::Absolutepath]

The full path of the command to run prior to running patching. Can be used to run customised workflows such as gracefully shutting down applications. The entry must be a single absolute filename with no arguments or parameters.

patch_cron_hour

Data type: Variant[Enum['absent'], Integer[0,23]]

The hour(s) for the cron job to run (defaults to absent, which means '*' in cron)

patch_cron_month

Data type: Variant[Enum['absent'], Integer[1,12]]

The month(s) for the cron job to run (defaults to absent, which means '*' in cron)

patch_cron_monthday

Data type: Variant[Enum['absent'], Integer[1,31]]

The monthday(s) for the cron job to run (defaults to absent, which means '*' in cron)

patch_cron_weekday

Data type: Variant[Enum['absent'], Integer[0,7]]

The weekday(s) for the cron job to run (defaults to absent, which means '*' in cron)

patch_cron_min

Data type: Integer[0,59]

The min(s) for the cron job to run (defaults to a random number between 0 and 59)

Default value: fqdn_rand(59)

windows_update_hour

Data type: Integer[0,23]

Control the hour on which windows nodes check for updates

windows_update_interval_mins

Data type: Integer

Control how often windows updates for updates

ensure

Data type: Enum['present', 'absent']

present to install scripts, cronjobs, files, etc, absent to cleanup a system that previously hosted us

fact_mode

Data type: Stdlib::Filemode

blackout_windows

Data type: Optional[Hash]

Options:

  • :title String: Name of the blackout window
  • :start String: Start of the blackout window (ISO8601 format)
  • :end String: End of the blackout window (ISO8601 format)

Default value: undef

Tasks

clean_cache

Clean patch caches (yum/dpkg) via a task

Supports noop? false

patch_server

Carry out OS patching on the server, optionally including a reboot and/or only applying security related updates

Supports noop? false

Parameters

yum_params

Data type: Optional[String]

Any additional parameters to include in the yum upgrade command (such as including/excluding repos)

dpkg_params

Data type: Optional[String]

Any additional parameters to include in the dpkg command

zypper_params

Data type: Optional[String]

Any additional parameters to include in the zypper update command

reboot

Data type: Optional[Variant[Boolean, Enum['always', 'never', 'patched', 'smart']]]

Should the server reboot after patching has been applied? (Defaults to 'never')

timeout

Data type: Optional[Integer]

How many seconds should we wait until timing out the patch run? (Defaults to 3600 seconds)

security_only

Data type: Optional[Boolean]

Limit patches to those tagged as security related? (Defaults to false)

clean_cache

Data type: Optional[Boolean]

Should the yum/dpkg caches be cleaned at the start of the task? (Defaults to false)

refresh_fact

Force a refresh of the os_patching fact cache via a task

Supports noop? false

Plans

os_patching::patch_after_healthcheck

An example plan that uses the puppet health check module to perform a pre-check on the nodes you're planning to patch. If the nodes pass the check, they get patched

Parameters

The following parameters are available in the os_patching::patch_after_healthcheck plan:

nodes

Data type: TargetSpec

noop_state

Data type: Optional[Boolean]

Default value: false

runinterval

Data type: Optional[Integer]

Default value: 1800