Ansible update role

Ansible role to update and reboot (if necessary) Fedora, Red Hat/CentOS and Debian systems.

Requirements

This role requires Ansible 1.9.4 or higher. Supported platforms are listed in the meta/main.yml file.

Role Variables

Variables in defaults/main.yml:

Name	Type	Description	Default
update_reboot_time	String	Time at which to schedule a reboot (if necessary) of the system. It can be specified in the 24h clock format (e.g. 20:42) or with the +m syntax, where m represents the number of minutes from now (e.g. +5). It is passed directly to the system's shutdown command, see man shutdown for more details. NOTE: Due to a limitation in Ansible's SSH connection handling, specifying now or +0 for update_reboot_time is not allowed.	"+1"
update_enable_email	Boolean	Indicator whether to enable sending emails about scheduled reboots and discovered .rpmnew files (on Fedora and Red Hat/CentOS systems). If the value is set to True, then Variables for sending emails must also be defined.	False

Variables for sending emails:

Name	Type	Description	Mandatory	Default
update_email_sender	String	Email address from where the emails are sent.	Yes
update_email_recipient	String	Email address where to send the emails.	Yes
update_email_host	String	Email server to use for sending emails.	No	mail module's default value for the host parameter
update_email_host_port	Integer	Port number to use to connect to the mail server.	No	mail module's default value for the port parameter
update_email_host_user	String	User name to use to connect to the email server.	No	mail module's default value for the username parameter
update_email_host_password	String	Password to use to connect to the email server.	No	mail module's default value for the password parameter

Variables in vars/default.yml and distribution-specific files:

Name	Type	Description	Default
update_requirements	List	Packages that are required by this role.	[]
update_kernel_package_name	String	Name of the kernel package.	"kernel"

NOTE: Normally, you shouldn't change the values of these variables.

Dependencies

None.

Example Playbook

To play the update role on all systems in an invetory and set it to send emails, create a playbook similar to the one below. You can use vars_prompt to interactively prompt the user input (e.g. when to schedule the reboot, what password to use for the email server).

---
- hosts: all
  sudo: yes
  vars:
    - update_enable_email: True
    - update_email_host: "smtp.example.com"
    - update_email_host_port: 587
    - update_email_host_user: "[email protected]"
    - update_email_sender: "[email protected]"
    - update_email_recipient: "[email protected]"
  vars_prompt:
    - name: "update_reboot_time"
      default: "+1"
      prompt: |
        Schedule reboot at what time?

        You can specify time in the 24h clock format (e.g. 20:42) or with the
        '+m' syntax, where 'm' represents the number of minutes from now (e.g. +5).
        NOTE: Setting it to 'now' or '+0' is not allowed due to a limitation in
        Ansible's SSH connection handling.
      private: no
    - name: "update_email_host_password"
      prompt: "Password to use to connect to the email server:"
      private: yes
  roles:
    - update

License

GPLv3

Author Information

Tadej Janež

Acknowledgement

This Ansible role was originally developed for Genialis. With approval from Genialis, the code was generalised and published as Open Source, for which the author would like to express his gratitude.