https://github.com/gotmax23/ansible-role-update
Ansible role that checks for and optionally installs system updates. It also has to the option to print upgradeable packages without actually upgrading them.
https://github.com/gotmax23/ansible-role-update
ansible ansible-role molecule role update upgrade
Last synced: about 1 month ago
JSON representation
Ansible role that checks for and optionally installs system updates. It also has to the option to print upgradeable packages without actually upgrading them.
- Host: GitHub
- URL: https://github.com/gotmax23/ansible-role-update
- Owner: gotmax23
- License: mit
- Created: 2021-04-02T03:04:24.000Z (about 5 years ago)
- Default Branch: main
- Last Pushed: 2023-07-12T23:50:03.000Z (almost 3 years ago)
- Last Synced: 2025-02-13T12:53:59.503Z (over 1 year ago)
- Topics: ansible, ansible-role, molecule, role, update, upgrade
- Homepage: https://galaxy.ansible.com/gotmax23/update
- Size: 137 KB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Ansible Role: update
[![Role gotmax23.update][badge-role]][link-galaxy]
[![Github Repo][badge-github-repo]][link-github-repo]
[![SourceHut Repo][badge-srht-repo]][link-srht-repo]
[![MIT Licensed][badge-license]][link-license]
[![Github Open Issues][badge-github-issues]][link-github-issues]
[![Github Open PRs][badge-github-prs]][link-github-prs]
[![Role Version][badge-version]][link-version]
[![Commits since last version][badge-commits-since]][link-version]
[![Galaxy Role Quality][badge-quality]][link-galaxy]
[![Galaxy Role Downloads][badge-downloads]][link-galaxy]
[![Github Actions Molecule workflow status][badge-molecule-workflow]][link-molecule-workflow]
[![Github Actions Galaxy workflow status][badge-galaxy-workflow]][link-galaxy-workflow]
Ansible role that checks for and optionally installs system updates. It also has to the option to print upgradeable packages without actually upgrading them.
## Beta Warning
**This role is currently in beta and is not intended for production use. Breaking changes may occur between releases, so please make sure to read the release notes.**
## Requirements
This role depends on certain collections that are not included in ansible-core.
To install this role's requirements, create a `requirements.yml` file with the following contents:
``` yaml
---
collections:
- name: community.general
```
Then, if you are using ansible-base/ansible-core 2.10 or later, run this command.
``` shell
ansible-galaxy install -r requirements.yml
```
If you are still using Ansible 2.9, run this command, instead.
``` shell
ansible-galaxy collection install -r requirements.yml
```
## Role Variables
Here are this role's variables and their default values, as set in [`defaults/main.yml`][link-defaults]. If you'd like, you may change them to customize this role's behavior.
``` yaml
---
# defaults file for update
# Options:
# - `check` to print upgradeable packages without upgrading them
# - `full` to print upgradeable packages and then upgrade them
# - `run` to update all packages without listing them first
mode: full
# This option sets the apt upgrade type. Available options are `dist`, `full`, `safe`, and `true`.
# See the [ansible.builtin.apt][1] module documentation for more information.
update_apt_upgrade_type: true
# This options sets the state key for the zypper module.
# Choose `latest` for a regular upgrade or `dist-upgrade` for the equivalent for `zypper dup`.
# See the [community.general.zypper][2] module documentation for more information.
update_zypper_state: latest
# This option dictates whether zypper should allow a vendor change
update_zypper_allow_vendor_change: false
# Whether to autoremove unneeded dependencies. This only applies to dnf, yum, and apt
update_autoremove: false
```
\[1]: https://docs.ansible.com/ansible/latest/collections/ansible/builtin/apt_module.html
\[2]: https://docs.ansible.com/ansible/latest/collections/community/general/zypper_module.html
## Example Playbook
``` yaml
---
- name: Converge
hosts: all
become: true
tasks:
- name: "Include update"
ansible.builtin.include_role:
name: gotmax23.update
```
## Compatibility
This role is tested using the latest version of ansible-core and the latest version of the collections from Ansible Galaxy. This is the only version of Ansible that this role officially supports. Best effort support is provided for other versions.
This role is compatible with the following distros:
|distro|versions|
|------|--------|
|Archlinux|any|
|Debian|buster, bullseye, bookworm|
|EL|7, 8|
|Fedora|34, 35, 36|
|opensuse|15.3, tumbleweed|
|Ubuntu|bionic, focal|
## License
[MIT][link-license]
## Author
Maxwell G (@gotmax23)
[badge-role]: https://img.shields.io/ansible/role/55837.svg?logo=ansible
[link-galaxy]: https://galaxy.ansible.com/gotmax23/update
[badge-github-repo]: https://img.shields.io/static/v1?label=GitHub&message=repo&color=blue&logo=github
[link-github-repo]: https://github.com/gotmax23/ansible-role-update
[badge-srht-repo]: https://img.shields.io/static/v1?label=SourceHut&message=repo&color=blue&logo=data:image/svg+xml;base64,PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiIHN0YW5kYWxvbmU9Im5vIj8+CjxzdmcKICAgdmlld0JveD0iMCAwIDUxMiA1MTIiCiAgIHZlcnNpb249IjEuMSIKICAgaWQ9InN2ZzUxIgogICBzb2RpcG9kaTpkb2NuYW1lPSJzb3VyY2VodXQtd2hpdGUuc3ZnIgogICBpbmtzY2FwZTp2ZXJzaW9uPSIxLjEgKGM2OGUyMmMzODcsIDIwMjEtMDUtMjMpIgogICB4bWxuczppbmtzY2FwZT0iaHR0cDovL3d3dy5pbmtzY2FwZS5vcmcvbmFtZXNwYWNlcy9pbmtzY2FwZSIKICAgeG1sbnM6c29kaXBvZGk9Imh0dHA6Ly9zb2RpcG9kaS5zb3VyY2Vmb3JnZS5uZXQvRFREL3NvZGlwb2RpLTAuZHRkIgogICB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciCiAgIHhtbG5zOnN2Zz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciPgogIDxkZWZzCiAgICAgaWQ9ImRlZnM1NSIgLz4KICA8c29kaXBvZGk6bmFtZWR2aWV3CiAgICAgaWQ9Im5hbWVkdmlldzUzIgogICAgIHBhZ2Vjb2xvcj0iIzUwNTA1MCIKICAgICBib3JkZXJjb2xvcj0iI2ZmZmZmZiIKICAgICBib3JkZXJvcGFjaXR5PSIxIgogICAgIGlua3NjYXBlOnBhZ2VzaGFkb3c9IjAiCiAgICAgaW5rc2NhcGU6cGFnZW9wYWNpdHk9IjAiCiAgICAgaW5rc2NhcGU6cGFnZWNoZWNrZXJib2FyZD0iMSIKICAgICBzaG93Z3JpZD0iZmFsc2UiCiAgICAgaW5rc2NhcGU6em9vbT0iMS42NTQyOTY5IgogICAgIGlua3NjYXBlOmN4PSIyNTYiCiAgICAgaW5rc2NhcGU6Y3k9IjI1NiIKICAgICBpbmtzY2FwZTp3aW5kb3ctd2lkdGg9IjE5MjAiCiAgICAgaW5rc2NhcGU6d2luZG93LWhlaWdodD0iMTA1OSIKICAgICBpbmtzY2FwZTp3aW5kb3cteD0iMCIKICAgICBpbmtzY2FwZTp3aW5kb3cteT0iMCIKICAgICBpbmtzY2FwZTp3aW5kb3ctbWF4aW1pemVkPSIxIgogICAgIGlua3NjYXBlOmN1cnJlbnQtbGF5ZXI9InN2ZzUxIiAvPgogIDxwYXRoCiAgICAgZD0iTTI1NiA4QzExOSA4IDggMTE5IDggMjU2czExMSAyNDggMjQ4IDI0OCAyNDgtMTExIDI0OC0yNDhTMzkzIDggMjU2IDh6bTAgNDQ4Yy0xMTAuNSAwLTIwMC04OS41LTIwMC0yMDBTMTQ1LjUgNTYgMjU2IDU2czIwMCA4OS41IDIwMCAyMDAtODkuNSAyMDAtMjAwIDIwMHoiCiAgICAgaWQ9InBhdGg0OSIKICAgICBzdHlsZT0iZmlsbDojZmZmZmZmIiAvPgo8L3N2Zz4K
[link-srht-repo]: https://git.sr.ht/~gotmax23/ansible-role-update
[badge-license]: https://img.shields.io/github/license/gotmax23/ansible-role-update.svg?logo=github
[link-license]: https://github.com/gotmax23/ansible-role-update/blob/main/LICENSE
[badge-github-issues]: https://img.shields.io/github/issues/gotmax23/ansible-role-update.svg?logo=github
[link-github-issues]: https://github.com/gotmax23/ansible-role-update/issues
[badge-github-prs]: https://img.shields.io/github/issues-pr/gotmax23/ansible-role-update.svg?logo=github
[link-github-prs]: https://github.com/gotmax23/ansible-role-update/pulls
[badge-version]: https://img.shields.io/github/release/gotmax23/ansible-role-update.svg?logo=github
[link-version]: https://github.com/gotmax23/ansible-role-update/releases/latest
[badge-commits-since]: https://img.shields.io/github/commits-since/gotmax23/ansible-role-update/latest.svg?logo=github
[badge-quality]: https://img.shields.io/ansible/quality/55837.svg?logo=ansible
[badge-downloads]: https://img.shields.io/ansible/role/d/55837.svg?logo=ansible
[badge-molecule-workflow]: https://github.com/gotmax23/ansible-role-update/actions/workflows/molecule.yml/badge.svg?branch=main
[link-molecule-workflow]: https://github.com/gotmax23/ansible-role-update/actions/workflows/molecule.yml
[badge-galaxy-workflow]: https://github.com/gotmax23/ansible-role-update/actions/workflows/galaxy.yml/badge.svg
[link-galaxy-workflow]: https://github.com/gotmax23/ansible-role-update/actions/workflows/galaxy.yml
[link-defaults]: https://github.com/gotmax23/ansible-role-update/blob/main/defaults/main.yml