OS Update Role
This role manages system updates on Debian-based systems using the apt package manager. It provides controlled system maintenance operations including package updates, upgrades, and cleanup.
What it does
The role performs the following operations based on configuration:
- Autoremove: Removes unused packages and dependencies
- Update: Updates the package list and upgrades all packages to their latest versions
- Upgrade: Performs a distribution upgrade (equivalent to
apt upgrade)
Each operation is controlled by boolean variables, allowing you to selectively enable or disable specific maintenance tasks.
Variables
| Variable | Type | Default | Description |
|---|---|---|---|
os_apt_autoremove |
boolean | false |
Whether to remove unused packages and dependencies |
os_apt_update |
boolean | true |
Whether to update package list and upgrade all packages |
os_apt_upgrade |
boolean | false |
Whether to perform a distribution upgrade |
Examples
Basic usage (update only)
- name: Update system packages
hosts: debian_servers
roles:
- os_update
Full system maintenance
- name: Complete system maintenance
hosts: debian_servers
vars:
os_apt_autoremove: true
os_apt_update: true
os_apt_upgrade: true
roles:
- os_update
Cleanup only
- name: Clean up unused packages
hosts: debian_servers
vars:
os_apt_autoremove: true
os_apt_update: false
os_apt_upgrade: false
roles:
- os_update
Distribution upgrade only
- name: Perform distribution upgrade
hosts: debian_servers
vars:
os_apt_autoremove: false
os_apt_update: false
os_apt_upgrade: true
roles:
- os_update
Notes
- The role uses
aptmodule which requires root privileges os_apt_updateperforms bothapt updateandapt upgradeoperationsos_apt_upgradeperforms a distribution upgrade (equivalent toapt upgrade)- Operations are executed conditionally based on the boolean variables